Documentation / Answers / Troubleshoot Google Agent Registry

Troubleshoot Google Agent Registry

Last reviewed 2026-11-15.

Short answer. Check connection can show "This project ID is saved" on Project ID while Locations says "Google can't find a project with that ID." That Locations failure is CONSUMER_INVALID, and it happens when the project name was pasted instead of the project ID, or when the ID is wrong or deleted. If the Agent Registry API is not enabled, the check says to enable agentregistry.googleapis.com, or it includes SERVICE_DISABLED and the words Agent Registry API is disabled. Agents appear on Agents & allocation after the daily run at 06:45 UTC. Owners stay blank until you assign them on Agents & allocation.

Setup is Connect Google Agent Registry. The card is Settings, Google Agent Registry.

CONSUMER_INVALID

What you see. Check connection fails. The Project ID row can say "This project ID is saved." The Locations row says "Google can't find a project with that ID." Google's reason on that check is CONSUMER_INVALID.

Why. Google does not recognize that value as a project ID. Pasting the project name instead of the project ID causes this. A wrong ID, or a project that was deleted, causes the same sentence.

How to fix. The field is labeled Project ID (not the name). Paste the short lowercase ID from the IAM page. The name in the console header is different. Choose Check connection again.

Agent Registry API is not enabled

What you see. The check says "Enable agentregistry.googleapis.com on this project, then run the check again." Or the same row includes SERVICE_DISABLED and "Agent Registry API is disabled." A disabled API can also mention the custom role in that same row, because Google returned a permission error.

Why. agentregistry.googleapis.com is not enabled on the governance project.

How to fix. Enable agentregistry.googleapis.com on that project, then choose Check connection again. The command is in Connect Google Agent Registry. If the row tells you to grant the role and it does not say the API is disabled, the API is on and the service account is missing the role. Grant the custom role, or roles/agentregistry.viewer, to the service account email on the card.

Agents are not listed yet

What you see. Check connection passes, Preview lists agents, and Agents & allocation does not show them yet.

Why. Preview writes nothing. Check connection saves the project and does not post the agents. The daily job posts them. It runs at 06:45 UTC. A project connected after that waits until the next run.

How to fix. Wait for the next 06:45 UTC run. Stop import skips the project on that run. Resume import checks the project and starts the daily read again when the check passes.

Owners are blank

What you see. The Owner column on Agents & allocation is blank for these agents.

Why. Google brings agents only. The import does not set an owner. A blank owner is shown as a dash. That is expected.

How to fix. On Agents & allocation, choose Edit on the agent and pick a person under Owner. The person has to be on Team first.