For the complete documentation index, see llms.txt. This page is also available as Markdown.

MS Teams AI Tool

Use the MS Teams tool within custom AI agents to collaborate with users in Microsoft Teams without leaving their workspace.

The MS Teams AI Tool enables custom agents to collaborate with users directly in Microsoft Teams. Once configured, an agent can create or use a dedicated channel or group chat, invite mapped participants, post messages, and receive replies from identified users. Your team can interact with Emporix-driven collaboration in the communication tool they already use, without switching applications.

Prerequisites

Before configuring the MS Teams AI Tool, ensure that:

  • You have the permissions required to register and manage Teams bot integrations in your Microsoft 365 environment. Automatic installation requires a Teams admin to upload the app package in Teams Admin Center.

  • You know which Microsoft Teams team and channel your organization wants to use for agent collaboration.

Configuring MS Teams tool

1

Choose to add new tool

In Agentic AI -> AI Tools, choose Add new tool.

2

Enter the tool details

In the creation form, choose Microsoft Teams as the Tool Type. Enter Tool ID and Tool Name in the General tab, then complete Install Emporix Microsoft Teams AI.

Install Emporix Microsoft Teams AI Tool
Install Emporix Microsoft Teams AI Tool

The installation steps are needed once per customer tenant.

3

Download the app package

Select Download app package to download a file with the Emporix Teams bot configuration.

4

Upload the package in Teams Admin Center

Use Open Teams Admin Center to open the portal and upload the package in Teams Admin Center → Teams apps → Manage apps. Set the app to Allowed and assign it through the app permission policy if required. Only a Teams admin can access this application.

5

Select Grant Graph admin consent to allow the Emporix Graph app to be used. Consent is required for outbound collaboration and group chat bot installation.

6

Connect Microsoft Teams

Select Connect Microsoft Teams, then add the app to a team. Emporix captures the Team ID from the installation process.

7

Review the settings and complete configuration

In the Settings tab, review the connection details and finish the configuration:

  • Team ID – The Microsoft 365 Group ID of the target team. Cannot be changed after you save.

  • Tenant ID (AAD) – The Azure AD (Entra ID) tenant ID of your Microsoft 365 organization.

  • Default inbound agent – Optional. Leave empty to skip routing replies that are not already bound to an agent.

  • Allowed operations – Select or clear the operations this tool instance can expose. You can further restrict these operations per agent when you attach the tool under Native Tools. Available options:

    • Send message

    • Create chat

    • Create channel

    • Invite participants

    • Collaborate on channel

    • Collaborate on chat

MS Teams tool Settings
MS Teams tool Settings

As an alternative, enter Team ID and Tenant ID (AAD) yourself in the Settings tab instead of using the guided installation. Default inbound agent remains optional, and you still select or clear Allowed operations according to your requirements.

To find Team ID, in Microsoft Teams select the target team → ... → Get link to team, then copy the groupId query parameter. Alternatively, in Teams Admin Center go to Teams → Manage teams, select the team, and copy its Group ID. The app must be added to a team. A personal-only installation has no Team ID.

Once done, save the configuration.

8

Check MS Teams bot installation

Navigate to your Microsoft Teams environment and verify that the Emporix bot is available in the configured team. The Emporix Agent bot is available and can already assist you directly in MS Teams.

Emporix Agent bot in MS Teams
Emporix Agent bot in MS Teams

After the tool is configured, attach it to an agent and instruct collaboration in the Prompt. For the shared procedure and outbound/inbound behavior, see Communication Tools Configuration.

Best practices

  • You can reuse the same MS Teams tool instance across agents. When you attach the tool under Native Tools, grant each agent only the Allowed operations it needs.

  • Define a clear group chat naming schema so that each collaboration session is easy to identify in Microsoft Teams.

  • Verify that participant email addresses are correct before enabling the agent. If a user with that email does not exist in Microsoft Teams and cannot be added, the failure is recorded in AI Logs at warning or error severity.

  • Configure default inbound handling only when the agent workflow is designed to process replies from collaboration participants.

  • Collaboration outcomes must be predictable. Ensure the channel or group chat exists or can be created before the agent invokes the tool. Failures are always recorded in AI Logs.

Last updated

Was this helpful?