Discord

his agent enables communication between Katara and a Discord server, allowing Katara to read and write messages.

Registering a Discord agent in your server

When creating a Discord agent or adding an existing Discord agent to a server, you will need to follow these steps:

1. Install the Katara app on your server. You will be given a link for this. The installed app will need the permissions listed below.

2. Register the agent in your server with the :katara.register command. You will be given a one-time password for registration.

3. Verify that the agent has been registered. You should see a confirmation message from the bot and see that the server was registered successfully by verifying the registration on the same screen the other steps were given.

What permissions does the agent need?

For the Discord agent to run as expected, it needs the permissions below. Don't know how to access your server's permission settings?

Server permissions

You will need to give the katara role these server permissions:

General Server Permissions: View Channels and Manage Channels

Text Channel Permissions: Send Messages, Send Messages in Threads, Create Public Threads, Create Private Threads, Embed Links, Attach Files, Add Reactions, Manage Messages, Manage Threads, and Read Message History

Channel permissions

You only need to adjust a channel's permissions if you've overridden the server permissions above. By default, the channel's permissions will be inherited directly from the server-level permissions.

For every channel the agent is active in, the katara role will need the same permissions as listed above. You can change channel-level permissions by hovering on a channel, clicking Edit Channel > Permissions > Advanced permissions. Learn more about Discord channel permissions

Agent configuration

Configuration option	Explanation
Tags	Tags are applied to all future data collected by this agent, which can be used later for filtering. All servers and channels inherit these tags.

Channel configuration

Configuration option	Explanation
Enabled	Whether to collect data from a channel. By default, all channels except the channel you register the agent in will be disabled.
Send replies	Enabling this option allows you to respond to questions asked in your Discord. If you don’t provide one, we’ll just collect messages into your corpus.
Q&A Agent	If sending replies, this option allows you to choose which Q&A Agent will generate the replies. This agent can then be configured to configure responses in your channel.
Send replies when threshold is not met	If enabled, users will be notified when the linked Q&A agent is not able to generate a response to a question that meets its confidence threshold.
Tags	Tags are applied to all future data collected by this channel, which can be used later for filtering. Tags set in the agent's configuration will be inherited here.

Commands

Commands can be typed into your Discord server once you've installed the Katara bot.

Command	Function
:katara.register <one_time_password>	Register an agent in your server using a password generated when creating an agent
:katara.config	Print configuration information
:katara.load	Load the last 100 messages in a channel
:katara.ask <question>	Ask the agent a question, even if it's disabled in the channel. This will not produce an answer if you do not have a Q&A agent attached to the Discord agent.