> ## Documentation Index
> Fetch the complete documentation index at: https://docs.langdock.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to use the Teams Bot

> Use Langdock models and agents directly in Microsoft Teams

<Info>
  To use Langdock in Teams, the Langdock app must be installed in your Teams
  workspace. This can only be done by a workspace admin following the steps
  detailed on the [Teams Bot setup page](/en/admin/manage-integrations/chatbot-setup-guides/teams-bot).
</Info>

Once the app is installed by your admin, you should see Langdock available in your Teams app. You can find it by clicking on the "..." icon in the left sidebar and searching for "Langdock".

## Two Ways to Use the Teams Bot

You can interact with the Langdock Teams Bot in two places:

1. **Private Chat**: Direct one-on-one conversations with Langdock
2. **Team Channels**: Collaborative conversations via **@Langdock** mention where your team can see and participate

Each approach has its benefits depending on your use case.

<Note>
  In channels, you must tag **@Langdock** to interact with the bot. The Teams Bot uses your default model from [Account Settings > Preferences](https://app.langdock.com/settings/account/preferences), or your workspace default if none is configured.
</Note>

## Available Commands

The Langdock Teams Bot provides three commands to help you get started:

| Command             | Description                     |
| ------------------- | ------------------------------- |
| **SetAgent**        | Select a Langdock agent         |
| **SwitchWorkspace** | Switch to a different workspace |
| **Help**            | Get help with the Langdock app  |

In private chat, these commands appear directly above the message input field in the prompt library. In channels, they appear after you **@Langdock**.

### SetAgent

Use the **SetAgent** command to select which agent handles your conversation. A dropdown appears with all available agents from your workspace. Use the search field to find the one you need, then click **Set**.

<img height="400" src="https://mintcdn.com/langdock-34/7-n_cIU4p_lSXzaz/images/teams-bot/setAgent.png?fit=max&auto=format&n=7-n_cIU4p_lSXzaz&q=85&s=57acbd7b97ae962c0e7eb3ba4d5f48f4" data-path="images/teams-bot/setAgent.png" />

<img height="400" src="https://mintcdn.com/langdock-34/7-n_cIU4p_lSXzaz/images/teams-bot/setAgent2.png?fit=max&auto=format&n=7-n_cIU4p_lSXzaz&q=85&s=466f5a9b97d48d16193144ee00c50c10" data-path="images/teams-bot/setAgent2.png" />

### SwitchWorkspace

If you have access to multiple Langdock workspaces, use **SwitchWorkspace** to change which workspace you're connected to. Select the workspace you want and click **Switch Workspace**.

<img height="400" src="https://mintcdn.com/langdock-34/7-n_cIU4p_lSXzaz/images/teams-bot/setWorkspace.png?fit=max&auto=format&n=7-n_cIU4p_lSXzaz&q=85&s=64f15685765ddc5bf8ad5387e089d41f" data-path="images/teams-bot/setWorkspace.png" />

## Private Chat

Private chat gives you a direct one-on-one conversation with Langdock. Your conversation context is maintained across messages.

### Getting Started

1. Find Langdock in your Teams app list
2. Open a chat with Langdock
3. You'll see the prompt library above the message input

<img height="400" src="https://mintcdn.com/langdock-34/7-n_cIU4p_lSXzaz/images/teams-bot/privateChat.png?fit=max&auto=format&n=7-n_cIU4p_lSXzaz&q=85&s=c1e59fd2f67094753dcb2d3d28b61edd" data-path="images/teams-bot/privateChat.png" />

### Clearing Chat History

To start fresh with a clean conversation, go to the chat tab, click the three dots menu, and select "Remove chat history". This resets the conversation context.

<Tip>
  Right-click on Langdock in your sidebar and select "Pin" for quick access. This keeps Langdock visible.
</Tip>

## Using Langdock in Channels

Channels let your team collaborate with Langdock together. Each thread becomes its own conversation.

### Getting Started

To interact with Langdock in a channel, tag **@Langdock** in your message. This routes your message to the Langdock API and brings up the command suggestions.

### Thread Context

Each thread in Teams is treated as a separate conversation. Here's what makes channels powerful:

* Langdock can see all messages in a thread once you tag it, even messages sent before it was tagged
* You can discuss something with colleagues first, then pull in **@Langdock** later with full context
* For follow-up questions, tag **@Langdock** again to ensure your message gets routed to the bot

<img height="400" src="https://mintcdn.com/langdock-34/7-n_cIU4p_lSXzaz/images/teams-bot/threadContext.png?fit=max&auto=format&n=7-n_cIU4p_lSXzaz&q=85&s=f0278d3b6502c52ec61a1f4f04cc6ca5" data-path="images/teams-bot/threadContext.png" />

### Setting an Agent for a Channel

You can create a dedicated channel for a specific agent. This is great when your team needs easy access to a specialized AI helper.

**Recommended workflow:**

1. Create a new channel in Teams (e.g., "FAQ-Agent" or "Content Writer")
2. When starting a conversation, select the relevant agent
3. All questions in that channel can then be directed to that agent

This pattern is particularly useful because:

* Team members know exactly which agent handles questions in that channel
* Each thread maintains its own conversation context
* Multiple team members can start separate threads with the same agent

<Note>
  Keep in mind that any team member can select a different agent when starting a new thread in the channel. If you want consistent agent usage, establish team guidelines for your channel.
</Note>

### Channel Privacy

When using Langdock in a channel, only members of that channel can see the conversations. Teams offers different channel privacy settings:

* **Standard channels**: Visible to all team members
* **Private channels**: Only visible to invited members

Consider using private channels for sensitive topics or when working with confidential information.

## Additional Features

### Web Search and Data Analysis

The Teams Bot has the same capabilities as the Langdock web app.

* Web search for current information
* Data analysis on uploaded files

<img height="400" src="https://mintcdn.com/langdock-34/7-n_cIU4p_lSXzaz/images/teams-bot/webSearch1.png?fit=max&auto=format&n=7-n_cIU4p_lSXzaz&q=85&s=b304c23d8939c89d79e727ad90a4a406" data-path="images/teams-bot/webSearch1.png" />

<img height="400" src="https://mintcdn.com/langdock-34/7-n_cIU4p_lSXzaz/images/teams-bot/webSearch.png?fit=max&auto=format&n=7-n_cIU4p_lSXzaz&q=85&s=a722fb2dc44aa620405f2884c074c0fb" data-path="images/teams-bot/webSearch.png" />

### Images and Documents

Share images and documents directly in your Teams messages:

* Upload files and images as attachments
* The bot can read and analyze them just like in the web app

<img height="400" src="https://mintcdn.com/langdock-34/7-n_cIU4p_lSXzaz/images/teams-bot/docsSupport.png?fit=max&auto=format&n=7-n_cIU4p_lSXzaz&q=85&s=6cf33ba418bf358a9d44ac08035d9dff" data-path="images/teams-bot/docsSupport.png" />

## Limitations

* Only members of a Langdock workspace can chat with the Teams Bot
* In channels, the bot only responds when tagged, but it can see all previous messages in the thread
* Cannot be used in direct messages with other users, only in channels or private chat with the bot itself
* Teams Bot conversations do not appear in the Langdock web app chat history
