1. How do I use connectors in AI Agent Studio?
  2. Create Microsoft Teams Client Connector Instances for AI Agent Studio

Create Microsoft Teams Client Connector Instances for AI Agent Studio

You can integrate Microsoft Teams with AI Agent Studio, enabling users to access Oracle AI workflows from Microsoft Teams. The integration preserves user identity and data security across Oracle Fusion Cloud Applications. After integration, users can select their 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 your app in Microsoft Teams:

  1. Register Azure Bot in Microsoft Entra
  2. Create a Connector for Microsoft Teams in AI Agent Studio
  3. Download the Manifest File and Icons
  4. Upload the Manifest Zip File in Microsoft Teams Console

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:
    • Click Manage Password next to Microsoft App ID and create a new client secret.
    • 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:
    • From the left panel, open API Permissions.
    • Go to Add Permission > Microsoft Graph > Application Permissions.
    • In the User folder, search for User.ReadBasic.All and add it.
    • Click Grant admin consent for the added permission.
  9. Configure Delegate Permissions:
    • From the left panel, open API Permissions.
    • Go to Add Permission > Microsoft Graph > Delegate Permissions.
    • In the User folder, search for User.ReadBasic.All and add it.
    • Click Grant admin consent for the added permission.
  10. Enable Microsoft Teams Channel:
    • Go back to your bot resource, and open Channels from the left panel.
    • Select the Microsoft Teams channel, agree to the terms and conditions, and click Apply.

Create a Connector for Microsoft Teams in AI Agent Studio

Prerequisite: You need to assign the ORA_DR_FAI_GENERATIVE_AI_AGENT_COLLAB_TOOLS_DUTY duty role to your job role. For more information, see Access Requirements for AI Agent Studio.

  1. Go to Tools > AI Agent Studio.
  2. Click the Connectors tab.
  3. Click Add Connector.
  4. Search for the Microsoft Teams (Client) connector and click +.
  5. Provide the name for the connector, select the family and product, and provide a description.
  6. Enter details for the bot configuration:
    • Bot 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.
    • (Optional) Provide the IDCS Client ID and Secret if using SSO.
  7. Enter details for the connector manifest file.
    • Manifest Short Name: Enter the short name for the app as displayed in Microsoft Teams.
    • Manifest Full Name: Enter the full name for the app as displayed in Microsoft Teams.
    • Manifest Schema Version: Select the Microsoft schema version that's to be used for the manifest file.
  8. Enter details for advanced settings:
    • Valid Domains: Enter a 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.
  9. Click Create.

Download the Manifest File and Icons

  1. In AI Agent Studio, click the Connectors icon.
  2. Under Configured connectors, click the connector you created in AI Agent Studio.
  3. Under Attachments, click the Download icon next to manifest.json and the two icons.
  4. Save the manifest.json file and the icon files to a location of your choice. Zip the files together.

Upload the Manifest Zip File 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 zipped (manifest.json file and the two icons) 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.