This guide explains how to integrate AI bot - Agents into your chat and personal message (PM) experience.
Required user level: Administrator
Configuring chat and PM for Agents
In order to integrate with chat or topic mentions, an agent must have a
Usercreated and have aDefault Language Modelselected.
-
Enable
Allow Personal Messages, this will allow users to send PMs to the agent. -
Enable
Allow Topic Mentions, this will allow users in allowed groups to mention this agent in topics. -
Enable
Allow Chat Direct Messages, this will allow the user agent to receive direct messages (DMs). -
Enable
Allow Chat Channel Mentions, this will allow users in allowed groups to mention this agent in chat channels.
Tips for configuring chat agents
When configuring an agent for chat, keep the following tips in mind:
-
Max Context Posts: Chat messages tend to be short, so consider increasing the
Max Context Postssetting to a higher number for agents focused on mentions. This will allow the AI to maintain more context from previous messages. -
Default LLM and User: Chat and topic mentions can only be enabled on an agent if you enable both a default LLM (language model) and user. Make sure to properly configure these settings.
-
PM-based Features: All features available for PM-based agents are also available for chat agents. However, the optional advanced debugging information displayed in PMs is not shown in chat.
Auditing chat interactions
Auditing chat interactions can be a bit more challenging compared to other methods. However, ai_api_audit_logs will still have full logs of all chat interactions. You can query these logs using the Data Explorer in Discourse.
Chat behavior
When interacting with chat agents, keep the following behavior in mind:
-
DM: A new thread will be unconditionally created for every new message sent to the bot via DM.
-
Channel: When mentioning the bot in a channel, the reply will be added to the current context. If mentioned inside an existing thread, the bot replies within that thread. If mentioned in the main channel, the bot replies directly in the channel.
Last edited by @Saif 2024-11-04T23:39:55Z
Last checked by @hugh 2024-08-06T02:12:37Z
Check document
Perform check on document:
