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