|
| 1 | +--- |
| 2 | +title: Register and Manage Agents in Azure API Center |
| 3 | +description: "Learn how to update agent metadata, add skills, configure capabilities, and manage provider information for A2A agents." |
| 4 | +author: ProfessorKendrick |
| 5 | +ms.author: kkendrick |
| 6 | +ms.service: azure-api-center |
| 7 | +ms.topic: how-to |
| 8 | +ms.date: 11/11/2025 |
| 9 | +ms.update-cycle: 180-days |
| 10 | +ms.collection: ce-skilling-ai-copilot |
| 11 | +--- |
| 12 | + |
| 13 | +# Register and manage agents in Azure API Center |
| 14 | + |
| 15 | +This article shows you how to register A2A agents in API Center, and how to update and manage them after registration. You can add skills, configure capabilities, and update provider information. |
| 16 | + |
| 17 | +## Prerequisites |
| 18 | + |
| 19 | +- An Azure API Center instance |
| 20 | +- An A2A agent described by an agent card |
| 21 | +- Appropriate permissions to edit APIs in your API Center |
| 22 | + |
| 23 | +## Register agent |
| 24 | + |
| 25 | +Enter required values from the agent's agent card. Optionally add skills and other metadata that define the capabilities and actions your A2A agent can perform. |
| 26 | + |
| 27 | +> [!TIP] |
| 28 | +> For detailed skill schema information, see the [Agent2Agent (A2A) Protocol Official Specification](https://a2a-protocol.org/latest/specification/). |
| 29 | +
|
| 30 | +1. Sign in to the [Azure portal](https://portal.azure.com), then navigate to your API center. |
| 31 | + |
| 32 | +1. In the sidebar menu, under **Assets**, select **APIs** > **+ Register an API**. |
| 33 | + |
| 34 | +1. In the **Register an API** page, fill in the [standard properties](tutorials/register-apis.md) to register an API and choose **A2A** as the agent type. |
| 35 | + |
| 36 | + - The form updates to display other fields specific to the **A2A** API type. |
| 37 | + |
| 38 | +1. In the **Agent Card** section, enter the following details: |
| 39 | + |
| 40 | + |Field |Description | |
| 41 | + |---------------------|-----------------------------------------------------------| |
| 42 | + |Protocol Version |The version of the A2A protocol this agent supports. | |
| 43 | + |Agent URL |The preferred endpoint URL for interacting with the agent. | |
| 44 | + |Preferred Transport |The transport protocol for the preferred endpoint. | |
| 45 | + |Agent Version |The agent's own version number. | |
| 46 | + |
| 47 | +1. Locate the **Agent Skills** section. |
| 48 | + |
| 49 | +1. Select **+ Add**. |
| 50 | + |
| 51 | +1. On the **Agent Skills** page, define the skill by providing information for the required fields. |
| 52 | + |
| 53 | +1. Select **Add** to add the skill. |
| 54 | + |
| 55 | +1. In the **Agent Provider** section, enter the following details: |
| 56 | + |
| 57 | + |Field |Description | |
| 58 | + |----------------------|-------------------------------------------------------------------------| |
| 59 | + |Organization name |The name of the agent provider's organization | |
| 60 | + |Organization URL |A URL for the agent provider's website or relevant documentation | |
| 61 | + |
| 62 | +1. Enable or disable the **Agent Capabilities** as needed: |
| 63 | + |
| 64 | + |Field |Description | |
| 65 | + |-------------------------|----------------------------------------------------------------------------------------| |
| 66 | + |Streaming Support |Indicates if the agent supports Server-Sent Events (SSE) for streaming responses | |
| 67 | + |Push Notifications |Indicates if the agent supports sending push notifications for asynchronous task updates| |
| 68 | + |State Transition History | Indicates if the agent provides a history of state transitions for a task | |
| 69 | + |
| 70 | +1. Select **Create** to register the API. |
| 71 | + |
| 72 | +## Update agent |
| 73 | + |
| 74 | +1. In the [Azure portal](https://azure.microsoft.com), go to your API center. |
| 75 | +1. In the sidebar menu, under **Assets**, select **APIs**. |
| 76 | +1. From the table, select your A2A agent by selecting the agent name in the **Title** column. |
| 77 | +1. Select the **Edit** button to open the **Edit** page in the working pane. |
| 78 | + |
| 79 | + :::image type="content" source="media/register-manage-agents/edit-agent.png" alt-text="Screenshot of the AI agent overview in Azure portal with the edit button highlighted."::: |
| 80 | + |
| 81 | +### Add skills to your agent |
| 82 | + |
| 83 | +Skills define the capabilities and actions your A2A agent can perform. |
| 84 | + |
| 85 | +> [!TIP] |
| 86 | +> For detailed skill schema information, see the [Agent2Agent (A2A) Protocol Official Specification](https://a2a-protocol.org/latest/specification/). |
| 87 | +
|
| 88 | +1. On the **Edit** page, locate the **Agent Skills** section. |
| 89 | +1. Select **+ Add**. |
| 90 | +1. On the **Agent Skills** page, define the skill by providing information for the required fields. |
| 91 | +1. Select **Add** to add the skill. |
| 92 | + |
| 93 | +### Add provider information |
| 94 | + |
| 95 | +Provider information helps other teams identify who maintains the agent. |
| 96 | + |
| 97 | +1. On the agent **Edit** page, locate the **Agent Provider** section. |
| 98 | +1. Enter the following details: |
| 99 | + |
| 100 | + |Field |Description | |
| 101 | + |----------------------|-------------------------------------------------------------------------| |
| 102 | + |Organization name |The name of the agent provider's organization | |
| 103 | + |Organization URL |A URL for the agent provider's website or relevant documentation | |
| 104 | + |
| 105 | +1. Select **Save**. |
| 106 | + |
| 107 | +### Configure agent capabilities |
| 108 | + |
| 109 | +Agent capabilities describe what features your A2A agent supports. |
| 110 | + |
| 111 | +1. On the **Edit** page, locate the **Agent Capabilities** section. |
| 112 | +1. Enable or disable the following capabilities as needed: |
| 113 | + |
| 114 | + |Field |Description | |
| 115 | + |-------------------------|----------------------------------------------------------------------------------------| |
| 116 | + |Streaming Support |Indicates if the agent supports Server-Sent Events (SSE) for streaming responses | |
| 117 | + |Push Notifications |Indicates if the agent supports sending push notifications for asynchronous task updates| |
| 118 | + |State Transition History | Indicates if the agent provides a history of state transitions for a task | |
| 119 | + |
| 120 | +1. Select **Save**. |
| 121 | + |
| 122 | +## Limitations |
| 123 | + |
| 124 | +Agent-to-Agent APIs in API Management don't synchronize with API Center. |
| 125 | + |
| 126 | +## Related content |
| 127 | + |
| 128 | +[Agent registry in Azure API Center](agent-to-agent-overview.md) |
0 commit comments