mcpField
A
azure-bot-service

azure-bot-service

github.com/microsoftdocs開発796176 回インストール3 日前に更新
リポジトリ

azure-bot-service について

azure-bot-service は、Azure AI Bot Service を扱う開発者やエージェント向けのガイダンススキルです。ローカルの参照資料とネットワーク経由のドキュメントを組み合わせ、トラブルシューティングからデプロイまでを扱います。

主な機能

  1. 01ボットのトラブルシューティング
  2. 02プラットフォームとチャネルの選択
  3. 03制限とクォータの参照
  4. 04セキュリティと構成のガイダンス
  5. 05統合とデプロイのパターン

活用シーン

  1. 01認証や HTTP 500 エラーの診断
  2. 02チャネルや Direct Line の選択
  3. 03安全なアクセスと監視の構成
  4. 04統合とボットのデプロイ計画

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 に関する専門的なガイダンスを提供します。トラブルシューティング、意思決定、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイについて解説します。ローカルのクイックリファレンスコンテンツと、リモートのドキュメント取得機能を組み合わせています。

このスキルの使い方

IMPORTANT for Agent: 関連するセクションを探すには、以下の カテゴリ索引 を使用してください。行範囲が指定されているカテゴリ（例：L35-L120）では、指定された行を read_file で読み取ります。ファイルへのリンクがあるカテゴリ（例：[security.md](security.md)）では、リンク先のリファレンスファイルを read_file で読み取ります。

IMPORTANT for Agent: metadata.generated_at が3か月以上前の場合は、リポジトリから最新バージョンを取得するようユーザーに提案してください。mcp_microsoftdocs ツールを利用できない場合は、インストールするようユーザーに提案してください：インストールガイド

このスキルでドキュメントの内容を取得するには、ネットワークアクセスが必要です。

  • 推奨：クエリ文字列 from=learn-agent-skill を指定して mcp_microsoftdocs:microsoft_docs_fetch を使用します。Markdown が返されます。
  • 代替手段：クエリ文字列 from=learn-agent-skill&accept=text/markdown を指定して fetch_webpage を使用します。Markdown が返されます。

カテゴリ索引

カテゴリ行説明
トラブルシューティングL35-L43Emulator、トランスクリプト、Dev Tunnels、検査ミドルウェアを使ったボットのデバッグとトラブルシューティング、HTTP 500、認証、構成やチャネルの問題、スキルやコンシューマーに関する問題の解決。
意思決定L44-L49適切な Microsoft ボットプラットフォームの選択、Azure チャネルとアダプターの選択、統合、制御、ホスティングのニーズに応じた最適な Direct Line オプションの選択に関するガイダンス。
制限とクォータL50-L54Teams、Web Chat、Direct Line など、各 Azure チャネルでサポートされるボット機能の一覧。機能、制限、互換性の詳細を含みます。
セキュリティL55-L66暗号化、プライバシー、地域別データレジデンシー、Direct Line 認証、VNET／ネットワーク分離、Azure AI Bot Service へのセキュアなアクセスの構成など、ボットのセキュリティ確保。
構成L67-L83Azure AI Bot Service のボットチャネル、エンドポイント、ホスティング／登録、認証 URL、テレメトリ（App Insights）、監視、地域固有の設定（中国、Gov）の構成。
統合とコーディングパターンL84-L105ボットとチャネル（Teams、メール、SMS、Web、ソーシャルアプリ）との統合、およびメッセージング、トークン、再接続、会話制御のための Direct Line 3.0 API の使用。
デプロイL106-L110App 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 China（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 URL とリダイレクト URL を選択するhttps://learn.microsoft.com/en-us/azure/bot-service/ref-oauth-redirect-urls?view=azure-bot-service-4.0
統合とコーディングパターン
トピックURL
ボットを Outlook Actionable Messages に接続する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 と Workplace に接続するhttps://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 チャネル経由でボットを Slack に接続するhttps://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 チャネルに接続し、UI を埋め込むhttps://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 Service をプロビジョニングするhttps://learn.microsoft.com/en-us/azure/bot-service/provision-app-service?view=azure-bot-service-4.0

コメント

Markdown 対応