Skip to content

Commit 50db9b3

Browse files
Learn Build Service GitHub AppLearn Build Service GitHub App
authored andcommitted
Merging changes synced from https://github.com/MicrosoftDocs/azure-docs-pr (branch live)
2 parents 25dfe54 + 8f11505 commit 50db9b3

File tree

131 files changed

+1249
-770
lines changed

Some content is hidden

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

131 files changed

+1249
-770
lines changed

articles/ai-services/document-intelligence/tutorial-logic-apps.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -106,13 +106,13 @@ Now that we've created the flow, the last thing to do is to test it and make sur
106106

107107
:::image type="content" source="media/logic-apps-tutorial/failed-run-step.png" alt-text="Screenshot of failed step.":::
108108

109-
1. Once achieve a successful run, check your email. There's a new email with the information we specified.
109+
1. After a workflow run succeeds, check your email. There's a new email with the information we specified.
110110

111111
:::image type="content" source="media/logic-apps-tutorial/invoice-received.png" alt-text="Screenshot of received email message.":::
112112

113-
1. Be sure to [disable or delete](../../logic-apps/manage-logic-apps-with-azure-portal.md#disable-or-enable-a-single-logic-app) your logic App after you're done so usage stops.
113+
1. After you're done, [disable or delete your logic app](../../logic-apps/manage-logic-apps-with-azure-portal.md?tabs=consumption#disable-enable-logic-apps) so that usage stops.
114114

115-
:::image type="content" source="media/logic-apps-tutorial/disable-delete.png" alt-text="Screenshot of disable and delete buttons.":::
115+
:::image type="content" source="media/logic-apps-tutorial/disable-delete.png" alt-text="Screenshot of disable and delete buttons.":::
116116

117117
Congratulations! You've officially completed this tutorial.
118118

articles/ai-services/openai/concepts/use-your-data.md

Lines changed: 10 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ There is an [upload limit](../quotas-limits.md), and there are some caveats abou
5353
* Doesn't lead to significant data loss.
5454
* Doesn't add unexpected noise to your data.
5555

56-
This will impact the quality of the model response.
56+
This will affect the quality of the model response.
5757

5858
## Ingesting your data
5959

@@ -104,9 +104,9 @@ Upgrade to a higher pricing tier or delete unused assets.
104104

105105
**Preprocessing Timeout Issues**
106106

107-
*Could not execute skill because the Web Api request failed*
107+
*Could not execute skill because the Web API request failed*
108108

109-
*Could not execute skill because Web Api skill response is invalid*
109+
*Could not execute skill because Web API skill response is invalid*
110110

111111
Resolution:
112112

@@ -186,7 +186,7 @@ Use the script [provided on GitHub](https://github.com/microsoft/sample-app-aoai
186186

187187
To add Azure Cosmos DB for MongoDB vCore as a data source, you will need an existing Azure Cosmos DB for MongoDB vCore index containing your data, and a deployed Azure OpenAI Ada embeddings model that will be used for vector search.
188188

189-
1. In the [Azure OpenAI portal](https://oai.azure.com/portal) chat playground, click **Select or add data source**. In the panel that appears, select **Azure Cosmos DB for MongoDB vCore** as the data source.
189+
1. In the [Azure OpenAI portal](https://oai.azure.com/portal) chat playground, select **Add your data**. In the panel that appears, select **Azure Cosmos DB for MongoDB vCore** as the data source.
190190
1. Select your Azure subscription and database account, then connect to your Azure Cosmos DB account by providing your Azure Cosmos DB account username and password.
191191

192192
:::image type="content" source="../media/use-your-data/add-mongo-data-source.png" alt-text="A screenshot showing the screen for adding Mongo DB as a data source in Azure OpenAI Studio." lightbox="../media/use-your-data/add-mongo-data-source.png":::
@@ -215,7 +215,7 @@ Currently, you can add your data from a URL/web address. Your data from a URL/we
215215

216216
* A public website, such as [Using your data with Azure OpenAI Service - Azure OpenAI | Microsoft Learn](/azure/ai-services/openai/concepts/use-your-data?tabs=ai-search). Note that you cannot add a URL/Web address with access control, such as with password.
217217

218-
* A HTTPS website.
218+
* An HTTPS website.
219219

220220
* The size of content in each URL is smaller than 5MB.
221221

@@ -242,26 +242,6 @@ You can modify the following additional settings in the **Data parameters** sect
242242
|**Retrieved documents** | Specifies the number of top-scoring documents from your data index used to generate responses. You might want to increase the value when you have short documents or want to provide more context. The default value is 5. This is the `topNDocuments` parameter in the API. |
243243
| **Strictness** | Sets the threshold to categorize documents as relevant to your queries. Raising the value means a higher threshold for relevance and filters out more less-relevant documents for responses. Setting this value too high might cause the model to fail to generate responses due to limited available documents. The default value is 3. |
244244

245-
## Azure Role-based access controls (Azure RBAC) for adding data sources
246-
247-
To add a new data source to Azure OpenAI on your data, you need the following Azure RBAC roles.
248-
249-
250-
|Azure RBAC role | Which resource needs this role? | Needed when |
251-
|---------|---------|---------|
252-
| [Cognitive Services OpenAI Contributor](../how-to/role-based-access-control.md#cognitive-services-openai-contributor) | The Azure AI Search resource, to access Azure OpenAI resource. | You want to use Azure OpenAI on your data. |
253-
|[Search Index Data Reader](/azure/role-based-access-control/built-in-roles#search-index-data-reader) | The Azure OpenAI resource, to access the Azure AI Search resource. | You want to use Azure OpenAI on your data. |
254-
|[Search Service Contributor](/azure/role-based-access-control/built-in-roles#search-service-contributor) | The Azure OpenAI resource, to access the Azure AI Search resource. | You plan to create a new Azure AI Search index. |
255-
|[Storage Blob Data Contributor](/azure/role-based-access-control/built-in-roles#storage-blob-data-contributor) | You have an existing Blob storage container that you want to use, instead of creating a new one. | The Azure AI Search and Azure OpenAI resources, to access the storage account. |
256-
| [Cognitive Services OpenAI User](../how-to/role-based-access-control.md#cognitive-services-openai-user) | The web app, to access the Azure OpenAI resource. | You want to deploy a web app. |
257-
| [Contributor](/azure/role-based-access-control/built-in-roles#contributor) | Your subscription, to access Azure Resource Manager. | You want to deploy a web app. |
258-
| [Cognitive Services Contributor Role](/azure/role-based-access-control/built-in-roles#cognitive-services-contributor) | The Azure AI Search resource, to access Azure OpenAI resource. | You want to deploy a [web app](#using-the-web-app). |
259-
260-
## Virtual network support & private endpoint support
261-
262-
* For instructions on setting up your resources to work on a virtual private network or private endpoint, see [Use Azure OpenAI on your data securely](../how-to/use-your-data-securely.md)
263-
* Azure OpenAI, Azure AI Search, and Azure Storage Accounts can be protected under private endpoints and virtual private networks.
264-
265245
## Document-level access control
266246

267247
> [!NOTE]
@@ -442,7 +422,7 @@ When customizing the app, we recommend:
442422

443423
- Resetting the chat session (clear chat) if the user changes any settings. Notify the user that their chat history will be lost.
444424

445-
- Clearly communicating the impact on the user experience that each setting you implement will have.
425+
- Clearly communicating the effect on the user experience that each setting you implement will have.
446426

447427
- When you rotate API keys for your Azure OpenAI or Azure AI Search resource, be sure to update the app settings for each of your deployed apps to use the new keys.
448428

@@ -459,11 +439,11 @@ When customizing the app, we recommend:
459439

460440
1. Select Microsoft as the identity provider. The default settings on this page will restrict the app to your tenant only, so you don't need to change anything else here. Then select **Add**
461441

462-
Now users will be asked to sign in with their Microsoft Entra account to be able to access your app. You can follow a similar process to add another identity provider if you prefer. The app doesn't use the user's login information in any other way other than verifying they are a member of your tenant.
442+
Now users will be asked to sign in with their Microsoft Entra account to be able to access your app. You can follow a similar process to add another identity provider if you prefer. The app doesn't use the user's sign-in information in any other way other than verifying they are a member of your tenant.
463443

464444
### Chat history
465445

466-
You can enable chat history for your users of the web app. By enabling the feature, your users will have access to their individual previous queries and responses.
446+
You can enable chat history for your users of the web app. If you enable the feature, your users will have access to their individual previous queries and responses.
467447

468448
To enable chat history, deploy or redeploy your model as a web app using [Azure OpenAI Studio](https://oai.azure.com/portal)
469449

@@ -589,4 +569,6 @@ token_output = TokenEstimator.estimate_tokens(input_text)
589569
## Next steps
590570
* [Get started using your data with Azure OpenAI](../use-your-data-quickstart.md)
591571

572+
* [Securely use Azure OpenAI on your data](../how-to/use-your-data-securely.md)
573+
592574
* [Introduction to prompt engineering](./prompt-engineering.md)

0 commit comments

Comments
 (0)