Azure AI Bot Serviceを使ったチャットボット開発全般を支援し、トラブルシューティングや設計、セキュリティ、連携、デプロイなど、幅広い知識で開発を成功に導くSkill。
Azure AI Bot Service を利用したボット開発において、トラブルシューティング、設計、セキュリティ、デプロイなど、幅広い専門知識を提供するSkill。
📜 元の英語説明(参考)
Expert knowledge for Azure AI Bot Service development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building Azure AI bots with Direct Line/Web Chat, Teams/SMS channels, OAuth/SSO, skills, or proactive messages, 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), Azure Logic Apps (use azure-logic-apps).
🇯🇵 日本人クリエイター向け解説
Azure AI Bot Service を利用したボット開発において、トラブルシューティング、設計、セキュリティ、デプロイなど、幅広い専門知識を提供するSkill。
※ jpskill.com 編集部が日本のビジネス現場向けに補足した解説です。Skill本体の挙動とは独立した参考情報です。
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o azure-bot-service.zip https://jpskill.com/download/5644.zip && unzip -o azure-bot-service.zip && rm azure-bot-service.zip$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/5644.zip -OutFile "$d\azure-bot-service.zip"; Expand-Archive "$d\azure-bot-service.zip" -DestinationPath $d -Force; ri "$d\azure-bot-service.zip"完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
azure-bot-service.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
azure-bot-serviceフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-17
- 取得日時
- 2026-05-18
- 同梱ファイル
- 1
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
Azure AI Bot Service スキル
このスキルは、Azure AI Bot Service に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイについて網羅しています。ローカルのクイックリファレンスコンテンツとリモートのドキュメント取得機能を組み合わせています。
このスキルの使い方
エージェントへの重要事項: 関連するセクションを見つけるには、以下のカテゴリインデックスを使用してください。行範囲が指定されているカテゴリ（例:
L35-L120）の場合は、指定された行でread_fileを使用してください。ファイルリンクが指定されているカテゴリ（例:[security.md](security.md)）の場合は、リンクされた参照ファイルでread_fileを使用してください。
エージェントへの重要事項:
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 を返します。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L37-L51 | ボットのデバッグとトラブルシューティング: Emulator、トランスクリプト、Dev Tunnels、インスペクションミドルウェアの使用、HTTP 500、認証、構成/チャネルの問題、スキル/コンシューマーの問題の修正。 |
| ベストプラクティス | L52-L66 | ボットの会話の設計、テスト、管理に関するガイダンス: 挨拶、フロー、ナビゲーション、中断、有効期限、マルチモーダルUX、デバッグ、単体テスト、Virtual Assistant のベストプラクティス。 |
| 意思決定 | L67-L73 | 適切な Microsoft ボットプラットフォームの選択、Azure チャネルとアダプターの選択、統合、制御、ホスティングのニーズに基づいた最適な Direct Line オプションの選択に関するガイダンス。 |
| アーキテクチャと設計パターン | L74-L86 | ボットアーキテクチャの設計: ダイアログのモジュール化、分岐/ループフロー、マルチ LUIS/QnA ルーティング、アプリ/Web へのボットの埋め込み、人間への引き継ぎ、ナレッジボット、再利用可能なスキル。 |
| 制限とクォータ | L87-L92 | 長時間実行されるボット操作（遅延応答、プロアクティブメッセージ）の処理と、特定の機能、添付ファイル、カードタイプをサポートするチャネルの確認。 |
| セキュリティ | L93-L112 | ボットのセキュリティ保護: 認証と SSO（OAuth、Web Chat、スキル）、Direct Line セキュリティ、ネットワーク分離/VNET、暗号化、Azure Bot Service のプライバシー/セキュリティのベストプラクティス。 |
| 構成 | L113-L157 | Azure AI ボットの構成: ダイアログ、言語生成/理解、メモリ/状態、チャネル（Web Chat、Direct Line）、テレメトリ/監視、スキル、環境固有の設定。 |
| 統合とコーディングパターン | L158-L217 | ボットとチャネル（Teams、SMS、Web、ソーシャル）の接続、Direct Line/Web Chat の使用、アクティビティ/メッセージ、メディア、カード、プロンプト、OAuth、状態、スキル、チャネル固有機能の処理。 |
| デプロイ | L218-L223 | App Service のプロビジョニング、Bot Framework ボットの Azure へのデプロイ、自動ボットデプロイのための CI/CD パイプラインのセットアップに関するガイド。 |
トラブルシューティング
ベストプラクティス
| トピック | URL |
|---|---|
| ボットの会話を安全に終了および再開する | https://learn.microsoft.com/en-us/azure/bot-service/bot-builder-howto-expire-conversation?view=azure-bot-service-4.0 |
| Azure ボットでユーザーの中断を処理する | https://learn.microsoft.com/en-us/azure/bot-service/bot-builder-howto-handle-user-interrupt?view=azure-bot-service-4.0 |
| Azure Bot Service でウェルカムメッセージを実装する | https://learn.microsoft.com/en-us/azure/bot-service/bot-builder-send-welcome-message?view=azure-bot-service-4.0 |
| Azure ボットのデバッグガイドラインを適用する | https://learn.microsoft.com/en-us/azure/bot-service/bot-builder-testing-debugging?view=azure-bot-service-4.0 |
| Virtual Assistant テンプレートのベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/bot-service/bot-builder-v |
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
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.
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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
- Preferred: Use
mcp_microsoftdocs:microsoft_docs_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns 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 AI bots: dialogs, language generation/understanding, memory/state, channels (Web Chat, Direct Line), telemetry/monitoring, skills, and environment-specific settings. |
| Integrations & Coding Patterns | L158-L217 | Connecting bots to channels (Teams, SMS, web, social), using Direct Line/Web Chat, handling activities/messages, media, cards, prompts, OAuth, state, skills, and channel-specific features. |
| Deployment | L218-L223 | Guides for provisioning App Service, deploying Bot Framework bots to Azure, and setting up CI/CD pipelines for automated bot deployment. |
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 |
| 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 |