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

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

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

始める前に

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

Agent Registry API を有効にします。

コンソール

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

API を有効にするには、serviceusage.services.enable 権限を含む Service Usage 管理者 IAM ロール（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 ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

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

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

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

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

  1. Google Cloud コンソールで、[エージェント レジストリ] に移動します。

    Agent Registry に移動

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

  2. プロジェクト選択ツールから、エージェント レジストリを設定した 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 スキルが表示されていることを確認します。

クリーンアップ

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

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

次のステップ