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

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

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

始める前に

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

必要なロール

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

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

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

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

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

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

    Agent Registry に移動

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

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

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

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

    • 表示名: 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] の横にある [More options] メニューをクリックし、[Delete] を選択します。
  3. 確認ダイアログで [削除] をクリックします。

次のステップ

  • 登録済みエージェントを管理する方法を 確認する。
  • 自動登録について学習する 。これは、マネージド ランタイムにデプロイされたエージェントを登録する推奨の方法です。
  • Agent Registry の基本的なコンセプトを読む。