К основному содержанию
скилл CX Codex

azure-bot-service — скилл для Claude Code

Скилл azure-bot-service для Claude Code и Codex по разработке ботов на Azure AI Bot Service. Даёт экспертные знания по настройке каналов, Direct Line 3.0, безопасности, развёртыванию и отладке проблем в бот-фреймворке.

CC-BY-4.0 180 установок ★ 818 обновлён 2026-10-25

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add MicrosoftDocs/Agent-Skills --skill azure-bot-service -a claude-code
Открыть на GitHub

Что делает azure-bot-service

Включает справочник по настройке каналов Teams и Web Chat, конфигурации App Service, интеграции Direct Line 3.0, матрицу поддержки функций на каждом канале, шифрованию данных и изоляции сети. Помогает разобраться с HTTP 500, ошибками аутентификации, проблемами конфигурации и выбором между Azure-каналами и адаптерами.

Скилл требует доступа в интернет — использует mcp_microsoftdocs:microsoft_docs_fetch или fetch_webpage для получения документации из Microsoft Learn. Если источник данных устарел больше чем на три месяца, рекомендует обновить версию из репозитория.

Какие задачи решает

  • настроить Direct Line 3.0 для веб-клиента
  • диагностировать и исправить HTTP 500 в боте
  • подключить бота к Teams или Web Chat через Azure
  • выбрать между каналами Azure и адаптерами
  • настроить сетевую изоляцию и шифрование для бота

Примеры запросов агенту

  • Помоги настроить Direct Line для веб-приложения
  • Почему бот возвращает HTTP 500 при отправке сообщения в Teams?
  • Как развернуть бот-фреймворк на App Service с CI/CD?

Как установить azure-bot-service

1Через Skills CLI (Vercel)

npx skills add MicrosoftDocs/Agent-Skills --skill azure-bot-service -a claude-code

2Вручную: положить файлы

~/.claude/skills/azure-bot-service/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/azure-bot-service/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об azure-bot-service

Как установить azure-bot-service в Claude Code?

Выполни npx skills add MicrosoftDocs/Agent-Skills --skill azure-bot-service -a claude-code, затем открой ~/.claude/skills/azure-bot-service/SKILL.md.

Что такое azure-bot-service скилл?

Справочник экспертных знаний для разработки ботов на Azure: настройка каналов, Direct Line, безопасность, CI/CD, отладка. Интегрируется с документацией Microsoft Learn через API.

Какие платформы поддерживает скилл?

Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode. Для Claude.ai скилл не доступен.

Исходный текст

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

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
azure-mgmt-botservice-dotnet Microsoft Скилл azure-mgmt-botservice-dotnet для создания и настройки Azure Bot Service через Resource Manager API: боты, каналы Teams и DirectLine, OAuth-подключения. CX Codex +1 ★ 3 232звёзд репо azure-mgmt-botservice-py Microsoft Скилл azure-mgmt-botservice-py для создания, настройки и управления ботами в Azure Bot Service через Python SDK. Подключает каналы Teams, Direct Line, Web Chat и работает с ресурсами подписки. CX Codex +1 ★ 3 232звёзд репо Azure Kubernetes Service (AKS) azure Azure Kubernetes Service (AKS) — MCP-сервер для Claude Code, который управляет кластерами AKS и ресурсами Azure через диалог с моделью. Используется при настройке инфраструктуры и отладке подов. CX Codex +1 azure-ml-foundry-workspace JosiahSiegel Скилл azure-ml-foundry-workspace для Claude Code настраивает Azure Machine Learning и Azure AI Foundry: рабочие пространства, сети, вычисления и развёртывание моделей. Разбирает конфигурацию и журналы. CX Codex +1 105установок service-itsm-channels-coordinate forcedotcom Скилл service-itsm-channels-coordinate в Salesforce выводит меню выбора канала Employee Service: портала, Teams или Slack, затем передаёт настройку дочернему скиллу. CX Codex +1 1 200установок ml-ai grafana Скилл ml-ai для Claude Code подключает к Grafana Cloud ИИ-ассистента, прогнозирование аномалий и автоматическую диагностику инцидентов. CX Codex +1 4 500установок

Из того же набора144

Весь набор →
azure-api-center Скилл с документацией по Azure API Center для разработки, настройки безопасности и автоматизации регистрации API. Подключается к локальной справке и документации Microsoft Learn. CX Codex +1 181установок azure-queue-storage Направляет агента при разработке под Azure Queue Storage: настройка очередей, безопасность через Entra ID, лимиты и работа с SDK для Python, .NET, JS или Java. CX Codex +1 181установок azure-portal Скилл даёт агенту знания про Azure Portal: управление доступом, политики безопасности, конфигурацию дашбордов и диагностику проблем. CX Codex +1 181установок azure-copilot Скилл для работы с Azure Copilot: подбор размера VM, генерация Bicep и Terraform, настройка Cosmos DB для хранения чатов, проектирование сетей Azure. CX Codex +1 180установок azure-content-safety Скилл azure-content-safety для работы с Azure AI Content Safety: модерация текста и изображений, настройка блоклистов, проверка обоснованности ответов и защита от prompt-инъекций. CX Codex +1 180установок azure-firewall-manager Помогает проектировать и настраивать политики безопасности в Azure Firewall Manager. Пригодится при настройке защищённых виртуальных хабов, WAF и планов DDoS. CX Codex +1 180установок azure-traffic-manager Скилл с экспертными знаниями об Azure Traffic Manager: маршрутизация трафика, архитектура профилей, IaC через ARM/Bicep/Terraform. Помогает при настройке endpoints, выборе методов маршрутизации и диагностике проблем. CX Codex +1 178установок azure-maps С экспертными знаниями по Azure Maps. Покрывает геокодинг, маршрутизацию, погодные тайлы, безопасность и паттерны интеграции через Web/REST SDK. CX Codex +1 178установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой