Create Microsoft Teams Channel for AI Agent Studio

You can integrate Microsoft Teams with AI Agent Studio, and enable users to access Oracle AI agents from Microsoft Teams. The integration preserves user identity and data security across Oracle Fusion Cloud Applications and Microsoft accounts. After integration, users can select Ask Oracle app in Microsoft Teams and interact with the AI agents available to them.

Integration with Microsoft Teams involves configuring several Microsoft 365 services, including Microsoft Entra (Azure Active Directory), Microsoft Bot Framework, and the Teams App Manifest. These components are closely interdependent and must be configured correctly across environments and tenants. Proper coordination and version management are essential for identity flows, manifest packaging, channel registrations, permission scoping, and endpoint exposure.

Here are the steps to set up Ask Oracle in Microsoft Teams:

1. Register Azure bot in Microsoft Entra (Azure Active Directory). Ensure to save the bot ID, password and tenant ID after registration.
2. Create a manifest file for Microsoft Teams in AI Agent Studio, and download it.
3. Upload the manifest file downloaded from AI Agent Studio in Microsoft Teams.

Register Azure Bot in Microsoft Entra

1. As an Azure/Exchange administrator, sign in to the Microsoft Azure portal.

2. Click Create a resource and search for Azure Bot.
3. Create the bot by adding these details:

   • Enter a unique bot handle.
   • Choose your active subscription.
   • Select an existing resource group or create one. For Type of App, select Single Tenant.
   • Select Create new Microsoft App ID as Creation Type.
4. Click next and create the bot.
5. After deployment is complete, click Go to resource.

6. Enter the URL of the bot service in Messaging endpoint. The URL will be of this pattern:

   https://<pod name>/api/fusion-ai/orchestrator/collabTools/v1/teams-message

   Replace <pod name> with the base URL of your Oracle application environment.

   Note: Make a note of the App ID and Tenant ID because you'll need them when creating the manifest file in AI Agent Studio.
7. Generate a client secret:
   1. Click Manage Password next to Microsoft App ID and create a new client secret.
   2. Provide a description, for example, Oracle Agents Secret, and select a desired expiry date.
      Note: Make a note of the client secret because you'll need it when creating the manifest file in AI Agent Studio.
8. Configure Application Permissions:
   1. From the left panel, open API Permissions.
   2. Go to Add Permission > Microsoft Graph > Application Permissions.
   3. In the User folder, search for User.ReadBasic.All and add it.

   4. Click Grant admin consent for the added permission.

9. Configure Delegate Permissions:
   1. From the left panel, open API Permissions.
   2. Go to Add Permission > Microsoft Graph > Delegate Permissions.
   3. In the User folder, search for User.ReadBasic.All and add it.

   4. Click Grant admin consent for the added permission.

10. Enable Microsoft Teams Channel:
    1. Go back to your bot resource, and open Channels from the left panel.
    2. Select the Microsoft Teams channel, agree to the terms and conditions, and click Apply.

Create Manifest File in AI Agent Studio

Prerequisite: Make sure that your role has the necessary permission groups. For more information, see Assign Permission Groups to Use Channels in Credentials in Access Requirements for AI Agent Studio.

1. In AI Agent Studio, go to the Credentials tab, and then open the Channels tab.
2. Configure Microsoft Teams.
3. Enter details for the channel manifest file.
   • Short Manifest Name: Enter the short name for the app as displayed in Microsoft Teams. The default value is Ask Oracle.
   • Full Manifest Name: Enter the full name for the app as displayed in Microsoft Teams. For example, Ask Oracle Fusion Agent.
   • Manifest Code: Enter a unique ID to be used in AI Agent Studio (not part of the Microsoft Teams schema). For example, b3e4a289-7cbb-43d3-9a4c-d52bc874e830
   • Version: Select the manifest schema version.
   • Manifest Schema Version: Select the Microsoft schema version that's to be used for the manifest file.
   • Oracle Instance URL: Enter the URL for the Oracle tenant for Fusion Applications.
     Format is

     https://<fully qualified pod name>:<optional port>

     Create separate manifests for each tenant.
   • Bot ID or App ID: Enter the App ID that was generated during the Azure bot setup.
   • Tenant: Enter the Tenant ID that was generated during Azure bot setup.
   • Secret: Enter the client secret that was generated during the Azure bot setup.
   • Advanced Settings: List of valid domains or websites the bot can access or redirect to. Include all API or identity-related endpoints.
     Note: You must add token.botframework.com with the fully qualified pod name.
4. Create the manifest file.
5. Select Edit and download the manifest file, to be used in Microsoft Teams.

Upload Bot Artifacts in Microsoft Teams Console

1. As an administrator, go to Microsoft Teams Admin Center.
2. Open Manage Apps and select Upload new app from the Actions menu.
3. Upload the manifest file downloaded from AI Agent Studio.
4. Publish the app. Your app now appears in the list of available apps.
5. In Manage Apps, go to Setup Policies > Org Wide Policy and add the app you published.

Your app is now available to all users included in Org Wide Policy.