エージェントを登録すると、検出可能なサービスになります。 エージェントのスキルを公開することで、組織内の他のデベロッパー やオーケストレータエージェントがお客様の作業を見つけて再利用できるようになり、 AI 開発全体を加速させることができます。
エージェントのランタイムに応じて、Agent Registry は 2 つの主要な 登録メカニズムをサポートしています。自動登録と 手動登録です。
このドキュメントは、エージェントのランタイムに適した登録メカニズムを選択するのに役立ちます。
自動登録
サポートされている Google Cloud ランタイムは、デフォルトで、またはオプトイン デプロイ ステップを使用して、エージェントを Agent Registry に登録します。
自動登録は、次の Google Cloud ランタイムでサポートされています。
- Vertex AI Agent Engine: SDK を使用してデプロイされたエージェントは、 追加の設定なしで登録されます。
- Google の組み込みエージェント: Google Workspace エージェントや Gemini Enterprise エージェントなど、Google が直接提供するエージェントは、 構成なしで検出できます。
- Google Kubernetes Engine: GKE にデプロイされたコンテナ化されたエージェントは、特定の Agent Registry 機能タイプ アノテーションが含まれている場合に 登録されます。
登録時にキャプチャされるエージェントのメタデータとスキルは、エージェントのプロトコルによって異なります。
- Agent2Agent（A2A）プロトコルを実装するエージェント: A2A は、エージェントが機能と ID を宣言できるオープン スタンダードです。エージェントがこのプロトコルを実装している場合、Agent Registry はエージェントのスキルをエージェント カードから自動的に抽出し、レジストリに入力します。
- A2A プロトコルを実装していないエージェント: Agent Registry は エージェントを登録しますが、推論 URL やスキルなどのメタデータを自動的にキャプチャすることはできません。エージェントを検出可能にするためにこの情報を提供するには、 手動登録を使用します。
自動登録をサポートする Google Cloud ランタイムについては、 自動登録を使用するをご覧ください。
手動登録
外部プラットフォーム、オンプレミス、または自動検出をサポートしていない Google Cloud ランタイムでホストされているエージェントの場合は、手動 登録を使用する必要があります。
エージェントを手動で登録するには、Agent Registry API を使用して、エージェントのエンドポイントと構成を定義する Service
リソースを作成します。この書き込み可能なリソースには、エージェントの固有の詳細も含まれています。Serviceが
作成されると、レジストリは検出に使用できる読み取り専用のAgentリソースを生成します。
検出に使用できます。
次の 2 種類のエージェントを手動で登録できます。
- A2A 準拠のエージェント: Agent2Agent（A2A）仕様
（
A2A_AGENT_CARD）を実装するエージェント。レジストリは、 エージェント カード （agent-card.json）エンドポイントをスキャンして、スキルにインデックスを付けます。 - 標準 REST エージェント: 標準 REST API エンドポイントなど、A2A 仕様（
NO_SPEC）を実装していないリモート エージェント。
エージェントを手動で登録する方法については、手動登録を使用するをご覧ください。