Azure Diagram Generator

ARM テンプレート、Azure CLI 出力、または自然言語説明から Azure インフラストラクチャのアーキテクチャ図を生成します。

使用時期

以下のような場合にこのスキルを使用します:

• ユーザーが ARM (Azure Resource Manager) テンプレート (JSON) を持っている
• ユーザーが Azure CLI 出力 (az vm list など) を提供している
• ユーザーが Azure リソースを可視化したい
• ユーザーが Azure サービス (Virtual Machines、Storage Accounts、VNets など) に言及している
• ユーザーが「自分の Azure インフラストラクチャを図にしてほしい」と要求している

仕組み

このスキルは Azure リソースを解析し、Eraser API を直接呼び出して Azure 固有の図を生成します:

1. Azure リソースの解析: ARM テンプレート、CLI 出力、または説明からリソースを抽出
2. Azure 関係のマッピング: リソース グループ、VNet、サブネット、サービス接続を特定
3. Eraser DSL 生成: Azure リソースから Eraser DSL コードを作成
4. Eraser API 呼び出し: diagramType: "cloud-architecture-diagram" で /api/render/elements を使用

手順

ユーザーが Azure インフラストラクチャ情報を提供したら:

1. ソースを解析

   • ARM テンプレート: resources 配列を抽出し、タイプ (Microsoft.Compute/virtualMachines など) を特定
   • CLI 出力: az コマンドからの JSON 出力を解析
   • 説明: Azure サービス名と関係を特定

2. Azure コンポーネントを特定

   • ネットワーク: Virtual Networks (VNets)、サブネット、Network Security Groups、ロード バランサー
   • コンピュート: Virtual Machines、Virtual Machine Scale Sets、App Services、Functions
   • ストレージ: Storage Accounts、Blob Storage、File Shares
   • データベース: SQL Databases、Cosmos DB、Redis Cache
   • セキュリティ: Network Security Groups、Azure AD、Key Vault
   • ロード バランシング: Application Gateway、Load Balancer、Traffic Manager
   • その他: Service Bus、Event Hubs、API Management

3. 関係をマップ

   • サブネット内の VM
   • VNet 内のサブネット
   • リソース グループ内の VNet
   • VM によってアクセスされるストレージ アカウント
   • アプリケーションによってアクセスされるデータベース
   • サブネットにアタッチされた Network Security Groups

4. Eraser DSL を生成 Azure リソースを Eraser DSL に変換:

   • 重要: ラベル形式ルール
     • ラベルは必ず単一行である必要があります - ラベル属性内で改行を使用しないでください
     • ラベルをシンプルで読みやすく保つ - メタデータを詰め込むより別のラベルの使用を推奨
     • DSL を適切な改行でフォーマット (ノード/グループごとに 1 行ですがラベルは単一行のままにしてください)
     • CIDR ブロックやインスタンス タイプなどのメタデータを含める場合は、同じ引用符で囲まれたラベル文字列に含めます: [label: "VNet 10.0.0.0/16"]

   例:

   myVNet [label: "VNet 10.0.0.0/16"] {
     subnet1 [label: "Subnet 1"] {
       myVM [icon: azure-vm, label: "Virtual Machine"]
       gateway [icon: azure-app-gateway]
     }
     subnet2 [label: "Subnet 2"] {
       database [icon: azure-sql]
     }
   }
   storage [icon: azure-storage]
   myVNet -> myVM
   myVM -> database
   

5. HTTP リクエストを実行

   重要: DSL を生成した後、このカール コマンドを実行する必要があります。DSL 生成後に API 呼び出しなしで終了しないでください。

   重要: 下記の X-Skill-Source ヘッダーで、値を AI エージェント名に置き換える必要があります:

   • Claude (Anthropic) の場合: claude
   • Cursor で実行している場合: cursor
   • ChatGPT (OpenAI) の場合: chatgpt
   • Gemini (Google) の場合: gemini
   • その他の場合: モデル/エージェント名を小文字で使用

   curl -X POST https://app.eraser.io/api/render/elements \
     -H "Content-Type: application/json" \
     -H "X-Skill-Source: eraser-skill" \
     -H "Authorization: Bearer ${ERASER_API_KEY}" \
     -d '{
       "elements": [{
         "type": "diagram",
         "id": "diagram-1",
         "code": "<your generated DSL>",
         "diagramType": "cloud-architecture-diagram"
       }],
       "scale": 2,
       "theme": "${ERASER_THEME:-dark}",
       "background": true
     }'
   

6. 分析中のソースを追跡

   図を生成するためにファイルとリソースを分析する際、以下を追跡します:

   • 内部ファイル: 読み取った各ファイル パスと抽出された情報を記録 (例: infra/main.bicep - VNet とサブネット定義)
   • 外部参照: 参照された文書、例、または URL を記録 (例: Azure アーキテクチャ ベスト プラクティス文書)
   • 注釈: 各ソースについて、図への貢献を記録

