クイックスタート: エージェントを登録する

Agent Registry にエージェントを登録すると、分離されたコンポーネントを AI エコシステムの検出可能な部分に変換できます。エージェントの A2A スキルを公開すると、組織内の他のデベロッパーやオーケストレーター エージェントが、あなたの作業を見つけて再利用できるようになります。

このクイックスタートでは、 Google Cloud コンソールを使用して、Agent Registry にモック エージェントを手動で登録します。Agent Registry のエージェント登録メカニズムの詳細については、エージェントを登録するをご覧ください。

始める前に

  1. Agent Registry を設定する。
  2. Agent Registry が有効になっているガバナンス プロジェクトのプロジェクト ID を取得します。

必要なロール

Agent Registry にエージェントを登録するために必要な権限を取得するには、Agent Registry が有効になっているガバナンス プロジェクトに対する Agent Registry API 編集者 （roles/agentregistry.editor）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織へのアクセス権の管理をご覧ください。

必要な権限は、カスタムロールや他の事前定義ロールから取得することもできます。

モック エージェントを登録する

Agent Registry を試すには、サンプルの Agent2Agent（A2A）エージェント カードを貼り付けて、モック エージェントを手動で登録します。

エージェントを登録する手順は次のとおりです。

  1. Google Cloud コンソールで [Agent Registry] に移動します。

    Agent Registry に移動

    プロンプトが表示されたら、[有効にする] をクリックして Agent Registry API を有効にします。

  2. プロジェクト選択ツールから、Agent Registry を設定した Google Cloud プロジェクトを選択します。

  3. [エージェント] タブを選択します。

  4. [エージェントを追加] をクリックします。

  5. [エージェントの詳細] パネルで、次の詳細を入力します。

    • タイプ: [A2A] を選択します。
    • リージョン: global（グローバル）を選択します。

  6. [JSON を貼り付け] タブを選択します。

  7. 次のサンプル エージェント カードのコンテンツを貼り付けます。

    {
  "supportedInterfaces": [
    {
      "url": "https://example.com/mock-travel-agent",
      "protocolBinding": "HTTP+JSON",
      "protocolVersion": "1.0.0"
    }
  ],
  "name": "mock-travel-agent",
  "description": "A mock agent that plans travel itineraries.",
  "version": "1.0.0",
  "capabilities": {
    "streaming": false,
    "pushNotifications": false
  },
  "defaultInputModes": ["text/plain"],
  "defaultOutputModes": ["text/plain"],
  "skills": [
    {
      "id": "BookFlight",
      "name": "BookFlight",
      "description": "Books a flight to a destination.",
      "tags": ["travel", "booking"]
    },
    {
      "id": "SearchHotels",
      "name": "SearchHotels",
      "description": "Searches for hotels in a destination city.",
      "tags": ["travel", "accommodation"]
    }
  ]
}

  8. [保存] をクリックします。

Agent Registry がエージェント カードを処理し、エージェントを登録します。

登録を確認する

モック エージェントが正常に登録されたことを確認するには、次の操作を行います。

  1. [エージェント] タブで、リストからモック エージェントを見つけます。
  2. エージェントの名前をクリックして、詳細を表示します。
  3. BookFlight と SearchHotels の A2A スキルが [概要] タブに表示されていることを確認します。

クリーンアップ

プロジェクトにモックリソースが残らないようにするには、登録済みのエージェントを削除します。

  1. [エージェント] タブで、リストからモック エージェントを見つけます。
  2. モック エージェントの [アクション] 列にある [その他のオプション] メニューをクリックし、[削除] を選択します。
  3. 確認ダイアログで「DELETE」と入力して操作を確定します。
  4. [削除] をクリックします。

次のステップ