You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/ai-foundry/agents/concepts/threads-runs-messages.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -26,7 +26,7 @@ When you use an Agent, there are a series of steps that are involved.
26
26
-**Check the run status:** Monitor the run until it has completed.
27
27
-**Getting the response:** After the agent has created a response, display it to the user.
28
28
29
-
:::image type="content" source="..\media\run-thread-model.png" alt-text="A diagram showing an example of an agent run." lightbox="..\media\run-thread-model.png":::
29
+
:::image type="content" source="../media\run-thread-model.png" alt-text="A diagram showing an example of an agent run." lightbox="../media\run-thread-model.png":::
30
30
31
31
## Agent
32
32
@@ -46,4 +46,4 @@ A run involves invoking the agent on the thread, where it processes the messages
Copy file name to clipboardExpand all lines: articles/ai-foundry/agents/how-to/connected-agents.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -85,7 +85,7 @@ Checks the contract against internal standards or uploaded guidelines to identif
85
85
2. Select an existing agent from the list or create a new one.
86
86
3. Scroll down to the **Connected agents** section in the agent's setup panel and select **Add +**.
87
87
88
-
:::image type="content" source="..\media\connected-agents\connected-agents-foundry.png" alt-text="A screenshot of the agents page in the Azure AI Foundry." lightbox="..\media\connected-agents\connected-agents-foundry.png":::
88
+
:::image type="content" source="../media\connected-agents\connected-agents-foundry.png" alt-text="A screenshot of the agents page in the Azure AI Foundry." lightbox="../media\connected-agents\connected-agents-foundry.png":::
89
89
90
90
4. In the dialog that appears, choose an agent for the main agent to delegate tasks to, and describe:
91
91
- Select an **existing agent** from the dropdown. This is the connected agent that the main agent will delegate tasks to.
@@ -100,7 +100,7 @@ Checks the contract against internal standards or uploaded guidelines to identif
100
100
101
101
The `research_agent` should delegate this request to `stock_price_bot` based on the routing description you defined.
102
102
103
-
:::image type="content" source="..\media\connected-agents\connected-agents-foundry-2.png" alt-text="A screenshot of the connected agents screen" lightbox="..\media\connected-agents\connected-agents-foundry-2.png":::
103
+
:::image type="content" source="../media\connected-agents\connected-agents-foundry-2.png" alt-text="A screenshot of the connected agents screen" lightbox="../media\connected-agents\connected-agents-foundry-2.png":::
Copy file name to clipboardExpand all lines: articles/ai-foundry/agents/how-to/tools/azure-ai-search.md
+11-11Lines changed: 11 additions & 11 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -44,7 +44,7 @@ You can specify the search type for your index by choosing one of the following
44
44
45
45
### Prerequisite: Have an existing Azure AI Search index
46
46
A prerequisite of using the Azure AI Search tool is to have an existing Azure AI Search index. If you don't have an existing index, you can create one in the Azure portal using the import and vectorize data wizard.
47
-
-[Quickstart: Create a vector index with the import and vectorize data wizard in the Azure portal](..\..\..\..\search\search-get-started-portal-import-vectors.md)
47
+
-[Quickstart: Create a vector index with the import and vectorize data wizard in the Azure portal](../../../../search\search-get-started-portal-import-vectors.md)
48
48
49
49
### Create a project connection to the Azure AI Search resource with the index you want to use
50
50
Once you have completed the agent setup, you must create a project connection to the Azure AI Search resource that contains the index you want to use.
@@ -56,13 +56,13 @@ If you already connected the AI Search resource that contains the index you want
56
56
- In the Azure portal, navigate to the AI Search resource that contains the index you want to use.
57
57
2. Copy the connection endpoint.
58
58
- In the Overview tab, copy the URL of your resource. The URL should be in the format `https://<your-resource-name>.search.windows.net/`.
59
-
:::image type="content" source="..\..\media\tools\ai-search\connection-endpoint.png" alt-text="A screenshot of an AI Search resource Overview tab in the Azure portal." lightbox="..\..\media\tools\ai-search\connection-endpoint.png":::
59
+
:::image type="content" source="../../media\tools\ai-search\connection-endpoint.png" alt-text="A screenshot of an AI Search resource Overview tab in the Azure portal." lightbox="../../media\tools\ai-search\connection-endpoint.png":::
60
60
61
61
3. Verify API Access control is set to **Both** and copy one of the keys under **Manage admin keys**.
62
62
- From the left-hand navigation bar, scroll down to the Settings section and select **Keys**.
63
63
- Under the **API Access Control** section, ensure the option **Both** API key and Role-based access control is selected.
64
64
- If you want the connection to use API Keys for authentication, copy one of the keys under **Manage admin keys**.
65
-
:::image type="content" source="..\..\media\tools\ai-search\azure-portal.png" alt-text="A screenshot of an AI Search resource Keys tab in the Azure portal." lightbox="..\..\media\tools\ai-search\azure-portal.png":::
65
+
:::image type="content" source="../../media\tools\ai-search\azure-portal.png" alt-text="A screenshot of an AI Search resource Keys tab in the Azure portal." lightbox="../../media\tools\ai-search\azure-portal.png":::
66
66
67
67
#### Create an Azure AI Search project connection
68
68
If you use Microsoft Entra ID for the connection authentication type, you need to manually assign the project managed identity the roles Search Index Data Contributor and Search Service Contributor to the Azure AI Search resource. The connection **name** must be the AI Search **index** name.
@@ -72,7 +72,7 @@ If you use Microsoft Entra ID for the connection authentication type, you need t
72
72
**Create the following connections.yml file**
73
73
74
74
75
-
You can use either an API key or credential-less YAML configuration file. Replace the placeholders for ```name```, ```endpoint``` and ```api_key``` with your Azure AI Search resource values. For more information on the YAML configuration file, see the [Azure AI Search connection YAML schema](..\..\..\..\machine-learning\reference-yaml-connection-ai-search.md).
75
+
You can use either an API key or credential-less YAML configuration file. Replace the placeholders for ```name```, ```endpoint``` and ```api_key``` with your Azure AI Search resource values. For more information on the YAML configuration file, see the [Azure AI Search connection YAML schema](../../../../machine-learning\reference-yaml-connection-ai-search.md).
1. In Azure AI Foundry, navigate to the project you created in the agent setup. Click on **Open in management center**.
118
-
:::image type="content" source="..\..\media\tools\ai-search\project-studio.png" alt-text="A screenshot of a project in Azure AI Foundry." lightbox="..\..\media\tools\ai-search\project-studio.png":::
118
+
:::image type="content" source="../../media\tools\ai-search\project-studio.png" alt-text="A screenshot of a project in Azure AI Foundry." lightbox="../../media\tools\ai-search\project-studio.png":::
119
119
120
120
2. Click on the **Connections** tab and select **Add Connection**.
121
-
:::image type="content" source="..\..\media\tools\ai-search\project-connections-page.png" alt-text="A screenshot of the project connections page." lightbox="..\..\media\tools\ai-search\project-connections-page.png":::
121
+
:::image type="content" source="../../media\tools\ai-search\project-connections-page.png" alt-text="A screenshot of the project connections page." lightbox="../../media\tools\ai-search\project-connections-page.png":::
122
122
123
123
3. Select **Azure AI Search**.
124
-
:::image type="content" source="..\..\media\tools\ai-search\select.png" alt-text="A screenshot of the Azure AI Search connection type the user should select." lightbox="..\..\media\tools\ai-search\select.png":::
124
+
:::image type="content" source="../../media\tools\ai-search\select.png" alt-text="A screenshot of the Azure AI Search connection type the user should select." lightbox="../../media\tools\ai-search\select.png":::
125
125
126
126
4. Provide the required connection details for the Azure AI Search resource you want to use. Both Managed Identity and Key-based authentication are supported. Once all the fields are filled in, click **Add connection**.
127
-
:::image type="content" source="..\..\media\tools\ai-search\connection-2.png" alt-text="A screenshot the required fields to add a new Azure AI Search connection." lightbox="..\..\media\tools\ai-search\connection-2.png":::
127
+
:::image type="content" source="../../media\tools\ai-search\connection-2.png" alt-text="A screenshot the required fields to add a new Azure AI Search connection." lightbox="../../media\tools\ai-search\connection-2.png":::
128
128
129
129
5. Verify that the connection was successfully created and now appears in the project's Connections tab.
130
-
:::image type="content" source="..\..\media\tools\ai-search\success-connection.png" alt-text="A screenshot of the project connections page with a new Azure AI Search connection added." lightbox="..\..\media\tools\ai-search\success-connection.png":::
130
+
:::image type="content" source="../../media\tools\ai-search\success-connection.png" alt-text="A screenshot of the project connections page with a new Azure AI Search connection added." lightbox="../../media\tools\ai-search\success-connection.png":::
131
131
---
132
132
133
133
Now that you have created a project connection to your Azure AI Search resource, you can configure and start using the Azure AI Search tool with the SDK. See the code examples tab to get started.
@@ -139,11 +139,11 @@ You can add the Azure AI Search tool to an agent programmatically using the code
139
139
140
140
1. In the **Agents** screen for your agent, scroll down the **Setup** pane on the right to **knowledge**. Then select **Add**.
141
141
142
-
:::image type="content" source="..\..\media\tools\knowledge-tools.png" alt-text="A screenshot showing the available tool categories in the Azure AI Foundry portal." lightbox="..\..\media\tools\knowledge-tools.png":::
142
+
:::image type="content" source="../../media\tools\knowledge-tools.png" alt-text="A screenshot showing the available tool categories in the Azure AI Foundry portal." lightbox="../../media\tools\knowledge-tools.png":::
143
143
144
144
1. Select **Azure AI Search** and follow the prompts to add the tool.
145
145
146
-
:::image type="content" source="..\..\media\tools\knowledge-tools-list.png" alt-text="A screenshot showing the available knowledge tools in the Azure AI Foundry portal." lightbox="..\..\media\tools\knowledge-tools-list.png":::
146
+
:::image type="content" source="../../media\tools\knowledge-tools-list.png" alt-text="A screenshot showing the available knowledge tools in the Azure AI Foundry portal." lightbox="../../media\tools\knowledge-tools-list.png":::
Copy file name to clipboardExpand all lines: articles/ai-foundry/agents/how-to/tools/bing-code-samples.md
+4-4Lines changed: 4 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,19 +29,19 @@ Use this article to find step-by-step instructions and code samples for Groundin
29
29
30
30
1. In the [Azure AI Foundry portal](https://ai.azure.com/?cid=learnDocs) navigate to the **Agents** screen for your agent, scroll down the **Setup** pane on the right to **knowledge**. Then select **Add**.
31
31
32
-
:::image type="content" source="..\..\media\tools\knowledge-tools.png" alt-text="A screenshot showing the available tool categories in the Azure AI Foundry portal." lightbox="..\..\media\tools\knowledge-tools.png":::
32
+
:::image type="content" source="../../media\tools\knowledge-tools.png" alt-text="A screenshot showing the available tool categories in the Azure AI Foundry portal." lightbox="../../media\tools\knowledge-tools.png":::
33
33
34
34
1. Select **Grounding with Bing Search** and follow the prompts to add the tool. Note you can add only one per agent.
35
35
36
-
:::image type="content" source="..\..\media\tools\knowledge-tools-list.png" alt-text="A screenshot showing the available knowledge tools in the Azure AI Foundry portal." lightbox="..\..\media\tools\knowledge-tools-list.png":::
36
+
:::image type="content" source="../../media\tools\knowledge-tools-list.png" alt-text="A screenshot showing the available knowledge tools in the Azure AI Foundry portal." lightbox="../../media\tools\knowledge-tools-list.png":::
37
37
38
38
1. Click to add new connections. Once you have added a connection, you can directly select from existing list.
39
39
40
-
:::image type="content" source="..\..\media\tools\bing\choose-bing-connection.png" alt-text="A screenshot showing the button for creating a new connection." lightbox="..\..\media\tools\bing\choose-bing-connection.png":::
40
+
:::image type="content" source="../../media\tools\bing\choose-bing-connection.png" alt-text="A screenshot showing the button for creating a new connection." lightbox="../../media\tools\bing\choose-bing-connection.png":::
41
41
42
42
1. Select the Grounding with Bing Search resource you want to use and click to add connection.
43
43
44
-
:::image type="content" source="..\..\media\tools\bing\create-bing-connection.png" alt-text="A screenshot showing available Grounding with Bing Search connections." lightbox="..\..\media\tools\bing\create-bing-connection.png":::
44
+
:::image type="content" source="../../media\tools\bing\create-bing-connection.png" alt-text="A screenshot showing available Grounding with Bing Search connections." lightbox="../../media\tools\bing\create-bing-connection.png":::
Copy file name to clipboardExpand all lines: articles/ai-foundry/agents/how-to/tools/bing-custom-search.md
+2-2Lines changed: 2 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -46,7 +46,7 @@ Developers and end users don't have access to raw content returned from Groundin
46
46
> [!NOTE]
47
47
> You can only use Azure OpenAI models with Grounding with Bing Custom Search.
48
48
49
-
1. Create an Azure AI Agent by following the steps in the [quickstart](..\..\quickstart.md).
49
+
1. Create an Azure AI Agent by following the steps in the [quickstart](../../quickstart.md).
50
50
51
51
1. Create a Grounding with Bing Custom Search resource in the [Azure portal](https://portal.azure.com/#create/Microsoft.BingGroundingCustomSearch). You need to have owner or contributor role in your subscription or resource group to create it. Make sure you create this Grounding with Bing Custom Search resource in the same resource group as your Azure AI Agent, AI Project, and other resources.
52
52
@@ -85,7 +85,7 @@ When you create or update a configuration, enter the following information:
85
85
86
86
1. Navigate to the **Agents** screen for your agent in the [Azure AI Foundry portal](https://ai.azure.com/?cid=learnDocs), scroll down the Setup pane on the right to **knowledge**. Then select **Add**.
87
87
88
-
:::image type="content" source="..\..\media\tools\knowledge-tools.png" alt-text="A screenshot of the agents screen in the AI Foundry portal.":::
88
+
:::image type="content" source="../../media\tools\knowledge-tools.png" alt-text="A screenshot of the agents screen in the AI Foundry portal.":::
89
89
90
90
1. Select the **Grounding with Bing Custom Search** tool.
Copy file name to clipboardExpand all lines: articles/ai-foundry/agents/how-to/tools/bing-grounding.md
+5-5Lines changed: 5 additions & 5 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -53,15 +53,15 @@ The authorization will happen between Grounding with Bing Search service and Azu
53
53
## Setup
54
54
55
55
> [!NOTE]
56
-
> 1. Grounding with Bing Search works with [all Azure OpenAI models](..\..\concepts\model-region-support.md) that Azure AI Foundry Agent Service supports, except `gpt-4o-mini, 2024-07-18`.
56
+
> 1. Grounding with Bing Search works with [all Azure OpenAI models](../../concepts\model-region-support.md) that Azure AI Foundry Agent Service supports, except `gpt-4o-mini, 2024-07-18`.
57
57
58
-
1. Create an Azure AI Agent by following the steps in the [quickstart](..\..\quickstart.md).
58
+
1. Create an Azure AI Agent by following the steps in the [quickstart](../../quickstart.md).
59
59
60
60
1. Create a Grounding with Bing Search resource. You need to have `owner` or `contributor` role in your subscription or resource group to create it.
61
61
62
62
1. You can create one in the [Azure portal](https://portal.azure.com/#create/Microsoft.BingGroundingSearch), and select the different fields in the creation form. Make sure you create this Grounding with Bing Search resource in the same resource group as your Azure AI Agent, AI Project, and other resources.
63
63
64
-
:::image type="content" source="..\..\media\tools\bing\resource-selection.png" alt-text="A screenshot of the Bing resource selection in the Azure portal." lightbox="..\..\media\tools\bing\resource-selection.png":::
64
+
:::image type="content" source="../../media\tools\bing\resource-selection.png" alt-text="A screenshot of the Bing resource selection in the Azure portal." lightbox="../../media\tools\bing\resource-selection.png":::
65
65
66
66
1. You can also create one through code-first experience. If so, you need to manually [register](/azure/azure-resource-manager/management/resource-providers-and-types#register-resource-provider) Bing Search as an Azure resource provider. You must have permission to perform the `/register/action` operation for the resource provider. The permission is included in the **Contributor** and **Owner** roles.
67
67
@@ -71,7 +71,7 @@ The authorization will happen between Grounding with Bing Search service and Azu
71
71
72
72
1. After you have created a Grounding with Bing Search resource, you can find it in [Azure portal](https://portal.azure.com/#home). Navigate to the resource group you've created the resource in, search for the Grounding with Bing Search resource you have created.
73
73
74
-
:::image type="content" source="..\..\media\tools\bing\resource-azure-portal.png" alt-text="A screenshot of the Bing resource in the Azure portal." lightbox="..\..\media\tools\bing\resource-azure-portal.png":::
74
+
:::image type="content" source="../../media\tools\bing\resource-azure-portal.png" alt-text="A screenshot of the Bing resource in the Azure portal." lightbox="../../media\tools\bing\resource-azure-portal.png":::
0 commit comments