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

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

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

始める前に

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

必要なロール

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

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

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

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

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

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

    Agent Registry に移動

  2. プロジェクト選択ツールから、エージェント レジストリを設定した Google Cloud プロジェクトを選択します。

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

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

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

    • Display name: Mock Travel Agent
    • 説明: A mock agent that plans travel itineraries.
    • ロケーション: global を選択します。
    • エージェント タイプ: [A2A] を選択します。

  6. [エージェント仕様] セクションで、[JSON を貼り付け] タブを選択します。

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

    {
  "schemaVersion": "0.3",
  "agent": {
    "name": "mock-travel-agent",
    "description": "A mock agent that plans travel itineraries.",
    "skills": [
      {
        "name": "BookFlight",
        "description": "Books a flight to a destination."
      },
      {
        "name": "SearchHotels",
        "description": "Searches for hotels in a destination city."
      }
    ]
  }
}

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

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

登録を確認する

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

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

クリーンアップ

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

  1. [エージェント] タブで、リストから [Mock Travel Agent] を見つけます。
  2. [Mock Travel Agent] の横にある [その他のオプション] メニューをクリックし、[削除] を選択します。
  3. 確認ダイアログで [削除] をクリックします。

次のステップ