自動登録を使用する

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

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

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

Vertex AI Agent Engine からエージェントを登録する

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

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

# 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]"],
    },
)

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

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

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

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

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

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

apiVersion: apps/v1
kind: Deployment
metadata:
  name: my-agent
  annotations:
    # Identifies the workload 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 データモデルに直接同期します。

登録を確認する

Agent Registry がエージェントを正常に登録したことを確認するには、エージェントを一覧表示します。

コンソール

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

Agent Registry に移動
プロジェクト選択ツールから、Agent Registry を設定した Google Cloud プロジェクトを選択します。
[エージェント] タブを選択します。

このページには、登録されているすべてのエージェントとその詳細（名前、識別子、説明、ランタイム、ロケーションなど）のリストが表示されます。
エージェントのロケーションまたはランタイムリソースでリストをフィルタします。
- ロケーションでフィルタするには、[ロケーション] メニューをクリックし、フィルタするロケーションを選択して [適用] をクリックします。
- ランタイムでフィルタするには、[ランタイム] メニューをクリックし、フィルタするランタイムを選択して [適用] をクリックします。
選択した条件でフィルタされた登録済みエージェントのリストが表示されます。

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 形式が使用されます。たとえば、リストを googleapis.com パブリッシャーでフィルタすることで、組み込みの Google Workspace エージェントを検出できます。--filter="agentId:'urn:agent:googleapis.com:*'"