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

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

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

始める前に

始める前に、Agent Registry を設定します。これらのタスクを行うには、プロジェクト ID が必要です。

Agent Registry API を有効にします。

コンソール

API を有効にするために必要なロール

API を有効にするには、serviceusage.services.enable 権限が必要です。プロジェクトを作成した場合は、オーナーロール（roles/owner）を介してこの権限がすでに付与されている可能性があります。それ以外の場合は、Service Usage 管理者ロール（roles/serviceusage.serviceUsageAdmin）を介してこの権限を取得できます。ロールを付与する方法をご覧ください。

API の有効化

gcloud

プロジェクトで Agent Registry API を有効にします。

gcloud services enable agentregistry.googleapis.com \
    --project=PROJECT_ID

PROJECT_ID は、実際のプロジェクト ID に置き換えます。

必要なロール

エージェント レジストリにエージェントを登録するために必要な権限を取得するには、プロジェクトに対する 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. [削除] をクリックします。

次のステップ