Skip to content

Commit ea586b9

Browse files
author
gitName
committed
PR review
2 parents 847f2e7 + 2b6f73b commit ea586b9

File tree

505 files changed

+12327
-29894
lines changed

Some content is hidden

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

505 files changed

+12327
-29894
lines changed

.openpublishing.redirection.json

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6875,9 +6875,14 @@
68756875
"redirect_document_id": false
68766876
},
68776877
{
6878-
"source_path": "articles/storage/files/storage-files-enable-soft-delete.md",
6878+
"source_path": "articles/storage/files/storage-files-enable-soft-delete.md",
68796879
"redirect_url": "/azure/storage/files/storage-files-prevent-file-share-deletion",
68806880
"redirect_document_id": false
6881+
},
6882+
{
6883+
"source_path": "articles/defender-for-iot/organizations/release-notes-archive.md",
6884+
"redirect_url": "/azure/defender-for-iot/organizations/release-notes-ot-monitoring-sensor-archive",
6885+
"redirect_document_id": false
68816886
}
68826887
]
68836888
}

articles/api-center/TOC.yml

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -52,6 +52,8 @@
5252
href: register-apis-github-actions.md
5353
- name: Register and discover MCP servers
5454
href: register-discover-mcp-server.md
55+
- name: Export API from API Center to Copilot Studio
56+
href: export-to-copilot-studio.yml
5557
- name: API governance
5658
items:
5759
- name: Use metadata for governance
Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
### YamlMime:HowTo
2+
3+
metadata:
4+
title: Export API from API Center as Copilot Studio connector
5+
description: Learn how to export an API definition from your Azure API center as a custom connector in Microsoft Copilot Studio.
6+
author: dlepow
7+
ms.author: danlep
8+
ms.service: azure-api-management
9+
ms.topic: how-to
10+
ms.date: 04/28/2025
11+
ms.custom: template-how-to
12+
13+
#customer intent: As an API program manager, I want to export an API from my API center inventory as a connector in Microsoft Copilot Studio for use in agents.
14+
title: |
15+
Export API definition from API Center to Copilot Studio as a connector
16+
17+
introduction: |
18+
You can export an API definition from your Azure API center as a [connector in Microsoft Copilot Studio](/connectors/overview) (preview). Copilot Studio is a graphical, low-code tool for building agents and agent flows and is part of the Microsoft Power Platform family.
19+
20+
In Microsoft Copilot Studio, citizen developers can use the exported connector as a custom connector to [extend the capabilities of AI agents](/microsoft-copilot-studio/copilot-connectors-in-copilot-studio).
21+
22+
In this article, you create a custom connector from an OpenAPI definition associated with an API in an API center.
23+
24+
prerequisites:
25+
summary: |
26+
27+
dependencies:
28+
- An API center instance. You can [create one](set-up-api-center.md) in the Azure portal.
29+
- An API registered in the API center inventory. The API must have a version associated with a [deployment](configure-environments-deployments.md), and it must have an API definition in OpenAPI 2.0 format.
30+
- A Power Platform [environment](/power-apps/powerapps-overview#power-apps-for-admins).
31+
- A Microsoft Copilot Studio [license](/microsoft-copilot-studio/requirements-licensing-subscriptions).
32+
33+
procedureSection:
34+
- title: |
35+
Export API definition from API Center
36+
summary: |
37+
Follow these steps to export an API definition from your Azure API center as a custom connector in Microsoft Copilot Studio.
38+
39+
steps:
40+
- |
41+
Navigate to your API center in the Azure portal.
42+
- |
43+
In the left menu, select **Copilot Studio (preview)**.
44+
- |
45+
Select **Create a connector**. The **Create a connector** window opens.
46+
- |
47+
Select a **Power Platform environment** to export the API to.
48+
- |
49+
Enter a **Connector display name**.
50+
- |
51+
Select the **API**, **API version**, and **Deployment** for the connector. The **Host** URL is populated with the deployment's runtime URL.
52+
- |
53+
Select the **API definition** to use for the connector.
54+
- |
55+
Optionally, if you configured [API access settings](https://aka.ms/apicenter/docs/access) for the API version in your API center, select an available **Security requirement** type to use for the connector.
56+
- |
57+
Select **Create**.
58+
59+
:::image type="content" source="media/export-to-copilot-studio/copilot-studio-menu-item.png" alt-text="Screenshot of creating a Copilot Studio connector in the portal.":::
60+
61+
62+
The connector is now available for use in Microsoft Copilot Studio.
63+
64+
After creating the connector:
65+
66+
- You can [test the connector](/connectors/custom-connectors/define-openapi-definition#test-the-connector) in Power Automate or Power Apps.
67+
68+
- After testing, use the connector in [Microsoft Copilot Studio](/microsoft-copilot-studio/) to create applications and workflows.
69+
70+
relatedContent:
71+
72+
- text: Create a custom connector from an OpenAPI definition
73+
url: /connectors/custom-connectors/define-openapi-definition
74+
75+
- text: Learn more about building AI-driven agents with Microsoft Copilot Studio
76+
url: /microsoft-copilot-studio/nlu-gpt-overview
77+
78+
- text: Get started with Microsoft Copilot Studio
79+
url: /training/modules/power-virtual-agents-bots
84.1 KB
Loading
-11.3 KB
Loading

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ MCP utilizes a client-host-server architecture built on [JSON-RPC 2.0 for messag
4747

4848
## MCP servers in your API inventory
4949

50-
The following sections describe how to inventory and discover an MCP server in your API Center. You can register remote or local MCP servers.
50+
The following sections describe how to inventory and discover a remote MCP server in your API Center.
5151

5252
### MCP API type
5353

@@ -88,7 +88,7 @@ You can use the following lightweight OpenAPI 3.0 API definition for your MCP se
8888

8989
### Discover MCP servers using API Center portal
9090

91-
Set up the [API Center portal](set-up-api-center-portal.md) so that developers and other stakeholders in your organization can discover MCP servers in your API inventory. Users can browse and filter MCP servers in the inventory and view details such as a the URL endpoint of the MCP server, if available in the MCP server's API definition.
91+
Set up the [API Center portal](set-up-api-center-portal.md) so that developers and other stakeholders in your organization can discover MCP servers in your API inventory. Users can browse and filter MCP servers in the inventory and view details such as the URL endpoint of the MCP server, if available in the MCP server's API definition.
9292

9393
:::image type="content" source="media/register-discover-mcp-server/mcp-server-portal-small.png" lightbox="media/register-discover-mcp-server/mcp-server-portal.png" alt-text="Screenshot of MCP server in API Center portal.":::
9494

articles/api-management/api-management-howto-developer-portal-customize.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: dlepow
66

77
ms.service: azure-api-management
88
ms.topic: tutorial
9-
ms.date: 03/29/2024
9+
ms.date: 04/28/2025
1010
ms.author: danlep
1111
ms.custom: engagement-fy23
1212
---
@@ -28,7 +28,7 @@ In this tutorial, you learn how to:
2828
2929
For more information about developer portal features and options, see [Azure API Management developer portal overview](developer-portal-overview.md).
3030

31-
:::image type="content" source="media/api-management-howto-developer-portal-customize/cover.png" alt-text="Screenshot of the API Management developer portal - administrator mode." border="false":::
31+
:::image type="content" source="media/api-management-howto-developer-portal-customize/cover.png" alt-text="Screenshot of the API Management developer portal - administrator mode." :::
3232

3333
## Prerequisites
3434

@@ -49,6 +49,8 @@ Follow these steps to access the managed version of the developer portal.
4949
It might take a few minutes to enable the developer portal.
5050
1. In the left menu, under **Developer portal**, select **Portal overview**. Then select the **Developer portal** button in the top navigation bar. A new browser tab with an administrative version of the portal will open.
5151

52+
[!INCLUDE [developer-portal-editor-refresh](../../includes/developer-portal-editor-refresh.md)]
53+
5254
## Understand the portal's administrative interface
5355

5456
[!INCLUDE [api-management-developer-portal-editor](../../includes/api-management-developer-portal-editor.md)]
@@ -70,7 +72,7 @@ You'll want to use your own images and other media content in the developer port
7072

7173
A placeholder logo is provided in the top left corner of the navigation bar. You can replace it with your own logo to match your organization's branding.
7274

73-
1. In the developer portal, select the default **Contoso** logo in the top left of the navigation bar.
75+
1. In the developer portal, select the default logo in the top left of the navigation bar.
7476
1. Select **Edit**.
7577
1. In the **Picture** pop-up, under **Main**, select **Source**.
7678
1. In the **Media** pop-up, select one of the following:

articles/api-management/api-management-region-availability.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ author: dlepow
66

77
ms.service: azure-api-management
88
ms.topic: concept-article
9-
ms.date: 11/20/2024
9+
ms.date: 04/29/2025
1010
ms.author: danlep
1111
ms.custom: references_regions
1212
---
@@ -47,10 +47,11 @@ Information in the following table is updated regularly. Capacity availability i
4747
| Switzerland North ||| | |
4848
| UK South |||||
4949
| UK West ||| | |
50-
| West Europe ||| | |
50+
| West Europe ||| | ✅<sup>1</sup> |
5151
| West US ||| ||
5252
| West US 2 ||| | |
5353

54+
<sup>1</sup> Request access to this region by emailing `[email protected]`
5455

5556
## Related content
5657

articles/api-management/developer-portal-overview.md

Lines changed: 6 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ author: dlepow
77

88
ms.service: azure-api-management
99
ms.topic: concept-article
10-
ms.date: 03/29/2024
10+
ms.date: 04/28/2025
1111
ms.author: danlep
1212
---
1313

@@ -76,21 +76,18 @@ The developer portal's administrative interface provides a visual editor for pub
7676

7777
[!INCLUDE [api-management-developer-portal-add](../../includes/api-management-developer-portal-add.md)]
7878

79-
[!INCLUDE [api-management-developer-portal-wordpress](../../includes/api-management-developer-portal-wordpress.md)]
79+
### Pages and layouts
8080

81+
The pre-provisioned content in the developer portal showcases pages with commonly used features. Find them on the **Pages** panel. You can modify the content of these pages or add new ones to suit your needs.
8182

82-
### Layouts and pages
83-
84-
Layouts define how pages are displayed. For example, in the default content, there are two layouts: one applies to the home page, and the other to all remaining pages. You can modify these layouts and add more layouts to suit your needs.
83+
Select **Layouts** on the **Pages** panel to define how pages are displayed. The developer portal comes with a default layout that's applied to the pages. You can modify this layout and add more layouts to suit your needs.
8584

8685
A layout gets applied to a page by matching its URL template to the page's URL. For example, a layout with a URL template of `/wiki/*` is applied to every page with the `/wiki/` segment in the URL: `/wiki/getting-started`, `/wiki/styles`, etc.
8786

8887
In the following image, content belonging to the layout is outlined in blue, while the page-specific content is outlined in red.
8988

9089
:::image type="content" source="media/developer-portal-overview/pages-layouts.png" alt-text="Screenshot of layout content in the developer portal." :::
9190

92-
The pre-provisioned content in the developer portal showcases pages with commonly used features. You can modify the content of these pages or add new ones to suit your needs.
93-
9491
> [!NOTE]
9592
> Due to integration considerations, the following pages can't be removed or moved under a different URL: `/404`, `/500`, `/captcha`, `/change-password`, `/config.json`, `/confirm/invitation`, `/confirm-v2/identities/basic/signup`, `/confirm-v2/password`, `/internal-status-0123456789abcdef`, `/publish`, `/signin`, `/signin-sso`, `/signup`.
9693
@@ -248,7 +245,8 @@ To restore a previous portal revision:
248245
If you want to discard all changes you've made to the developer portal, you can reset the website to its starting state. Resetting the portal deletes any changes you've made to the developer portal pages, layouts, customizations, and uploaded media.
249246

250247
> [!NOTE]
251-
> Resetting the developer portal doesn't delete the published version of the developer portal.
248+
> * Resetting the developer portal doesn't delete the published version of the developer portal.
249+
> * Resetting the portal could update the portal to a newer version of the developer portal codebase with updated components. The placeholder content that appears might also be changed. Developer portal features and customization options remain consistent.
252250
253251
To reset the developer portal:
254252

300 KB
Loading

0 commit comments

Comments
 (0)