このページでは、Agent Registry の問題を解決する方法について説明します。
API レートに基づく割り当てを超過した
この問題は、Agent Registry API を操作する場合や、Agent Registry をすばやく コンソールで移動する場合に発生することがあります。 Google Cloud
429 Too Many Requests
この問題を解決するには、API クライアントに指数バックオフを実装して、リクエスト レートを管理します。Agent Registry API のデフォルトの レート 割り当ては、グローバル とリージョンごとに 1 分あたり 1,200 リクエストです。
コンソールでタブを切り替えるときにスロットリングが発生した場合は、しばらく待ってからもう一度お試しください。 Google Cloud プログラムによるユースケースでより高い上限が必要な場合は、
割り当て増加をリクエスト
してください。対象の指標は RequestsPerMinute です。
手動登録時のペイロード サイズのエラー
この問題は、エージェントまたは MCP サーバーを手動で登録する場合に発生することがあります。API は、ペイロードが大きすぎるというエラーでリクエストを拒否します。
この問題を解決するには、agent-card.json ファイルまたは toolspec.json ファイルが 10 KB 未満であることを確認します。AgentSpec と McpServerSpec のコンテンツ サイズは 10 KB に制限されています。この上限を守るため、JSON ファイルを縮小し、不要な空白を削除するか、ツールの説明を簡潔にしてください。詳細については、
JSON スキーマをご覧ください。
作成後にエージェントまたは MCP サーバーが見つからない
この問題は、Google Workspace や
Gemini Enterprise などの
サポートされている Google Cloud プロダクトでエージェントまたは MCP サーバーを作成する場合に発生することがあります。
ListAgents または ListMcpServers API を呼び出しても、リソースが表示されません。
この問題を解決するには、バックグラウンド同期が完了するまで待ちます。リソースはリアルタイムで更新されますが、他の統合は定期的に実行されるオフライン バッチジョブによって入力されます。数時間経ってもリソースが表示されない場合は、プロジェクトのService Usageの設定を確認し、関連する API が有効になっていることを確認してください。
長時間実行オペレーションが停止しているように見える
この問題は、エージェントをデプロイする場合や、複雑なバインディングを構成する場合に発生することがあります。オペレーションに時間がかかり、停止しているように見えます。
この問題を解決するには、get_operation MCP ツールまたは google.longrunning.Operations.GetOperation API エンドポイントを使用して、オペレーションのステータスをポーリングします。一部のエージェントと MCP バックエンドの作成では、インフラストラクチャのプロビジョニングに時間がかかるため、長時間実行オペレーション（LRO）に最大 30 分かかることがあります。その結果、クライアントのタイムアウト設定を構成し、done ブール値フラグをポーリングして完了を確認します。
使用可能なバインディングの取得時に結果が空になる
この問題は、認証プロバイダの使用可能なバインディングを取得する場合に発生することがあります。バインディングが存在することを確認しても、API は empty array またはアクセス エラーを返します。
この問題を解決するには、プリンシパルにターゲット AuthProvider リソースに対する正しい IAM 権限があることを確認します。API は厳格な IAM チェックを適用し、呼び出し元がアクセスできない認証プロバイダを参照する Binding オブジェクトを削除します。プリンシパルに認証プロバイダに対する必要なアクセス権と、プロジェクトに対する roles/agentregistry.viewer ロールがあることを確認してください。