mcpField
A
azure-bot-service

azure-bot-service

github.com/microsoftdocs开发796176 次安装3 天前更新
代码仓库

关于 azure-bot-service

azure-bot-service 为 Azure AI Bot Service 的开发者和 Agent 提供指导，结合本地速查资料与联网文档，涵盖故障排查、安全、配置、集成和部署。

主要功能

  1. 01Bot 故障排查指导
  2. 02平台与渠道选择
  3. 03限制和配额参考
  4. 04安全与配置指导
  5. 05集成和部署模式

适用场景

  1. 01诊断 Bot 身份验证或 HTTP 500 错误
  2. 02选择渠道或 Direct Line 方案
  3. 03配置安全访问与监控
  4. 04规划集成和 Bot 部署

MCP 相关

该技能可通过 `mcp_microsoftdocs:microsoft_docs_fetch` 工具获取 Microsoft 文档；也说明可用 `fetch_webpage` 作为备用方式。

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-bot-service

安装后在 Claude Code 中输入/azure-bot-service确认已加载。

详细介绍

Azure AI Bot Service 技能

此技能为 Azure AI Bot Service 提供专业指导，涵盖故障排除、决策、限制和配额、安全、配置、集成和编码模式，以及部署。它结合了本地快速参考内容与远程文档获取功能。

如何使用此技能

重要提示（面向 Agent）：使用下方的类别索引查找相关部分。对于带行范围的类别（例如，L35-L120），请使用 read_file 读取指定行。对于带文件链接的类别（例如，security.md），请使用 read_file 读取链接的参考文件

重要提示（面向 Agent）：如果 metadata.generated_at 的时间距今超过 3 个月，请建议用户从仓库拉取最新版本。如果无法使用 mcp_microsoftdocs 工具，请建议用户安装该工具：安装指南

此技能需要网络访问才能获取文档内容：

  • 首选：使用 mcp_microsoftdocs:microsoft_docs_fetch，并将查询字符串设为 from=learn-agent-skill。返回 Markdown。
  • 备用：使用 fetch_webpage，并将查询字符串设为 from=learn-agent-skill&accept=text/markdown。返回 Markdown。

类别索引

