Registering an agent in Agent Registry lets you turn an isolated component
into a discoverable part of your AI ecosystem. By publishing your agent's
[A2A skills](https://docs.cloud.google.com/agent-registry/skills-architecture.md.txt#standalone-vs-a2a), you help
other developers and orchestrator agents in your organization find and reuse
your work.

In this quickstart, you 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](https://docs.cloud.google.com/agent-registry/register-agents.md.txt).

## Before you begin

1. [Set up Agent Registry](https://docs.cloud.google.com/agent-registry/setup.md.txt).
2. For a single-project setup, get [the project ID](https://support.google.com/googleapi/answer/7014113) of the [governance project](https://docs.cloud.google.com/agent-registry/overview.md.txt#governance-project) where Agent Registry is enabled. If you configured a [management boundary](https://docs.cloud.google.com/agent-registry/boundaries-and-topology.md.txt) for multiple projects, use the ID of your management project for boundary-wide discovery and registration, or specify a member project ID for single-project operations.

### Required roles

<br />


To get the permissions that
you need to register agents in Agent Registry,

ask your administrator to grant you the
[Agent Registry API Editor](https://docs.cloud.google.com/iam/docs/roles-permissions/agentregistry.md.txt#agentregistry.editor) (`roles/agentregistry.editor`) IAM role on the [governance project](https://docs.cloud.google.com/agent-registry/overview.md.txt#governance-project)
where Agent Registry is enabled.


For more information about granting roles, see [Manage access to projects, folders, and organizations](https://docs.cloud.google.com/iam/docs/granting-changing-revoking-access.md.txt).


You might also be able to get
the required permissions through [custom
roles](https://docs.cloud.google.com/iam/docs/creating-custom-roles) or other [predefined
roles](https://docs.cloud.google.com/iam/docs/roles-overview#predefined).

## Register a mock agent

To try out Agent Registry, you can manually register a mock agent by pasting a
sample [Agent2Agent (A2A) Agent Card](https://agent2agent.info/docs/concepts/agentcard/).

Follow these steps to register the agent:

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


   [Go to Agent Registry](https://console.cloud.google.com/agent-platform/agent-registry)

   <br />

   If prompted, click **Enable** to enable the Agent Registry API.
2. From the project picker, select the Google Cloud project
   where you [set up Agent Registry](https://docs.cloud.google.com/agent-registry/setup.md.txt).

3. Select the **Agents** tab.

4. Click **Add agent**.

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

   - **Type** : select **A2A**.
   - **Region** : select `global` (Global).
6. Select the **Paste JSON** tab.

7. Paste the following sample Agent Card content:

   ```json
   {
     "supportedInterfaces": [
       {
         "url": "https://example.com/mock-travel-agent",
         "protocolBinding": "HTTP+JSON",
         "protocolVersion": "1.0.0"
       }
     ],
     "name": "mock-travel-agent",
     "description": "A mock agent that plans travel itineraries.",
     "version": "1.0.0",
     "capabilities": {
       "streaming": false,
       "pushNotifications": false
     },
     "defaultInputModes": ["text/plain"],
     "defaultOutputModes": ["text/plain"],
     "skills": [
       {
         "id": "BookFlight",
         "name": "BookFlight",
         "description": "Books a flight to a destination.",
         "tags": ["travel", "booking"]
       },
       {
         "id": "SearchHotels",
         "name": "SearchHotels",
         "description": "Searches for hotels in a destination city.",
         "tags": ["travel", "accommodation"]
       }
     ]
   }
   ```
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 the mock agent in the list.
2. Click the agent's name to view its details.
3. Verify that the `BookFlight` and `SearchHotels` A2A skills appear on the **Overview** tab.

## Clean up

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

1. On the **Agents** tab, locate the mock agent in the list.
2. Click the **More options** menu in the **Actions** column of the mock agent, and select **Delete**.
3. In the confirmation dialog, enter `DELETE` to confirm the action.
4. Click **Delete**.

## What's next

- Learn how to [manage registered agents](https://docs.cloud.google.com/agent-registry/manage-agents.md.txt).
- Learn about [automatic registration](https://docs.cloud.google.com/agent-registry/automatic-registration.md.txt), the recommended method to register agents deployed to managed runtimes.
- Read [Agent Registry key concepts](https://docs.cloud.google.com/agent-registry/concepts.md.txt).