Quickstart: Register an agent

Registering an agent transforms it from an isolated workload into a discoverable component within Agent Registry. By publishing your agent's skills, you let other developers and orchestrator agents in your organization find and reuse your work, accelerating AI development.

This quickstart shows you how to manually register a mock agent in Agent Registry using the Google Cloud console. For more information about agent registration mechanisms in Agent Registry, see Register agents.

Before you begin

Before you start, set up Agent Registry. You need the project ID to perform these tasks.

Required roles

To get the permissions that you need to register agents in Agent Registry, ask your administrator to grant you the Agent Registry API Editor (roles/agentregistry.editor) IAM role on the project. For more information about granting roles, see Manage access to projects, folders, and organizations.

You might also be able to get the required permissions through custom roles or other predefined roles.

Register a mock agent

To try out Agent Registry, you can manually register a mock agent by pasting a sample Agent2Agent (A2A) Agent Card.

Follow these steps to register the agent:

  1. In the Google Cloud console, go to Agent Registry:

    Go to Agent Registry

  2. From the project picker, select the Google Cloud project where you set up Agent Registry.

  3. Select the Agents tab.

  4. Click Add agent.

  5. In the Agent details panel, enter the following details:

    • Display name: Mock Travel Agent
    • Description: A mock agent that plans travel itineraries.
    • Location: Select global.
    • Agent type: Select A2A.

  6. In the Agent specification section, select the Paste JSON tab.

  7. Copy and paste the following sample Agent Card content:

    {
  "schemaVersion": "0.3",
  "agent": {
    "name": "mock-travel-agent",
    "description": "A mock agent that plans travel itineraries.",
    "skills": [
      {
        "name": "BookFlight",
        "description": "Books a flight to a destination."
      },
      {
        "name": "SearchHotels",
        "description": "Searches for hotels in a destination city."
      }
    ]
  }
}

  8. Click Save.

Agent Registry processes the agent card and registers the agent.

Verify the registration

To confirm that your mock agent was registered successfully, do the following:

  1. On the Agents tab, locate Mock Travel Agent in the list.
  2. Click Mock Travel Agent to view its details.
  3. Verify that the BookFlight and SearchHotels skills display on the Overview tab.

Clean up

To avoid leaving mock resources in your project, delete the registered agent:

  1. On the Agents tab, locate Mock Travel Agent in the list.
  2. Click the More options menu next to Mock Travel Agent, and select Delete.
  3. In the confirmation dialog, click Delete.

What's next