azure-microsoft-discovery について
azure-microsoft-discovery は Microsoft Discovery ソリューションの構築・運用者向けガイダンススキルです。アーキテクチャ、セキュリティ、デプロイ、トラブルシューティング、統合を扱い、ローカル資料とネットワーク経由のドキュメント取得を組み合わせます。
主な機能
- 01デプロイと実行時の問題対応
- 02エージェント、モデル、コストの選定
- 03共有セッションのアーキテクチャ案内
- 04セキュリティ、RBAC、ネットワーク設定
- 05ストレージ、ツール、ログの設定
- 06REST API と SDK の統合
活用シーン
- 01Discovery のタスクやデプロイ失敗の診断
- 02エージェント種別、モデル、クォータの計画
- 03Discovery ワークスペースとセッションの保護
- 04API または SDK によるツール統合
MCP 対応
mcp_microsoftdocs:microsoft_docs_fetch で Microsoft ドキュメントを取得でき、代替手段として fetch_webpage が用意されています。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-microsoft-discoveryインストール後、Claude Code で/azure-microsoft-discoveryを入力して読み込まれたか確認します。
詳細
Azure Microsoft Discovery スキル
このスキルでは、Azure Microsoft Discovery に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイを扱います。ローカルのクイックリファレンスコンテンツと、リモートドキュメントの取得機能を組み合わせています。
このスキルの使い方
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 が返されます。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| トラブルシューティング | L37-L45 | ログと相関 ID を使用して、Microsoft Discovery のデプロイ時/実行時の障害、タスク実行の問題、既知のバグ、特定のエラーコードを診断し、解決します。 |
| ベストプラクティス | L46-L52 | Microsoft Discovery を使用して構築する際の、プロジェクトや共有セッションの構成、信頼レベルの調整、責任ある AI と安全性に関するプラクティスの適用について説明します。 |
| 意思決定 | L53-L60 | エージェントの種類、モデル、コンテナーレジストリの選択や課金の理解に関するガイダンスを提供し、Microsoft Discovery ソリューションの設計、規模の決定、コスト最適化に役立ちます。 |
| アーキテクチャと設計パターン | L61-L65 | Discovery Engine の高度な共有セッションパターンの設計と実装について説明します。複数ユーザーのセッション管理、データ共有、スケーラブルなアーキテクチャのベストプラクティスを含みます。 |
| 制限とクォータ | L66-L71 | Microsoft Discovery のデプロイにおける容量とクォータの制限、および Azure の Discovery リソースに必要な命名規則とパターンを計画します。 |
| セキュリティ | L72-L93 | Microsoft Discovery のデプロイとスーパーコンピューターを保護するためのセキュリティ、暗号化、RBAC、マネージド ID、ネットワーク強化、監査ログ、コンプライアンスマッピングについて説明します。 |
| 構成 | L94-L111 | Discovery リソースの構成について説明します。ストレージ、ファイル、ツール、データ処理、Bookshelf/インデックスのほか、監視とトラブルシューティングのためのログ(Kusto、Log Analytics、アクティビティ)のクエリを含みます。 |
| 統合とコーディングパターン | L112-L122 | ワークフローへの Discovery ツール/モデルの統合、Docker を使用したコンテナー化、REST によるジョブの実行、.NET、Java、JavaScript SDK とアクションスクリプトの使用について説明します。 |
| デプロイ | L123-L129 | AKS への Discovery Supercomputer のデプロイとアップグレード、REST によるインフラストラクチャのプロビジョニング、Discovery ツールイメージの ACR への公開、複数の Azure リージョンへのデプロイについて説明します。 |
トラブルシューティング
| トピック | URL |
|---|---|
| Discovery Engine のタスク実行に関する問題をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-debug-task-execution |
| アクティビティログで Microsoft Discovery の相関 ID を確認する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-get-correlation-id |
| Microsoft Discovery の既知の問題を回避する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/known-issues |
| Microsoft Discovery のデプロイおよびランタイムに関する問題をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/microsoft-discovery/troubleshoot-microsoft-discovery |
| Microsoft Discovery のエラーコードとメッセージを解決する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/troubleshooting-error-code |
ベストプラクティス
| トピック | URL |
|---|---|
| Discovery でプロジェクトと共有セッションのプラクティスを適用する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-projects-investigations |
| Microsoft Discovery で責任ある AI のプラクティスを適用する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-responsible-ai |
| Microsoft Discovery で信頼性を調整し、基本的な共有セッションのパターンを適用する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-trust-basic-investigation-patterns |
意思決定
| トピック | URL |
|---|---|
| Discovery に適した Azure Container Registry を選択して構成する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-azure-container-registry |
| 適切な Microsoft Discovery エージェントの種類を選択する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-discovery-agent-types |
| Microsoft Discovery の請求と料金について理解する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-discovery-billing |
| Discovery エージェントに適切なモデルを選択する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-select-models-for-agents |
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| Discovery Engine で高度な共有セッションのパターンを適用する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-advanced-investigation-patterns |
制限とクォータ
| トピック | URL |
|---|---|
| Microsoft Discovery のデプロイに必要な Azure クォータを計画する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-quota-reservation |
| Microsoft Discovery のリソース命名規則を適用する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-resource-naming |
セキュリティ
構成
統合とコーディングパターン
| トピック | URL |
|---|---|
| ツールとモデルを Microsoft Discovery のワークフローに統合する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-tools-model-integration |
| Discovery ツールをコンテナー化する Dockerfile を作成する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-create-tool-docker-file |
| ジョブの実行に Discovery Supercomputer REST API を使用する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-run-jobs-supercomputer-rest-api |
| Discovery のアクションベースのツール用にアクションスクリプトを実装する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-write-tool-action-scripts |
| Microsoft Discovery 用の .NET SDK パッケージを使用する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/reference-dotnet-sdks |
| Microsoft Discovery 用の Java SDK アーティファクトを使用する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/reference-java-sdks |
| Microsoft Discovery 用の JavaScript SDK パッケージを使用する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/reference-javascript-sdks |
デプロイ
| トピック | URL |
|---|---|
| Discovery Supercomputer の AKS アップグレード動作を理解する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/concept-supercomputer-aks-upgrades |
| Azure の複数リージョンに Microsoft Discovery をデプロイする | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-deploy-across-regions |
| REST API を使用して Discovery Supercomputer インフラストラクチャをプロビジョニングする | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-manage-supercomputers-rest-api |
| Discovery ツールのイメージを Azure Container Registry に公開する | https://learn.microsoft.com/en-us/azure/microsoft-discovery/how-to-publish-tool-to-acr |