azure-bot-service
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseAzure AI Bot Service Skill
Azure AI Bot Service Skill
This skill provides expert guidance for Azure AI Bot Service. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.
本Skill为Azure AI Bot Service提供专业指导,涵盖故障排查、最佳实践、决策制定、架构与设计模式、限制与配额、安全、配置、集成与编码模式以及部署。它结合了本地快速参考内容和远程文档获取功能。
How to Use This Skill
如何使用本Skill
IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g.,), useL35-L120with the specified lines. For categories with file links (e.g.,read_file), use[security.md](security.md)on the linked reference fileread_file
IMPORTANT for Agent: Ifis more than 3 months old, suggest the user pull the latest version from the repository. Ifmetadata.generated_attools are not available, suggest the user install it: Installation Guidemcp_microsoftdocs
This skill requires network access to fetch documentation content:
- Preferred: Use with query string
mcp_microsoftdocs:microsoft_docs_fetch. Returns Markdown.from=learn-agent-skill - Fallback: Use with query string
fetch_webpage. Returns Markdown.from=learn-agent-skill&accept=text/markdown
对Agent的重要提示:使用下方的分类索引定位相关章节。对于带有行范围的分类(例如),使用L35-L120读取指定行。对于带有文件链接的分类(例如read_file),使用[security.md](security.md)读取链接的参考文件read_file
本Skill需要网络访问权限以获取文档内容:
- 首选方式:使用,查询字符串为
mcp_microsoftdocs:microsoft_docs_fetch,返回Markdown格式内容。from=learn-agent-skill - 备用方式:使用,查询字符串为
fetch_webpage,返回Markdown格式内容。from=learn-agent-skill&accept=text/markdown
Category Index
分类索引
| Category | Lines | Description |
|---|---|---|
| Troubleshooting | L37-L51 | Debugging and troubleshooting bots: using Emulator, transcripts, Dev Tunnels, inspection middleware, fixing HTTP 500, auth, config/channel issues, and skill/consumer problems. |
| Best Practices | L52-L66 | Guidance on designing, testing, and managing bot conversations: greetings, flow, navigation, interruptions, expirations, multimodal UX, debugging, unit testing, and Virtual Assistant best practices. |
| Decision Making | L67-L73 | 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. |
| Architecture & Design Patterns | L74-L86 | Designing bot architectures: dialog modularization, branching/looping flows, multi-LUIS/QnA routing, embedding bots in apps/web, human handoff, knowledge bots, and reusable skills. |
| Limits & Quotas | L87-L92 | Handling long-running bot operations (deferred replies, proactive messages) and checking which channels support specific features, attachments, and card types. |
| Security | L93-L112 | Securing bots: auth & SSO (OAuth, Web Chat, skills), Direct Line security, network isolation/VNET, encryption, and privacy/security best practices for Azure Bot Service. |
| Configuration | L113-L157 | Configuring Azure bots: dialogs, memory, LG/LU/QnA files, storage, telemetry/Insights, Web Chat, channels/Direct Line, skills, environments, and monitoring/debug settings. |
| Integrations & Coding Patterns | L158-L217 | Connecting bots to channels (Teams, SMS, web, social), using Direct Line/Web Chat, REST/Connector APIs, dialogs, prompts, skills, OAuth, QnA/LUIS, media, TTS, and channel-specific features |
| Deployment | L218-L224 | Deploying bots to Azure using ARM/CLI, setting up App Service resources, and configuring continuous integration/continuous deployment pipelines for Bot Framework bots. |
| 分类 | 行范围 | 描述 |
|---|---|---|
| 故障排查 | L37-L51 | 机器人调试与故障排查:使用模拟器、对话记录、Dev Tunnels、检查中间件,修复HTTP 500错误、认证问题、配置/渠道问题以及Skill/消费者问题。 |
| 最佳实践 | L52-L66 | 机器人对话设计、测试与管理指导:问候语、流程、导航、中断处理、会话过期、多模态用户体验、调试、单元测试以及虚拟助手最佳实践。 |
| 决策制定 | L67-L73 | 选择合适的微软机器人平台、Azure渠道与适配器的对比,以及根据集成、控制和托管需求选择最佳Direct Line选项的指导。 |
| 架构与设计模式 | L74-L86 | 机器人架构设计:对话模块化、分支/循环流程、多LUIS/QnA路由、在应用/网页中嵌入机器人、人工转接、知识型机器人以及可复用Skill。 |
| 限制与配额 | L87-L92 | 处理长时间运行的机器人操作(延迟回复、主动消息),以及检查哪些渠道支持特定功能、附件和卡片类型。 |
| 安全 | L93-L112 | 机器人安全防护:认证与SSO(OAuth、Web Chat、Skill)、Direct Line安全、网络隔离/VNET、加密以及Azure Bot Service的隐私与安全最佳实践。 |
| 配置 | L113-L157 | Azure机器人配置:对话、内存、LG/LU/QnA文件、存储、遥测/Insights、Web Chat、渠道/Direct Line、Skill、环境以及监控/调试设置。 |
| 集成与编码模式 | L158-L217 | 将机器人连接到渠道(Teams、SMS、网页、社交平台),使用Direct Line/Web Chat、REST/Connector API、对话、提示、Skill、OAuth、QnA/LUIS、媒体、TTS以及渠道特定功能 |
| 部署 | L218-L224 | 使用ARM/CLI将机器人部署到Azure,设置App Service资源,以及为Bot Framework机器人配置持续集成/持续部署流水线。 |
Troubleshooting
故障排查
Best Practices
最佳实践
Decision Making
决策制定
| Topic | URL |
|---|---|
| Choose the right Microsoft chatbot solution | https://learn.microsoft.com/en-us/azure/bot-service/bot-overview?view=azure-bot-service-4.0 |
| 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 |
Architecture & Design Patterns
架构与设计模式
Limits & Quotas
限制与配额
| Topic | URL |
|---|---|
| Handle long-running operations in Azure bots | https://learn.microsoft.com/en-us/azure/bot-service/bot-builder-howto-long-operations-guidance?view=azure-bot-service-4.0 |
| Channel feature and card support reference | https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channels-reference?view=azure-bot-service-4.0 |
Security
安全
Configuration
配置
Integrations & Coding Patterns
集成与编码模式
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 and deploy Bot Framework bots to Azure | https://learn.microsoft.com/en-us/azure/bot-service/provision-and-publish-a-bot?view=azure-bot-service-4.0 |
| Create App Service for bots with Azure CLI and ARM | https://learn.microsoft.com/en-us/azure/bot-service/provision-app-service?view=azure-bot-service-4.0 |
| Create or update Azure Bot with Azure CLI | https://learn.microsoft.com/en-us/azure/bot-service/provision-azure-bot?view=azure-bot-service-4.0 |