自動登録を使用する

Agent Registry では、サポートされている Google Cloud ランタイムでホストされているエージェントを登録できます。Agent Registry API を手動で呼び出す必要はありません。ランタイムによっては、この登録プロセスは自動的に行われるか、デプロイ時にオプトイン構成の手順が必要になります。

このドキュメントでは、サポートされているランタイムでエージェントの検出を有効にする方法について説明します。エージェントを外部またはサポートされていないランタイムでホストする場合は、手動登録を使用するをご覧ください。

エージェントの登録時にエージェントから抽出されるメタデータとスキルは、エージェントのプロトコルによって異なります。詳細については、エージェントを登録するをご覧ください。

Agent Runtime からエージェントを登録する

Gemini Enterprise Agent Platform の Agent Runtime を使用してエージェントを開発してデプロイする場合、Agent Registry への登録は自動的に行われます。

Agent2Agent（A2A）プロトコルは、エージェントが機能と ID を宣言できるようにするオープン スタンダードです。次の例は、A2A プロトコルを実装するエージェントをエージェント ランタイムにデプロイする方法を示しています。詳細については、エージェントをデプロイするをご覧ください。

# Create and deploy the agent
# This action automatically registers the agent in Agent Registry
remote_agent = client.agent_engines.create(
    agent=my_a2a_agent, # Your defined A2A object
    config={
        "display_name": "my-support-agent",
        "description": "An agent that handles support tickets.",
        "requirements": ["google-cloud-aiplatform[agent_engines,langchain]"],
    },
)

Agent Runtime でエージェントを更新または削除すると、Agent Registry はそれらの変更を自動的に同期します。

組み込みの Google エージェントを登録する

Google Workspace エージェントや Gemini Enterprise エージェントなどの組み込みの Google エージェントは、エージェント レジストリに自動的に登録されます。構成やデプロイの手順を行う必要はありません。これらのエージェントは取り込まれ、レジストリ内の検出に使用できます。

GKE からエージェントを登録する

Google Kubernetes Engine（GKE）にデプロイされたエージェントを登録するには、デプロイに apphub.cloud.google.com/functional-type: "AGENT" アノテーションを追加します。このアノテーションは、デプロイを AI エージェントとして識別し、エージェント レジストリがイントロスペクション スキャンを実行できるようにします。

次の例は、GKE エージェントのデプロイ マニフェストを示しています。詳細については、AI エージェントをデプロイしてオーケストレートするをご覧ください。

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-agent
  annotations:
    # Identifies the deployment as an AI agent
    apphub.cloud.google.com/functional-type: "AGENT"
spec:
  selector:
    matchLabels:
      app: my-agent
  template:
    metadata:
      labels:
        app: my-agent
    spec:
      containers:
      - name: server
        image: gcr.io/my-project/my-agent:1.0.0

デプロイが適用されると、GKE クラスタはエージェントからメタデータを自動的に取得し、Agent Registry データモデルに直接同期しようとします。

登録を確認する

エージェントを一覧表示することで、エージェント レジストリがエージェントを正常に登録したことを確認できます。

コンソール

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

    Agent Registry に移動

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

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

    このページには、登録されているすべてのエージェントのリストと、名前、識別子、説明、ランタイム、ロケーションなどの詳細が表示されます。

  4. エージェントのロケーションまたはランタイム リソースでリストをフィルタします。

    • 地域でフィルタするには、[地域] メニューをクリックし、フィルタする地域を選択して、[適用] をクリックします。
    • ランタイムでフィルタするには、[ランタイム] メニューをクリックし、フィルタするランタイムを選択して、[適用] をクリックします。

    このページには、選択した条件に一致する登録済みエージェントのフィルタされたリストが表示されます。

gcloud

複数のエージェントがある場合や、自動的に登録されたエージェントなど、特定のエージェントの登録を確認する場合は、エージェントのメタデータでリストをフィルタできます。

これを行うには、Agent Registry 用に Google Cloud CLI 環境を設定し、次のコマンドを実行します。

gcloud alpha agent-registry agents list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter="FILTER_EXPRESSION"

次のように置き換えます。

  • PROJECT_ID: プロジェクト ID。
  • REGION: レジストリ リージョン。
  • FILTER_EXPRESSION: フィルタするエージェントのフィルタ式。たとえば、表示名でフィルタリングするには、displayName='DISPLAY_NAME' を使用します。グローバルに一意の識別子（URN）でフィルタするには、agentId='urn:agent:AGENT_URN' を使用します。

組み込みの Google エージェントは、エージェントのデプロイ場所に応じて URN 形式を使用します。たとえば、--filter="agentId:'urn:agent:googleapis.com:*'" を使用して googleapis.com パブリッシャーのリストをフィルタリングすると、組み込みの Google Workspace エージェントを見つけることができます。