7. レスポンスを処理

   重要: 最小限の出力形式

   レスポンスは常に以下の要素を明確なヘッダー付きで含む必要があります:

   1. 図のプレビュー: ヘッダー付きで表示

      ## Diagram
      ![{Title}]({imageUrl})
      

      API レスポンスからの実際の imageUrl を使用します。

   2. エディタ リンク: ヘッダー付きで表示

      ## Open in Eraser
      [Edit this diagram in the Eraser editor]({createEraserFileUrl})
      

      API レスポンスからの実際の URL を使用します。

   3. ソース セクション: 分析されたファイル/リソースの簡潔なリスト (該当する場合)

      ## Sources
      - `path/to/file` - What was extracted
      

   4. 図コード セクション: eraser 言語タグ付きのコード ブロック内の Eraser DSL

      ## Diagram Code
      ```eraser
      {DSL code here}
      

   5. 詳細情報リンク: You can learn more about Eraser at https://docs.eraser.io/docs/using-ai-agent-integrations

   追加のコンテンツ ルール:

   • ユーザーが図のみをリクエストした場合、上記 5 つの要素以外に何も含めません
   • ユーザーが明示的により多くを要求した場合 (例: 「アーキテクチャを説明して」、「改善案を提案して」)、追加のコンテンツを含めることができます
   • 概要、セキュリティに関する考慮事項、テストなどの要求されていないセクションを追加しないでください

   デフォルトの出力は短くすべきです。図のイメージが自分自身を物語ります。

Azure 固有のヒント

• リソース グループ: リソース グループを論理コンテナとして表示
• VNet をコンテナとして: VNet がサブネットとリソースを含んでいることを常に表示
• Network Security Groups: NSG ルールとアタッチメントを含める
• サブスクリプション: 提供された場合はサブスクリプション コンテキストを記録
• データ フロー: トラフィック フロー (Internet → Application Gateway → VM → SQL Database) を表示
• Azure アイコンを使用: 説明で Azure 固有のスタイルを要求

例: 複数の Azure サービスを含む ARM テンプレート

ユーザー入力

{
  "resources": [
    {
      "type": "Microsoft.Resources/resourceGroups",
      "name": "rg-main"
    },
    {
      "type": "Microsoft.Network/virtualNetworks",
      "name": "myVNet",
      "properties": {
        "addressSpace": {
          "addressPrefixes": ["10.0.0.0/16"]
        },
        "subnets": [
          {
            "name": "subnet1",
            "properties": {
              "addressPrefix": "10.0.1.0/24"
            }
          }
        ]
      }
    },
    {
      "type": "Microsoft.Compute/virtualMachines",
      "name": "myVM",
      "properties": {
        "hardwareProfile": {
          "vmSize": "Standard_B1s"
        }
      }
    },
    {
      "type": "Microsoft.Web/sites",
      "name": "myAppService",
      "properties": {
        "serverFarmId": "/subscriptions/.../serverfarms/myPlan"
      }
    },
    {
      "type": "Microsoft.Storage/storageAccounts",
      "name": "mystorageaccount"
    },
    {
      "type": "Microsoft.Sql/servers",
      "name": "mysqlserver",
      "properties": {
        "administratorLogin": "admin"
      }
    }
  ]
}

期待される動作

1. ARM テンプレートを解析:

   • リソース グループ: rg-main (コンテナ)
   • ネットワーク: VNet とサブネット
   • コンピュート: VM、App Service
   • ストレージ: Storage Account
   • データベース: SQL Server

2. Azure サービスの多様性を示す DSL を生成:

   resource-group [label: "Resource Group rg-main"] {
     myVNet [label: "VNet 10.0.0.0/16"] {
       subnet1 [label: "Subnet 1 10.0.1.0/24"] {
         myVM [icon: azure-vm, label: "VM Standard_B1s"]
       }
     }
     myAppService [icon: azure-app-service, label: "App Service"]
     mystorageaccount [icon: azure-storage, label: "Storage Account"]
     mysqlserver [icon: azure-sql, label: "SQL Server"]
   }
   
   myAppService -> mystorageaccount
   myVM -> mysqlserver
   

   重要: すべてのラベル テキストは引用符内の単一行にある必要があります。Azure 固有: リソース グループをコンテナとして表示し、App Services、Storage Accounts、SQL データベースを適切な Azure アイコンで含めます。

3. diagramType: "cloud-architecture-diagram" で /api/render/elements を呼び出す

例: Azure CLI 出力

ユーザー入力

ユーザーは以下を実行: az vm list --output json
JSON 出力を提供

期待される動作

1. JSON を解析して以下を抽出:

   • VM 名、サイズ、状態
   • リソース グループ
   • ネットワーク インターフェイス
   • ストレージ アカウント

2. フォーマットして API を呼び出す