How to use the Teams Bot

Use ajan models and agents directly in Microsoft Teams

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

Two Ways to Use the Teams Bot

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

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

Each approach has its benefits depending on your use case.

Available Commands

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

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

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.

SwitchWorkspace

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

Private Chat

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

Getting Started

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

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.

Using ajan in Channels

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

Getting Started

To interact with ajan in a channel, tag @ajan in your message. This routes your message to the ajan 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:

• ajan 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 @ajan later with full context
• For follow-up questions, tag @ajan again to ensure your message gets routed to the bot

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

Channel Privacy

When using ajan 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 ajan web app.

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

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

Skills

Skills you have access to are automatically available in the Teams Bot, the same way they are in the web app. This includes your personal skills, workspace skills, and any skills attached to the agent you select with SetAgent.

• Personal and workspace skills run in private chat and in channel threads
• Selecting an agent with SetAgent activates the skills attached to that agent
• Skills are applied automatically based on your message, no extra command is needed

Limitations

• Only members of a ajan 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 ajan web app chat history

FAQ

Use the Teams Bot when users should access ajan models or agents directly from Microsoft Teams. It is useful for lightweight chat, team workflows, and quick access without switching back to the ajan app.

Check that the bot is installed, the user has access to ajan, the relevant agent or model is available, and Microsoft permissions or admin approval are configured correctly. If the issue affects only one user or team, compare their Teams and ajan permissions.