Skip to content

Commit ee03650

Browse files
Merge branch 'main' of https://github.com/MicrosoftDocs/azure-docs-pr into us508796-03
2 parents a37b2a3 + 437b2c0 commit ee03650

2,241 files changed

Lines changed: 24999 additions & 49599 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

.openpublishing.redirection.json

Lines changed: 340 additions & 0 deletions
Large diffs are not rendered by default.

articles/active-directory-b2c/partner-deduce.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -31,7 +31,7 @@ With this integration, organizations can extend their Azure AD B2C capabilities
3131

3232
To get started, you'll need:
3333

34-
- An Azure subscription. If you don't have one, get a [free account](https://azure.microsoft.com/free).
34+
- An Azure subscription. If you don't have one, get a [free account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn).
3535

3636
- An [Azure AD B2C tenant](tutorial-create-tenant.md) that is linked to your Azure subscription.
3737

articles/active-directory-b2c/partner-eid-me.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -37,7 +37,7 @@ To get started, you need:
3737
* A Relying Party account with eID-Me
3838
* Go to bluink.ca to [learn more](https://bluink.ca/eid-me/solutions/id-verification#contact-form) and request a demo
3939
* An Azure subscription
40-
* If you don't have one, get an [Azure free account](https://azure.microsoft.com/free)
40+
* If you don't have one, get an [Azure free account](https://azure.microsoft.com/pricing/purchase-options/azure-account?cid=msft_learn)
4141
* An Azure AD B2C tenant linked to the Azure subscription
4242
* See, [Tutorial: Create an Azure AD B2C tenant](tutorial-create-tenant.md)
4343
* A trial or production version of the eID-Me Digital ID App

articles/api-center/TOC.yml

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -58,6 +58,12 @@
5858
href: export-to-copilot-studio.yml
5959
- name: Track API dependencies
6060
href: track-resource-dependencies.md
61+
- name: Agent-to-Agent
62+
items:
63+
- name: Overview
64+
href: agent-to-agent-overview.md
65+
- name: Register and manage agents
66+
href: register-manage-agents.md
6167
- name: MCP servers
6268
items:
6369
- name: Register and discover MCP servers
Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
title: Agent registry in Azure API Center
3+
description: "Overview of the agent registry for discovering, registering, and managing A2A agents in API Center."
4+
author: ProfessorKendrick
5+
ms.author: kkendrick
6+
ms.service: azure-api-center
7+
ms.topic: overview
8+
ms.date: 11/03/2025
9+
ms.update-cycle: 180-days
10+
ms.collection: ce-skilling-ai-copilot
11+
12+
#customer intent: As an API platform owner, I want to understand how to use the agent registry to discover, register, and manage AI agents.
13+
14+
---
15+
16+
# Agent registry in Azure API Center
17+
18+
Azure API Center provides a centralized platform for discovering, registering, and managing AI agents. It supports first-party and third-party agents, integrates with API Management for private endpoints, and stores customizable metadata to improve discoverability and governance.
19+
20+
## Key features
21+
22+
**Centralized Discovery and Management**: A single location to register and manage both first-party and third-party AI agents, including those exposed in API Management or hosted externally.
23+
24+
**Enhanced Discoverability**: Enables developers and other stakeholders to easily find and access approved AI agents through a curated catalog, either via the built-in API Center portal or a custom UI.
25+
26+
**Governance and Security**: Addresses shadow IT and uncontrolled AI tool adoption by providing a governed channel for accessing AI agents, improving security and compliance.
27+
28+
**Integration with API Management**: AI agents can be placed behind an API Management gateway for private endpoints, enhanced security, and controlled access.
29+
30+
**Customizable Metadata**: Organizations can define and store relevant metadata for each registered AI agent, facilitating filtering and searching.
31+
32+
## Register an AI agent
33+
34+
You can register AI agents in API Center similar to how you register other APIs. During registration, specify the API type as **A2A** and fill in details for **Agent Card**, **Agent Skills**, and **Agent Capabilities**.
35+
36+
For detailed steps, see [Register agent](register-manage-agents.md#register-agent).
37+
38+
## Manage your AI agent
39+
40+
After registering an A2A agent, you can update its metadata, add skills, configure capabilities, and manage provider information. Skills define the specific actions your agent can perform, making it discoverable and invokable by other agents.
41+
42+
For step-by-step instructions, see [Manage agents in Azure API Center](register-manage-agents.md).
43+
44+
## View dependency maps for A2A agents (preview)
45+
46+
API platform administrators can now create relationships feature using the dependency tracker feature. This capability allows API Center to identify the right agent to call and enable communication across agents in an enterprise.
47+
48+
For detailed steps, see [Track API resource dependencies in your API center](track-resource-dependencies.md).
26.3 KB
Loading

articles/api-center/register-discover-mcp-server.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ ms.topic: concept-article
77
ms.date: 09/08/2025
88
ms.author: danlep
99
ms.collection: ce-skilling-ai-copilot
10+
ms.update-cycle: 180-days
1011
# Customer intent: As an API program manager, I want to register and discover MCP servers as APIs in my API Center inventory.
1112
ms.custom:
1213
- build-2025
Lines changed: 128 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,128 @@
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)

articles/api-management/TOC.yml

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -248,7 +248,7 @@
248248
href: genai-gateway-capabilities.md
249249
- name: Manage LLM APIs
250250
items:
251-
- name: Import Azure AI Foundry API
251+
- name: Import Microsoft Foundry API
252252
href: azure-ai-foundry-api.md
253253
- name: Import Azure OpenAI API
254254
href: azure-openai-api-from-specification.md
@@ -714,6 +714,8 @@
714714
href: breaking-changes/identity-provider-adal-retirement-sep-2025.md
715715
- name: CAPTCHA endpoint update (September 2025)
716716
href: breaking-changes/captcha-endpoint-change-sep-2025.md
717+
- name: Trusted service connectivity retirement (March 2026)
718+
href: breaking-changes/trusted-service-connectivity-retirement-march-2026.md
717719
- name: Built-in analytics dashboard retirement (March 2027)
718720
href: breaking-changes/analytics-dashboard-retirement-march-2027.md
719721
- name: Regional availability

0 commit comments

Comments
 (0)