エージェントを登録すると、Agent Registry 内で検出可能なコンポーネントになります。エージェントの A2A スキルを公開すると、組織内の他のデベロッパーやオーケストレーター エージェントがお客様の作業を見つけて再利用できるようになり、AI 開発全体を加速できます。
エージェント レジストリは、Agent2Agent（A2A）プロトコルとその仕様とシームレスに統合されます。A2A は、エージェントが機能と ID を宣言できるオープン スタンダードです。エージェント レジストリは、A2A 仕様のバージョン 0.3 と 1.0 をサポートしています。詳しくは、エージェント カードのスキーマをご覧ください。
エージェント ランタイムに応じて、Agent Registry は 2 つの主な登録メカニズム（自動登録と手動登録）をサポートしています。
このドキュメントは、エージェント ランタイムに適した登録メカニズムを選択するのに役立ちます。
自動登録
サポートされている Google Cloud ランタイムは、デフォルトで、またはオプトイン デプロイ ステップを通じて、同じプロジェクト内のエージェント レジストリにエージェントを登録します。自動登録はプロジェクト レベルで動作し、他のプロジェクトにデプロイされたエージェントを自動的に検出することはありません。 Google Cloud
自動登録は、次の Google Cloud ランタイムでサポートされています。
- Gemini Enterprise Agent Platform の Agent Runtime: SDK を使用してデプロイされたエージェントは、追加の構成なしで登録されます。
- 組み込みの Google エージェント: Google Workspace エージェントや Gemini Enterprise エージェントなど、Google が直接提供するエージェントは、構成なしで検出できます。
- Google Kubernetes Engine: Google Kubernetes Engine（GKE）にデプロイされたコンテナ化されたエージェントは、特定のエージェント レジストリの機能タイプ ラベルが含まれている場合に登録されます。
登録時にキャプチャされたエージェントのメタデータと A2A スキルは、エージェントのプロトコルによって異なります。
- Agent2Agent（A2A）プロトコルを実装するエージェント: A2A は、エージェントが機能と ID を宣言できるようにするオープン スタンダードです。エージェントがこのプロトコルを実装している場合、Agent Registry はエージェントの エージェント カードから A2A スキルを自動的に抽出し、レジストリに登録します。
- A2A プロトコルを実装していないエージェント: Agent Registry はエージェントを登録しますが、推論 URL や A2A スキルなどのメタデータを自動的にキャプチャできません。エージェントを検出できるようにこの情報を提供するには、手動登録を使用します。
自動登録をサポートする Google Cloud ランタイムについては、自動登録を使用するをご覧ください。
手動登録
外部プラットフォーム、オンプレミス、自動検出をサポートしていない Google Cloudランタイム、または異なるGoogle Cloud プロジェクトでホストされているエージェントの場合は、手動登録を使用する必要があります。
エージェントを手動で登録するには、Agent Registry API、Google Cloud CLI、または Terraform を使用して、エージェントのエンドポイントと構成を定義する Service リソースを作成します。この書き込み可能な Service リソースには、エージェントの固有の詳細も含まれています。Service が作成されると、レジストリは読み取り専用の Agent リソースを生成します。このリソースは検出に使用できます。
次の 2 種類のエージェントを手動で登録できます。
- A2A 準拠のエージェント: A2A 仕様（
A2A_AGENT_CARD）を実装するエージェント。レジストリは、エージェント カード（agent-card.json）エンドポイントをスキャンして、A2A スキルをインデックスに登録します。 - 標準 REST エージェント: 標準 REST API エンドポイントなど、A2A 仕様（
NO_SPEC）を実装していないリモート エージェント。
エージェントを手動で登録する方法については、手動登録を使用するをご覧ください。
プロジェクト間の登録に関する考慮事項
組織で Agent Gateway を使用した一元化されたガバナンス アーキテクチャを使用している場合は、一元化されたガバナンス プロジェクトに Agent-to-Anywhere 下り（外向き）ゲートウェイをデプロイし、複数のスポーク プロジェクトまたはワークロード プロジェクトにデプロイされたエージェントを登録できます。
自動登録ではローカル プロジェクトのリソースのみが検出されるため、リモート エージェントは中央ガバナンス プロジェクトのレジストリに手動で登録する必要があります。プロジェクト間の登録により、中央ゲートウェイはエージェントを特定して管理できます。手順については、別のプロジェクトからエージェントを登録するをご覧ください。
スタンドアロン スキルを統合する
エージェント レジストリを使用すると、エージェントのスタンドアロンのスキルを最上位のリソースとして管理できます。スタンドアロン スキルは、レジストリに Skill リソースとして登録されます。これにより、管理者はきめ細かいアクセス ポリシーを適用し、スキル リビジョンを使用してバージョン履歴を管理できます。
Gemini Enterprise でエージェントを構築して管理する際に、これらの登録済みスキルを参照して、エージェントの機能を拡張できます。スタンドアロン スキルを登録して管理する方法については、スキルを登録するとスキルを管理するをご覧ください。