エージェントを登録すると、Agent Registry 内で検出可能なコンポーネントになります。エージェントの A2A スキルを公開すると、組織内の他のデベロッパーやオーケストレーター エージェントがお客様の作業を見つけて再利用できるようになり、AI 開発全体を加速できます。
Agent Registry は、Agent2Agent（A2A）プロトコルとその仕様とシームレスに統合されます。A2A は、エージェントが機能と ID を宣言できるオープン スタンダードです。Agent Registry は、A2A 仕様のバージョン 0.3 と 1.0 をサポートしています。詳しくは、エージェント カードのスキーマをご覧ください。
エージェント ランタイムに応じて、Agent Registry は 2 つの主な登録メカニズム（自動登録と手動登録）をサポートしています。
エージェント ランタイムに適した登録メカニズムを選択します。
自動登録
サポートされている Google Cloud ランタイムは、デフォルトで、またはオプトイン デプロイ ステップを通じて、同じプロジェクト内のエージェント レジストリにエージェントを登録します。自動登録はプロジェクト レベルで動作し、他のプロジェクトにデプロイされたエージェントを自動的に検出することはありません。 Google Cloud
自動登録は、次の Google Cloud ランタイムでサポートされています。
- Gemini Enterprise Agent Platform の Agent Runtime: SDK を使用してデプロイされたエージェントは、追加の構成なしで登録されます。詳細については、Agent Runtime からエージェントを登録するをご覧ください。
- 組み込みの Google エージェント: Google Workspace エージェントや Gemini Enterprise エージェントなど、Google が直接提供するエージェントは、構成なしで検出できます。詳細については、組み込みの Google エージェントを登録するをご覧ください。
- Google Kubernetes Engine: Google Kubernetes Engine（GKE）にデプロイされたコンテナ化されたエージェントは、AI エージェントの機能タイプ ラベルとエージェントカード アノテーションで構成されている場合に登録されます。GKE クラスタ ランタイム コントローラは、イントロスペクション スキャンを実行し、メタデータを Agent Registry に公開します。詳細については、GKE からエージェントを登録するをご覧ください。
- Cloud Run: Cloud Run サービスまたはジョブにデプロイされたコンテナ化されたエージェントは、機能タイプと ID タイプのフラグを使用してデプロイされるときに登録されます。Cloud Run は、エージェントの名前とタイプ（
AGENT）を Agent Registry に自動的に登録します。詳細については、Cloud Run からエージェントを登録するをご覧ください。
登録時にエージェント用にインデックス登録されるメタデータと機能は、エージェントが Agent2Agent（A2A）プロトコルを実装しているかどうかによって異なります。
- A2A プロトコルを実装するエージェント: システムはエージェントの Agent Card（
/.well-known/agent-card.json）をクエリして、アドバタイズされた A2A スキルと機能をレジストリ カタログに自動的に抽出します。 - A2A プロトコルを実装していないエージェント（標準の REST または gRPC エンドポイント）: Agent Registry はエージェントを登録しますが、エンドポイント URL、エージェントの ID、A2A スキルなどのメタデータを自動的にキャプチャできません。機能を 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 下り（外向き）ゲートウェイをデプロイし、複数のスポーク プロジェクトまたはワークロード プロジェクトにデプロイされたエージェントを登録できます。
自動登録ではローカル プロジェクトのリソースのみが検出されるため、リモート エージェントは中央ガバナンス プロジェクトのレジストリに手動で登録する必要があります。プロジェクト間の登録により、中央ゲートウェイはエージェントを特定して管理できます。手順については、別のプロジェクトからエージェントを登録するをご覧ください。
スタンドアロン スキルを統合する
Agent Registry を使用すると、エージェントのスタンドアロンのスキルを最上位のリソースとして管理できます。スタンドアロン スキルは、レジストリに Skill リソースとして登録されます。これにより、管理者はきめ細かいアクセス ポリシーを適用し、スキル リビジョンを使用してバージョン履歴を管理できます。
Gemini Enterprise でエージェントを構築して管理する際に、これらの登録済みスキルを参照して、エージェントの機能を拡張できます。スタンドアロン スキルを登録して管理する方法については、スキルを登録するとスキルを管理するをご覧ください。