azure-bot-service — skill for Claude Code
azure-bot-service — a skill for Azure AI Bot Service development. Provides expert guidance on channel setup, Direct Line 3.0, security, deployment, and debugging issues in the Bot Framework.
CC-BY-4.0 180 installs ★ 818 updated 2026-10-25
npx skills add MicrosoftDocs/Agent-Skills --skill azure-bot-service -a claude-codeWhat azure-bot-service does
Available across Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Covers Teams and Web Chat channel configuration, App Service hosting, Direct Line 3.0 API integration, feature support matrices for each channel, data encryption, and network isolation. Helps diagnose HTTP 500 errors, authentication failures, configuration problems, and choose between Azure channels and adapters.
Requires network access — fetches documentation from Microsoft Learn via mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage. Suggests pulling the latest version from the repository if the skill data is older than three months.
What it helps with
- configure Direct Line 3.0 for a web client
- debug and resolve HTTP 500 errors in a bot
- connect a bot to Teams or Web Chat via Azure
- choose between Azure channels and adapters
- set up network isolation and encryption for a bot
Example prompts for the agent
- Help me configure Direct Line for my web application
- Why is my bot returning HTTP 500 when sending messages to Teams?
- How do I deploy a Bot Framework bot to App Service with CI/CD?
How to install azure-bot-service
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-bot-service -a claude-code2Manually: put the files in place
~/.claude/skills/azure-bot-service/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/azure-bot-service/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-bot-service -a codex2Manually: put the files in place
.agents/skills/azure-bot-service/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-bot-service -a cursor2Manually: put the files in place
.cursor/skills/azure-bot-service/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install MicrosoftDocs/Agent-Skills skills/azure-bot-service2Manually: put the files in place
.github/skills/azure-bot-service/SKILL.md1Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-bot-service -a gemini-cli2Platform CLI
gemini skills install https://github.com/MicrosoftDocs/Agent-Skills --path skills/azure-bot-serviceManually: put the files in place
.devin/skills/azure-bot-service/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add MicrosoftDocs/Agent-Skills --skill azure-bot-service -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about azure-bot-service
How do I install azure-bot-service in Claude Code?
Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-bot-service -a claude-code, then open ~/.claude/skills/azure-bot-service/SKILL.md.
What does the azure-bot-service skill do?
Expert reference for Azure bot development: channel configuration, Direct Line setup, security best practices, CI/CD, and troubleshooting. Integrates with Microsoft Learn documentation via API.
Which platforms support this skill?
Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. Not available on Claude.ai.
Source text
SKILL.md · CC-BY-4.0
--- name: azure-bot-service description: Expert knowledge for Azure AI Bot Service development including troubleshooting, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Direct Line 3.0, configuring Teams/Web Chat channels, setting App Service bots, CI/CD, or App Insights, and other Azure AI Bot Service related development tasks. Not for Azure Health Bot (use azure-health-bot), Azure Functions (use azure-functions), Azure App Service (use azure-app-service). compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation. metadata: generated_at: "2026-09-13" generator: "docs2skills/1.0.0" --- # Azure AI Bot Service Skill This skill provides expert guidance for Azure AI Bot Service. Covers troubleshooting, decision making, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities. ## How to Use This Skill > **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file > **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md) This skill requires **network access** to fetch documentation content: - **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown. - **Fallback**: Use `fetch_webpage` with query string `from=learn-agent-skill&accept=text/markdown`. Returns Markdown. ## Category Index | Category | Lines | Description | |----------|-------|-------------| | Troubleshooting | L35-L43 | Debugging and troubleshooting bots: using Emulator, transcripts, Dev Tunnels, inspection middleware, fixing HTTP 500, auth, config/channel issues, and skill/consumer problems. | | Decision Making | L44-L49 | Guidance on selecting the right Microsoft bot platform, choosing Azure channels vs adapters, and picking the best Direct Line option based on integration, control, and hosting needs. | | Limits & Quotas | L50-L54 | Matrix of which bot features are supported on each Azure channel (Teams, Web Chat, Direct Line, etc.), including capabilities, limitations, and compatibility details. | | Security | L55-L66 | Securing bots: encryption, privacy, regional data residency, Direct Line auth, VNET/network isolation, and configuring secure access for Azure AI Bot Service. | | Configuration | L67-L83 | Configuring bot channels, endpoints, hosting/registration, auth URLs, telemetry (App Insights), monitoring, and region-specific settings (China, Gov) for Azure AI Bot Service. | | Integrations & Coding Patterns | L84-L105 | Integrating bots with channels (Teams, email, SMS, web, social apps) and using Direct Line 3.0 APIs for messaging, tokens, reconnection, and conversation control. | | Deployment | L106-L110 | Guides for provisioning App Service, deploying Bot Framework bots to Azure, and setting up CI/CD pipelines for automated bot deployment. | ### Troubleshooting | Topic | URL | |-------|-----| | Interpret and handle Bot Framework User-Agent requests | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-resources-user-agent?view=azure-bot-service-4.0 | | Diagnose and fix HTTP 500 errors in bots | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-troubleshoot-500-errors?view=azure-bot-service-4.0 | | Troubleshoot Bot Framework authentication failures | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-troubleshoot-authentication-problems?view=azure-bot-service-4.0 | | Fix configuration and channel issues in bots | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-troubleshoot-bot-configuration?view=azure-bot-service-4.0 | | Resolve common Azure AI Bot Service issues | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-troubleshoot-general-problems?view=azure-bot-service-4.0 | ### Decision Making | Topic | URL | |-------|-----| | Choose between Azure channels and adapters for bots | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-additional-channels?view=azure-bot-service-4.0 | | Choose the right Direct Line option for bots | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-directline?view=azure-bot-service-4.0 | ### Limits & Quotas | Topic | URL | |-------|-----| | Channel feature support matrix for Azure bots | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channels-reference?view=azure-bot-service-4.0 | ### Security | Topic | URL | |-------|-----| | Configure regionalization for Azure AI Bot Service | https://learn.microsoft.com/en-us/azure/bot-service/bot-builder-concept-regionalization?view=azure-bot-service-4.0 | | Use Direct Line App Service extension in a VNET | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-directline-extension-vnet?view=azure-bot-service-4.0 | | Understand Azure AI Bot Service data encryption | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-encryption?view=azure-bot-service-4.0 | | Configure security and privacy for Azure Bot Framework | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-resources-faq-security?view=azure-bot-service-4.0 | | Network isolation concepts for Azure bots | https://learn.microsoft.com/en-us/azure/bot-service/dl-network-isolation-concept?view=azure-bot-service-4.0 | | Configure network isolation for Direct Line bots | https://learn.microsoft.com/en-us/azure/bot-service/dl-network-isolation-how-to?view=azure-bot-service-4.0 | | Authenticate clients to Direct Line API 3.0 with secrets and tokens | https://learn.microsoft.com/en-us/azure/bot-service/rest-api/bot-framework-rest-direct-line-3-0-authentication?view=azure-bot-service-4.0 | | Understand Azure Bot Service security and privacy | https://learn.microsoft.com/en-us/azure/bot-service/security-faq?view=azure-bot-service-4.0 | ### Configuration | Topic | URL | |-------|-----| | Configure Direct Line channel for bot clients | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-directline?view=azure-bot-service-4.0 | | Configure Direct Line App Service extension | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-directline-extension?view=azure-bot-service-4.0 | | Configure Azure bot channels and adapters | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-manage-channels?view=azure-bot-service-4.0 | | Configure Azure Bot resource settings in portal | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-manage-settings?view=azure-bot-service-4.0 | | Register externally hosted bots with Azure | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-quickstart-registration?view=azure-bot-service-4.0 | | Configure Application Insights keys for bots | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-resources-app-insights-keys?view=azure-bot-service-4.0 | | Understand ID field semantics in Bot Framework | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-resources-identifiers-guide?view=azure-bot-service-4.0 | | Configure bots for Azure China (21Vianet) | https://learn.microsoft.com/en-us/azure/bot-service/how-to-deploy-china-cloud?view=azure-bot-service-4.0 | | Configure bots for Azure Government and GCC High | https://learn.microsoft.com/en-us/azure/bot-service/how-to-deploy-gov-cloud-high?view=azure-bot-service-4.0 | | Reference monitoring metrics and logs for Azure AI Bot Service | https://learn.microsoft.com/en-us/azure/bot-service/monitor-bot-service-reference?view=azure-bot-service-4.0 | | Configure and analyze monitoring for Azure bots | https://learn.microsoft.com/en-us/azure/bot-service/monitor-bot-service?view=azure-bot-service-4.0 | | Provision Azure Bot resources using Azure CLI and ARM | https://learn.microsoft.com/en-us/azure/bot-service/provision-azure-bot?view=azure-bot-service-4.0 | | Select correct OAuth and redirect URLs for bots | https://learn.microsoft.com/en-us/azure/bot-service/ref-oauth-redirect-urls?view=azure-bot-service-4.0 | ### Integrations & Coding Patterns | Topic | URL | |-------|-----| | Connect bots to Outlook Actionable Messages | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-actionable-email?view=azure-bot-service-4.0 | | Connect Azure bots to Alexa custom skills | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-alexa?view=azure-bot-service-4.0 | | Connect bots to Microsoft 365 email channel | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-email?view=azure-bot-service-4.0 | | Connect bots to Facebook Messenger and Workplace | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-facebook?view=azure-bot-service-4.0 | | Connect bots to GroupMe messaging channel | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-groupme?view=azure-bot-service-4.0 | | Connect bots to LINE messaging app | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-line?view=azure-bot-service-4.0 | | Connect bots as custom providers for Microsoft Search | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-search?view=azure-bot-service-4.0 | | Connect bots to Slack via Azure channel | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-slack?view=azure-bot-service-4.0 | | Connect bots to Telegram messaging app | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-telegram?view=azure-bot-service-4.0 | | Connect bots to Twilio SMS channel | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-twilio?view=azure-bot-service-4.0 | | Connect bots to Web Chat channel and embed UI | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-webchat?view=azure-bot-service-4.0 | | Connect bots to Microsoft Teams channel | https://learn.microsoft.com/en-us/azure/bot-service/channel-connect-teams?view=azure-bot-service-4.0 | | Direct Line API 3.0 operations, schemas, and status codes | https://learn.microsoft.com/en-us/azure/bot-service/rest-api/bot-framework-rest-direct-line-3-0-api-reference?view=azure-bot-service-4.0 | | End conversations with endOfConversation activities in Direct Line | https://learn.microsoft.com/en-us/azure/bot-service/rest-api/bot-framework-rest-direct-line-3-0-end-conversation?view=azure-bot-service-4.0 | | Receive bot activities using Direct Line 3.0 | https://learn.microsoft.com/en-us/azure/bot-service/rest-api/bot-framework-rest-direct-line-3-0-receive-activities?view=azure-bot-service-4.0 | | Reconnect WebSocket clients to Direct Line conversations | https://learn.microsoft.com/en-us/azure/bot-service/rest-api/bot-framework-rest-direct-line-3-0-reconnect-to-conversation?view=azure-bot-service-4.0 | | Send activities to bots via Direct Line 3.0 | https://learn.microsoft.com/en-us/azure/bot-service/rest-api/bot-framework-rest-direct-line-3-0-send-activity?view=azure-bot-service-4.0 | | Start Direct Line 3.0 conversations and generate tokens | https://learn.microsoft.com/en-us/azure/bot-service/rest-api/bot-framework-rest-direct-line-3-0-start-conversation?view=azure-bot-service-4.0 | ### Deployment | Topic | URL | |-------|-----| | Set up continuous deployment for Azure bots | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-build-continuous-deployment?view=azure-bot-service-4.0 | | Provision Azure App Service for bot deployment via CLI | https://learn.microsoft.com/en-us/azure/bot-service/provision-app-service?view=azure-bot-service-4.0 |
© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills