Skip to content

Commit 0789352

Browse files
authored
Merge pull request #247581 from aahill/oaoi-pva
image and extra section
2 parents 382fbb6 + f87980c commit 0789352

File tree

4 files changed

+34
-22
lines changed

4 files changed

+34
-22
lines changed

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

Lines changed: 26 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -152,18 +152,24 @@ Avoid asking long questions and break them down into multiple questions if possi
152152

153153
* If you have documents in multiple languages, we recommend building a new index for each language and connecting them separately to Azure OpenAI.
154154

155-
### Using Power Virtual Agents
155+
### Deploying the model
156+
157+
After you connect Azure OpenAI to your data, you can deploy it using the **Deploy to** button in Azure OpenAI studio.
158+
159+
:::image type="content" source="../media/use-your-data/deploy-model.png" alt-text="A screenshot showing the model deployment button in Azure OpenAI Studio." lightbox="../media/use-your-data/deploy-model.png":::
160+
161+
#### Using Power Virtual Agents
156162

157163
You can deploy your model to [Power Virtual Agents](/power-virtual-agents/fundamentals-what-is-power-virtual-agents) directly from Azure OpenAI studio, enabling you to bring conversational experiences to various data stores like public websites, SharePoint, OneDrive, and more. Power Virtual Agents acts as a conversational and generative AI platform, making the process of creating, publishing and deploying a bot to any number of channels simple and accessible.
158164

159-
While Power Virtual Agents has features that leverage Azure OpenAI such as [generative answers](/power-virtual-agents/nlu-boost-conversations), deploying a model grounded on your data lets you create a chatbot that will respond using your data, and connect it to the Power Platform.
165+
While Power Virtual Agents has features that leverage Azure OpenAI such as [generative answers](/power-virtual-agents/nlu-boost-conversations), deploying a model grounded on your data lets you create a chatbot that will respond using your data, and connect it to the Power Platform. For more information, see [Use a connection to Azure OpenAI on your data](/power-virtual-agents/nlu-generative-answers-azure-openai).
160166

161167
> [!VIDEO https://www.microsoft.com/videoplayer/embed/RW192hF]
162168
163169

164-
### Using the web app
170+
#### Using the web app
165171

166-
You can also use the available standalone web app to interact with your model using a graphical user interface, which you can deploy using either [Azure OpenAI studio](../use-your-data-quickstart.md?pivots=programming-language-studio#deploy-a-web-app) or a [manual deployment](https://github.com/microsoft/sample-app-aoai-chatGPT).
172+
You can also use the available standalone web app to interact with your model using a graphical user interface, which you can deploy using either Azure OpenAI studio or a [manual deployment](https://github.com/microsoft/sample-app-aoai-chatGPT).
167173

168174
![A screenshot of the web app interface.](../media/use-your-data/web-app.png)
169175

@@ -179,6 +185,22 @@ When customizing the app, we recommend:
179185

180186
- Pulling changes from the `main` branch for the web app's source code frequently to ensure you have the latest bug fixes and improvements.
181187

188+
#### Important considerations
189+
190+
- Publishing creates an Azure App Service in your subscription. It may incur costs depending on the
191+
[pricing plan](https://azure.microsoft.com/pricing/details/app-service/windows/) you select. When you're done with your app, you can delete it from the Azure portal.
192+
- You can [customize](../concepts/use-your-data.md#using-the-web-app) the frontend and backend logic of the web app.
193+
- By default, the app will only be accessible to you. To add authentication (for example, restrict access to the app to members of your Azure tenant):
194+
195+
1. Go to the [Azure portal](https://portal.azure.com/#home) and search for the app name you specified during publishing. Select the web app, and go to the **Authentication** tab on the left navigation menu. Then select **Add an identity provider**.
196+
197+
:::image type="content" source="../media/quickstarts/web-app-authentication.png" alt-text="Screenshot of the authentication page in the Azure portal." lightbox="../media/quickstarts/web-app-authentication.png":::
198+
199+
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**
200+
201+
Now users will be asked to sign in with their Azure Active Directory 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.
202+
203+
182204
### Using the API
183205

184206
Consider setting the following parameters even if they are optional for using the API.

articles/ai-services/openai/includes/deploy-web-app.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,12 +9,16 @@ ms.topic: include
99
ms.date: 06/15/2023
1010
---
1111

12-
## Deploy a web app
12+
## Deploy your model
1313

1414
Once you're satisfied with the experience in Azure OpenAI studio, you can deploy a web app directly from the
1515
Studio by selecting the **Deploy to** button.
1616

17-
:::image type="content" source="../media/quickstarts/chatgpt-playground-publish-web-app.png" alt-text="A screenshot showing the button to publish a web app in Azure AI studio." lightbox="../media/quickstarts/chatgpt-playground-publish-web-app.png":::
17+
:::image type="content" source="../media/use-your-data/deploy-model.png" alt-text="A screenshot showing the model deployment button in Azure OpenAI Studio." lightbox="../media/use-your-data/deploy-model.png":::
18+
19+
This gives you the option to either [deploy the model](../concepts/use-your-data.md#deploying-the-model) as a standalone web application, or to Power Virtual Agents.
20+
21+
As an example, if you choose to deploy a web app:
1822

1923
The first time you deploy a web app, you should select **Create a new web app**. Choose a name for the app, which will
2024
become part of the app URL. For example, `https://<appname>.azurewebsites.net`.
@@ -23,5 +27,6 @@ Select your subscription, resource group, location, and pricing plan for the pub
2327
update an existing app, select **Publish to an existing web app** and choose the name of your previous
2428
app from the dropdown menu.
2529

30+
If you choose to deploy a web app, see the [important considerations](../concepts/use-your-data.md#important-considerations) for using it.
2631
> [!div class="nextstepaction"]
27-
> [I ran into an issue with the web app.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=STUDIO&Pillar=AOAI&Product=ownData&Page=quickstart&Section=Create-sample-app)
32+
> [I ran into an issue with deploying the model.](https://microsoft.qualtrics.com/jfe/form/SV_0Cl5zkG3CnDjq6O?PLanguage=STUDIO&Pillar=AOAI&Product=ownData&Page=quickstart&Section=Create-sample-app)

articles/ai-services/openai/includes/use-your-data-studio.md

Lines changed: 0 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -61,18 +61,3 @@ You can experiment with the configuration settings such as temperature and pre-r
6161

6262
[!INCLUDE [deploy-web-app](deploy-web-app.md)]
6363

64-
65-
### Important considerations
66-
67-
- Publishing creates an Azure App Service in your subscription. It may incur costs depending on the
68-
[pricing plan](https://azure.microsoft.com/pricing/details/app-service/windows/) you select. When you're done with your app, you can delete it from the Azure portal.
69-
- You can [customize](../concepts/use-your-data.md#using-the-web-app) the frontend and backend logic of the web app.
70-
- By default, the app will only be accessible to you. To add authentication (for example, restrict access to the app to members of your Azure tenant):
71-
72-
1. Go to the [Azure portal](https://portal.azure.com/#home) and search for the app name you specified during publishing. Select the web app, and go to the **Authentication** tab on the left navigation menu. Then select **Add an identity provider**.
73-
74-
:::image type="content" source="../media/quickstarts/web-app-authentication.png" alt-text="Screenshot of the authentication page in the Azure portal." lightbox="../media/quickstarts/web-app-authentication.png":::
75-
76-
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**
77-
78-
Now users will be asked to sign in with their Azure Active Directory 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.
9.22 KB
Loading

0 commit comments

Comments
 (0)