类别行说明
故障排除L35-L43调试和排查机器人问题：使用 Emulator、对话记录、Dev Tunnels、检查中间件，修复 HTTP 500、身份验证、配置/渠道问题，以及技能/使用方问题。
决策L44-L49关于如何选择合适的 Microsoft 机器人平台、选择 Azure 渠道还是适配器，以及根据集成、控制和托管需求选择最佳 Direct Line 选项的指导。
限制和配额L50-L54矩阵列出各项机器人功能在每个 Azure 渠道（Teams、Web Chat、Direct Line 等）上的支持情况，包括功能、限制和兼容性详情。
安全L55-L66保护机器人安全：加密、隐私、区域数据驻留、Direct Line 身份验证、VNET/网络隔离，以及为 Azure AI Bot Service 配置安全访问。
配置L67-L83配置 Azure AI Bot Service 的机器人渠道、终结点、托管/注册、身份验证 URL、遥测（App Insights）、监视和特定区域设置（中国、Gov）。
集成和编码模式L84-L105将机器人与渠道（Teams、电子邮件、SMS、Web、社交应用）集成，并使用 Direct Line 3.0 API 进行消息传递、令牌管理、重新连接和对话控制。
部署L106-L110预配 App Service、将 Bot Framework 机器人部署到 Azure，以及设置 CI/CD 管道以自动部署机器人的指南。
故障排除
主题URL
解读和处理 Bot Framework User-Agent 请求https://learn.microsoft.com/en-us/azure/bot-service/bot-service-resources-user-agent?view=azure-bot-service-4.0
诊断和修复机器人中的 HTTP 500 错误https://learn.microsoft.com/en-us/azure/bot-service/bot-service-troubleshoot-500-errors?view=azure-bot-service-4.0
排查 Bot Framework 身份验证失败问题https://learn.microsoft.com/en-us/azure/bot-service/bot-service-troubleshoot-authentication-problems?view=azure-bot-service-4.0
修复机器人的配置和渠道问题https://learn.microsoft.com/en-us/azure/bot-service/bot-service-troubleshoot-bot-configuration?view=azure-bot-service-4.0
解决 Azure AI Bot Service 常见问题https://learn.microsoft.com/en-us/azure/bot-service/bot-service-troubleshoot-general-problems?view=azure-bot-service-4.0
决策
主题URL
为机器人选择 Azure 渠道或适配器https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-additional-channels?view=azure-bot-service-4.0
为机器人选择合适的 Direct Line 选项https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-directline?view=azure-bot-service-4.0
限制与配额
主题URL
Azure 机器人渠道功能支持矩阵https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channels-reference?view=azure-bot-service-4.0
安全性
主题URL
为 Azure AI Bot Service 配置区域化https://learn.microsoft.com/en-us/azure/bot-service/bot-builder-concept-regionalization?view=azure-bot-service-4.0
在 VNET 中使用 Direct Line App Service 扩展https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-directline-extension-vnet?view=azure-bot-service-4.0
了解 Azure AI Bot Service 数据加密https://learn.microsoft.com/en-us/azure/bot-service/bot-service-encryption?view=azure-bot-service-4.0
为 Azure Bot Framework 配置安全与隐私https://learn.microsoft.com/en-us/azure/bot-service/bot-service-resources-faq-security?view=azure-bot-service-4.0
Azure 机器人的网络隔离概念https://learn.microsoft.com/en-us/azure/bot-service/dl-network-isolation-concept?view=azure-bot-service-4.0
为 Direct Line 机器人配置网络隔离https://learn.microsoft.com/en-us/azure/bot-service/dl-network-isolation-how-to?view=azure-bot-service-4.0
使用机密和令牌向 Direct Line API 3.0 验证客户端身份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
了解 Azure Bot Service 的安全与隐私https://learn.microsoft.com/en-us/azure/bot-service/security-faq?view=azure-bot-service-4.0
配置
主题URL
为机器人客户端配置 Direct Line 通道https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-directline?view=azure-bot-service-4.0
配置 Direct Line App Service 扩展https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-directline-extension?view=azure-bot-service-4.0
配置 Azure 机器人通道和适配器https://learn.microsoft.com/en-us/azure/bot-service/bot-service-manage-channels?view=azure-bot-service-4.0
在门户中配置 Azure Bot 资源设置https://learn.microsoft.com/en-us/azure/bot-service/bot-service-manage-settings?view=azure-bot-service-4.0
在 Azure 中注册外部托管的机器人https://learn.microsoft.com/en-us/azure/bot-service/bot-service-quickstart-registration?view=azure-bot-service-4.0
为机器人配置 Application Insights 密钥https://learn.microsoft.com/en-us/azure/bot-service/bot-service-resources-app-insights-keys?view=azure-bot-service-4.0
了解 Bot Framework 中 ID 字段的含义https://learn.microsoft.com/en-us/azure/bot-service/bot-service-resources-identifiers-guide?view=azure-bot-service-4.0
为 Azure 中国（21Vianet）配置机器人https://learn.microsoft.com/en-us/azure/bot-service/how-to-deploy-china-cloud?view=azure-bot-service-4.0
为 Azure Government 和 GCC High 配置机器人https://learn.microsoft.com/en-us/azure/bot-service/how-to-deploy-gov-cloud-high?view=azure-bot-service-4.0
Azure AI Bot Service 监视指标和日志参考https://learn.microsoft.com/en-us/azure/bot-service/monitor-bot-service-reference?view=azure-bot-service-4.0
配置和分析 Azure 机器人的监视https://learn.microsoft.com/en-us/azure/bot-service/monitor-bot-service?view=azure-bot-service-4.0
使用 Azure CLI 和 ARM 预配 Azure Bot 资源https://learn.microsoft.com/en-us/azure/bot-service/provision-azure-bot?view=azure-bot-service-4.0
为机器人选择正确的 OAuth 和重定向 URLhttps://learn.microsoft.com/en-us/azure/bot-service/ref-oauth-redirect-urls?view=azure-bot-service-4.0
集成与编码模式
主题URL
将机器人连接到 Outlook 可操作邮件https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-actionable-email?view=azure-bot-service-4.0
将 Azure 机器人连接到 Alexa 自定义技能https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-alexa?view=azure-bot-service-4.0
将机器人连接到 Microsoft 365 电子邮件频道https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-email?view=azure-bot-service-4.0
将机器人连接到 Facebook Messenger 和 Workplacehttps://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-facebook?view=azure-bot-service-4.0
将机器人连接到 GroupMe 消息频道https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-groupme?view=azure-bot-service-4.0
将机器人连接到 LINE 消息应用https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-line?view=azure-bot-service-4.0
将机器人作为 Microsoft Search 的自定义提供程序接入https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-search?view=azure-bot-service-4.0
通过 Azure 频道将机器人连接到 Slackhttps://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-slack?view=azure-bot-service-4.0
将机器人连接到 Telegram 消息应用https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-telegram?view=azure-bot-service-4.0
将机器人连接到 Twilio SMS 频道https://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-twilio?view=azure-bot-service-4.0
将机器人连接到 Web Chat 频道并嵌入 UIhttps://learn.microsoft.com/en-us/azure/bot-service/bot-service-channel-connect-webchat?view=azure-bot-service-4.0
将机器人连接到 Microsoft Teams 频道https://learn.microsoft.com/en-us/azure/bot-service/channel-connect-teams?view=azure-bot-service-4.0
Direct Line API 3.0 操作、架构和状态代码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
在 Direct Line 中使用 endOfConversation 活动结束对话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
使用 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
将 WebSocket 客户端重新连接到 Direct Line 对话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
通过 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
启动 Direct Line 3.0 对话并生成令牌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
部署
主题URL
为 Azure 机器人设置持续部署https://learn.microsoft.com/en-us/azure/bot-service/bot-service-build-continuous-deployment?view=azure-bot-service-4.0
通过 CLI 为机器人部署预配 Azure App Servicehttps://learn.microsoft.com/en-us/azure/bot-service/provision-app-service?view=azure-bot-service-4.0

评论

支持 Markdown