Skip to content

Commit 48ca580

Browse files
committed
update per team's changes
1 parent 666219a commit 48ca580

File tree

1 file changed

+24
-12
lines changed

1 file changed

+24
-12
lines changed

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

Lines changed: 24 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -314,39 +314,51 @@ You can deploy to a copilot in [Copilot Studio](/microsoft-copilot-studio/fundam
314314
315315
#### [Teams app (preview)](#tab/teams)
316316

317-
A Teams app lets you bring conversational experience to your users in Teams to improve operational efficiency and democratize access of information. This Teams app feature is limited to users within a single tenant and personal chat (non-group chat) scenarios.
317+
A Teams app lets you bring conversational experience to your users in Teams to improve operational efficiency and democratize access of information. By default, this Teams app is set for users within a single Azure account tenant and personal chat (non-group chat) scenarios, but developers can modify the app to enable different configurations.
318318

319319
You can deploy to a standalone Teams app directly from Azure OpenAI Studio. Follow the steps below:
320320

321321
1. Make sure you have fulfilled the following prerequisites:
322-
* Sign in to your M365 account (using this link to get a test account: [Developer program](https://developer.microsoft.com/microsoft-365/dev-program))
322+
- The latest version of [Visual Studio Code](https://code.visualstudio.com/) installed.
323+
- The latest version of [Teams toolkit](https://marketplace.visualstudio.com/items?itemName=TeamsDevApp.ms-teams-vscode-extension) installed. This is a VSCode extension that creates a project scaffolding for your app.
324+
- [Node.js](https://nodejs.org/en/download/) (version 16 or 17) installed. For more information, see [Node.js version compatibility table for project type](/microsoftteams/platform/toolkit/build-environments#nodejs-version-compatibility-table-for-project-type).
325+
- [Microsoft Teams](https://www.microsoft.com/microsoft-teams/download-app) installed.
326+
* Sign in to your M365 account (using this link to get a test account: [Developer program](https://developer.microsoft.com/microsoft-365/dev-program))
327+
- [Azure command-line interface (CLI)](/cli/azure/install-azure-cli) installed. This is a cross-platform command-line tool to connect to Azure and execute administrative commands on Azure resources. For more information on setting up environment variables, see theAzure SDK documentation.
328+
- Your Azure account has been assigned **Cognitive Services OpenAI user** or **Cognitive Services OpenAI Contributor** role of the Azure OpenAI resource you're using, allowing your account to make Azure OpenAI API calls. For more information, [seeUsing your data with Azure OpenAI securely](/azure/ai-services/openai/how-to/use-your-data-securely#using-the-api) and [Add role assignment to an Azure OpenAI resource](/azure/ai-services/openai/how-to/role-based-access-control#add-role-assignment-to-an-azure-openai-resource) for instructions on setting this role in the Azure portal.
323329
* Enable **custom app upload** in your account (instructions [here](/microsoftteams/platform/concepts/build-and-test/prepare-your-o365-tenant#enable-custom-teams-apps-and-turn-on-custom-app-uploading))
324-
* [Azure CLI](/cli/azure/install-azure-cli) installed
325-
* [Visual Studio Code](https://code.visualstudio.com/) installed
326-
* You have the **Cognitive Service OpenAI user** role with the Azure OpenAI resource you're using.
327330

328-
1. After you've added your data to the chat model, select **Deploy** and then **a Teams app(preview)**. Enter the name of your Teams app and download the resulting .zip file.
329331

330-
1. Extract the .zip file and open the folder in VSCode.
332+
1. After you've added your data to the chat model, select **Deploy** and then **a new Teams app(preview)**. Enter the name of your Teams app and download the resulting .zip file.
331333

332-
1. If you chose **API key** in the data connection step, manually copy and paste your Azure AI Search key into the `src\prompts\chat\config.json` file. If you chose **System assigned managed identity**, you can skip this step. Learn more about different data connection options in the [Data connection](/azure/ai-services/openai/concepts/use-your-data?tabs=ai-search#data-connection) section.
334+
1. Extract the .zip file and open the folder in Visual Studio Code.
333335

334-
1. Select the **Run** menu, and select **Debug (Edge)** to run the app locally in your environment. After you've tested it locally, you can provision, deploy, and publish your Teams app.
336+
1. If you chose **API key** in the data connection step, manually copy and paste your Azure AI Search key into the `src\prompts\chat\config.json` file. Your Azure AI Search Key can be found in Azure OpenAI Studio Playground by selecting the**View code** button with the key located underAzure Search Resource Key. If you chose **System assigned managed identity**, you can skip this step. Learn more about different data connection options in the [Data connection](/azure/ai-services/openai/concepts/use-your-data?tabs=ai-search#data-connection) section.
335337

336-
1. Provision your app: (detailed instructions in [Provision cloud resources](/microsoftteams/platform/toolkit/provision))
338+
1. Open the Visual Studio Code terminal and log into Azure CLI, selecting the account that you assigned **Cognitive Service OpenAI User** role to. Use the `az login` command in the terminal to log in.
339+
340+
1. To debug your app, press the **F5** key or select **Run and Debug** from the left pane. Then select your debugging environment from the dropdown list. A webpage opens where you can chat with your custom copilot.
341+
> [!NOTE]
342+
> The citation experience is available in **Debug (Edge)** or **Debug (Chrome)** only.
343+
344+
1. After you've tested your copilot, you can provision, deploy, and publish your Teams app by selecting the **Teams Toolkit Extension** on the left pane in Visual Studio Code. Run the separate provision, deploy, and publish stages in the **Lifecycle** section. You may be asked to sign in to your Microsoft 365 account where you have permissions to upload custom apps and your Azure Account.
345+
346+
1. Provision your app: (detailed instructions in [Provision cloud resources](/microsoftteams/platform/toolkit/provision))
347+
348+
1. Assign the **Cognitive Service OpenAI User** role to your deployed App Service resource
337349
1. Go to the Azure portal and select the newly created Azure App Service resource
338350
1. Go to **settings** -> **identity** -> **enable system assigned identity**
339351
1. Select **Azure role assignments** and then **add role assignments**. Specify the following parameters:
340352
* Scope: resource group
341353
* Subscription: the subscription of your Azure OpenAI resource
342354
* Resource group of your Azure OpenAI resource
343-
* Role: Cognitive Service OpenAI user
355+
* Role: **Cognitive Service OpenAI user**
344356

345357
1. Deploy your app to Azure by following the instructions in [Deploy to the cloud](/microsoftteams/platform/toolkit/deploy).
346358

347359
1. Publish your app to Teams by following the instructions in [Publish Teams app](/microsoftteams/platform/toolkit/publish).
348360

349-
See also [Tutorial - Build Custom Copilot using Teams](/microsoftteams/platform/teams-ai-library-tutorial) for guided steps.
361+
The README file in your Teams app has additional details and tips. Also, see [Tutorial - Build Custom Copilot using Teams](/microsoftteams/platform/teams-ai-library-tutorial) for guided steps.
350362

351363
#### [Web app](#tab/web-app)
352364

0 commit comments

Comments
 (0)