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

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

このクイックスタートでは、 Agent Registry にモックエージェントを手動で登録する方法について、 Google Cloud コンソールを使用して説明します。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 でエージェントを登録するために必要な権限を取得するには、プロジェクトに対するAgent Registry API 編集者 （roles/agentregistry.editor）IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

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

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

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

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

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

    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] スキルが表示されていることを確認します。

クリーンアップ

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

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

次のステップ