エージェントを登録すると、エージェント レジストリ内で検出可能なコンポーネントになります。エージェントのスキルを公開することで、 組織内の他のデベロッパーやオーケストレータエージェントがあなたの作業を見つけて 再利用できるようになり、AI 開発全体のスピードアップにつながります。
エージェント ランタイムに応じて、エージェント レジストリは 2 つの主要な 登録メカニズムをサポートしています。自動登録と 手動登録です。
このドキュメントでは、エージェント ランタイムに適した登録メカニズムを選択するのに役立ちます。
自動登録
サポートされている Google Cloud ランタイムは、デフォルトで、またはオプトイン デプロイ ステップを通じて、エージェントをエージェント レジストリ に登録します。
自動登録は、次の Google Cloud ランタイムでサポートされています。
- Gemini Enterprise Agent Platform のエージェント ランタイム: SDK を使用してデプロイされたエージェントは 追加の設定なしで登録されます。
- Google の組み込みエージェント: Google Workspace エージェントや Gemini Enterprise エージェントなど、Google が直接提供するエージェントは、 設定なしで検出できます。
- Google Kubernetes Engine: Google Kubernetes Engine（GKE）にデプロイされたコンテナ化エージェントは、特定のエージェント レジストリの機能タイプ アノテーションが含まれている場合に 登録されます。
登録時にキャプチャされるエージェントのメタデータとスキルは、エージェントのプロトコルによって異なります。
- Agent2Agent（A2A）プロトコルを実装するエージェント: A2A は、エージェントが機能と ID を宣言できるオープン スタンダードです。エージェントが このプロトコルを実装している場合、エージェント レジストリはエージェントのスキルを エージェント カードから自動的に抽出し、 レジストリに入力します。
- A2A プロトコルを実装していないエージェント: エージェント レジストリは エージェントを登録しますが、推論 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）を実装していないリモート エージェント。
エージェントを手動で登録する方法については、手動登録を使用するをご覧ください。