azure-digital-twins について
azure-digital-twins は Azure Digital Twins の設計、設定、セキュリティ、トラブルシューティングを案内するエージェントスキルです。ローカルの参照資料とリモート取得するドキュメントを組み合わせ、モデリングからデプロイまで扱います。
主な機能
- 01トラブルシューティングと性能診断
- 02DTDL のモデリングと設計指針
- 03セキュリティと ID の設定
- 04インスタンス、グラフ、クエリの設定
- 05SDK、CLI、サービス連携
- 06リージョン間移行の案内
活用シーン
- 01403、404、性能の問題の診断
- 02ツイングラフと高可用性設計の計画
- 03ID、エンドポイント、イベントルートの設定
- 04SDK や CLI による関連サービス連携
MCP 対応
mcp_microsoftdocs ツールでリモートドキュメントを取得でき、代替手段として fetch_webpage も利用できます。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-digital-twinsインストール後、Claude Code で/azure-digital-twinsを入力して読み込まれたか確認します。
詳細
Azure Digital Twins スキル
このスキルでは、Azure Digital Twins に関する専門的なガイダンスを提供します。トラブルシューティング、ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターン、デプロイについて説明します。ローカルのクイックリファレンスコンテンツと、リモートでドキュメントを取得する機能を組み合わせています。
このスキルの使用方法
エージェントにとって重要:関連するセクションを見つけるには、以下のカテゴリインデックスを使用してください。行範囲が記載されたカテゴリ(例:
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-L46 | 403/404 エラー、Explorer の認証問題、CLI の解析エラー、既知のバグ、パフォーマンスのトラブルシューティングなど、Azure Digital Twins の一般的な問題の診断と修正。 |
| ベストプラクティス | L47-L52 | RDF/OWL オントロジーを DTDL に変換する方法、Azure Digital Twins 用に DTDL を拡張する方法、ツイングラフに効果的なタグ付けパターンを設計する方法など、モデリングのベストプラクティスに関するガイダンス。 |
| 意思決定 | L53-L57 | ツインモデルに使用する DTDL ベースの業界オントロジーの選定に関するガイダンスと、Azure Digital Twins のプレビュー制御プレーン API から現行 API に移行する手順。 |
| アーキテクチャと設計パターン | L58-L63 | 回復性に優れた Digital Twins ソリューション(HA/DR)の設計と、相互運用可能なツイングラフを実現するために業界オントロジーを DTDL モデルに変換する方法。 |
| 制限とクォータ | L64-L69 | Azure Digital Twins のクエリユニットの使用状況に加え、サービスの制限、スロットリングの動作、調整可能なクォータの確認や変更の申請方法。 |
| セキュリティ | L70-L78 | Azure Digital Twins のセキュリティに関するガイダンス:Entra アプリ登録による認証、クライアント認証、Private Link の設定、顧客の個人データの取り扱い、ベストプラクティス。 |
| 構成 | L79-L103 | Azure Digital Twins の構成と運用:インスタンスの設定、セキュリティ、エンドポイントとルート、データ履歴、監視、グラフ・ツイン・モデルの管理、Explorer/3D ツール、クエリ言語の使用。 |
| 統合とコーディングパターン | L104-L120 | SDK、REST/CLI、クエリ、プラグインを使用して、Azure Digital Twins を IoT Hub、Azure Data Explorer、Functions、Power Platform、.NET クライアントと統合する方法。クエリと DTDL モデルのパターンも含みます。 |
| デプロイ | L121-L124 | Azure Digital Twins インスタンスを別のリージョンに移動するためのガイダンス。前提条件、サポートされるシナリオ、段階的な移行手順を説明します。 |
トラブルシューティング
| トピック | URL |
|---|---|
| Azure Digital Twins の 403 Forbidden エラーを修正する | https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-403-digital-twins |
| Azure Digital Twins の 404 サブドメインが見つからないエラーを修正する | https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-404-digital-twins |
| Azure Digital Twins Explorer の認証エラーを解決する | https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-azure-digital-twins-explorer-authentication |
| Azure Digital Twins CLI の解析失敗エラーを解決する | https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-error-cli-parse |
| Azure Digital Twins の既知の問題を解決する | https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-known-issues |
| Azure Digital Twins のパフォーマンス問題をトラブルシューティングする | https://learn.microsoft.com/en-us/azure/digital-twins/troubleshoot-performance |
ベストプラクティス
| トピック | URL |
|---|---|
| Azure Digital Twins の DTDL オントロジーを拡張する | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-ontologies-extend |
| Azure Digital Twins のタグ付けパターンを実装する | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-use-tags |
意思決定
| トピック | URL |
|---|---|
| Azure Digital Twins のプレビュー制御プレーン API から移行する | https://learn.microsoft.com/en-us/azure/digital-twins/resources-migrate-from-preview-apis |
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| Digital Twins の高可用性とディザスターリカバリーを計画する | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-high-availability-disaster-recovery |
| 業界オントロジーを Azure Digital Twins 用の DTDL に変換する | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-ontologies-convert |
制限とクォータ
| トピック | URL |
|---|---|
| Digital Twins のクエリユニット消費量を把握する | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-query-units |
| Azure Digital Twins のサービス制限と調整可能なクォータ | https://learn.microsoft.com/en-us/azure/digital-twins/reference-service-limits |
セキュリティ
| トピック | URL |
|---|---|
| Azure Digital Twins にセキュリティのベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/digital-twins/concepts-security |
| Azure Digital Twins のクライアント認証を実装する | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-authenticate-client |
| Azure Digital Twins の Entra アプリ登録を作成する | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-create-app-registration |
| Azure Digital Twins の Private Link を有効にする | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-enable-private-link |
| Azure Digital Twins で顧客の個人データを扱う | https://learn.microsoft.com/en-us/azure/digital-twins/resources-customer-data-requests |
構成
統合とコーディングパターン
デプロイ
| トピック | URL |
|---|---|
| Azure Digital Twins インスタンスをリージョン間で移動する | https://learn.microsoft.com/en-us/azure/digital-twins/how-to-move-regions |