Merge pull request #299025 from dlepow/aisearch

[APIC] Semantic search

Author: denrea

articles/api-center/frequently-asked-questions.yml

@@ -50,7 +50,7 @@ sections:
           To upgrade your API center from the Free plan to the Standard plan, follow these steps:
 
           1. In the Azure portal, navigate to your API center.
-          2. In the left menu, select **Overview** > **Select plan**.
+          2. In the left menu, select **Overview** > **Manage plan**.
           3. Select **Standard plan**.
           4. Select **Submit**.
 

articles/api-center/includes/api-center-service-limits.md

@@ -7,7 +7,7 @@ author: dlepow
 
 ms.service: azure-api-center
 ms.topic: include
-ms.date: 03/18/2025
+ms.date: 03/ 18/2025
 ms.author: danlep
 ms.custom: Include file
 ---
@@ -27,6 +27,7 @@ ms.custom: Include file
 | Maximum number of analysis profiles | 1 | 3 |
 | Maximum number of linked API sources<sup>5</sup> | 1  |  3 |
 | Maximum number of APIs synchronized from a linked API source | 200 | 2,000<sup>4</sup>  |
+| Semantic search in API Center portal | No | Yes |
 
 <sup>1</sup> Free plan provided for 90 days, then service is soft-deleted. Use of full service features including API analysis is limited.<br/>
 <sup>2</sup> To increase a limit in the Standard plan, contact [support](https://azure.microsoft.com/support/options/).<br/>

articles/api-center/media/set-up-api-center-portal/semantic-search.png

@@ -1,12 +1,13 @@
 ---
-title: Set up the API Center portal
+title: Set Up the API Center Portal
 description: How to set up the API Center portal, a managed website that enables discovery of the API inventory in your Azure API center.
 author: dlepow
 ms.service: azure-api-center
 ms.topic: how-to
-ms.date: 04/28/2025
+ms.date: 04/30/2025
 ms.author: danlep 
 ms.custom: 
+ms.collection: ce-skilling-ai-copilot
 # Customer intent: As an API program manager, I want to enable an Azure-managed portal for developers and other API stakeholders in my organization to discover the APIs in my organization's API center.
 ---
 
@@ -62,7 +63,32 @@ To make only specific APIs visible, go to the **API visibility** tab in the API
 
 ## Enable access to test console for APIs
 
-You can configure user settings to granularly authorize access to APIs and their specific versions in your API center. For example, you can configure certain API versions to use API keys for authentication, and create an access policy that permits only specific users to authenticate using those keys. This policy also applies to the "Try this API" capability for APIs in the API Center portal, ensuring that only portal users with the appropriate access policy can use the test console for those API versions. [Learn more about authorizing access to APIs](authorize-api-access.md)
+You can configure user settings to granularly authorize access to APIs and their specific versions in your API center. For example, configure certain API versions to use API keys for authentication, and create an access policy that permits only specific users to authenticate using those keys. This policy also applies to the "Try this API" capability for APIs in the API Center portal, ensuring that only portal users with the appropriate access policy can use the test console for those API versions. [Learn more about authorizing access to APIs](authorize-api-access.md)
+
+## API discovery and consumption in the API Center portal
+
+The API Center portal supports and streamlines the work of developers who use and create APIs within your organization. Signed-in users can:
+
+* **Search for APIs** by name or using [AI-assisted semantic search](#search-with-ai) 
+
+* **Filter APIs** by type or lifecycle stage
+
+* **View API details and definitions** including endpoints, methods, parameters, and response formats
+
+* **Download API definitions** to a local computer or open them in Visual Studio Code
+
+* **Try out APIs** that support API key authentication or OAuth 2.0 authorization
+
+## Search with AI
+
+In the Standard plan of Azure API Center, the API Center portal supplements basic name-based API search with AI-assisted *semantic search* built on API names and descriptions. Users can search for APIs using natural language queries, making it easier to find APIs based on their intent. For example, if a developer searches for "I need an API for inventory management," the portal can suggest relevant APIs, even if their names or descriptions don't include those exact words.
+
+> [!TIP]
+> If you're using the Free plan of Azure API Center, you can [upgrade easily](frequently-asked-questions.yml#how-do-i-upgrade-my-api-center-from-the-free-plan-to-the-standard-plan) to the Standard plan to enable full service features including semantic search in the API Center portal.
+
+To use AI-assisted search when signed in to the API Center portal, click in the search box, select **Search with AI**, and enter a query.
+
+:::image type="content" source="media/set-up-api-center-portal/semantic-search.png" alt-text="Screenshot of semantic search results in API Center portal.":::
 
 [!INCLUDE [api-center-portal-compare-apim-dev-portal](includes/api-center-portal-compare-apim-dev-portal.md)]