Skip to main content
Agents & Tasks

Agents: create a reusable AI teammate

Give an AI a clear role, instructions, a model, knowledge, and connected tools your team can reuse.

Written By Katja Danilina

Last updated About 1 month ago

An agent is a reusable AI teammate. It has its own name, job instructions, model, knowledge, and optional tools. Once it's ready, members of the workspace can chat with it or mention it in a channel.

Use an agent when you want the same role and rules more than once. Use a normal AI chat for one-off questions.

Create an agent

  1. Select Agents in the left rail, then the + beside Agents. To start from a ready-made setup, open Templates, choose one, and select Use Template.

  2. Give the agent a clear name and short description, such as “Customer feedback analyst”.

  3. Write its instructions: the goal, the steps to follow, the result format, and what it must not do.

  4. Choose a model. Agents that use connected tools need a model that supports tools.

  5. Add only the files, canvases, and connected-app actions this role needs.

  6. Select Create Agent, then start a chat to test it with a normal case, a difficult case, and a request it should refuse or hand back to a person.

Write useful instructions

Strong instructions answer five questions:

  1. Role: what job does this agent have?

  2. Inputs: what information should it use?

  3. Method: what steps should it follow?

  4. Output: what should the result look like?

  5. Limits: when should it stop, ask a question, or avoid an action?

For example: “Review incoming customer feedback. Group similar comments into themes, include two short examples for each theme, and suggest one next step. Keep customer names out of the summary. If there are fewer than five useful comments, say the sample is too small instead of drawing a conclusion.”

Add knowledge and tools

Give the agent a focused set of files and canvases. A support agent may need the support policy and product FAQ, not every document in the workspace. The agent also uses the workspace's shared Workspace Context.

Tools let the agent read or change information in a connected app, such as finding an email or creating an issue. Select the smallest set of actions it needs. Connections belong to people: sharing an agent doesn't share your Gmail, GitHub, or other account with the workspace. A teammate may need to connect their own account before using a tool.

Use an agent

  • Select Start chat on the agent's page for a focused conversation.

  • Mention the agent in a channel to bring it into a team discussion.

  • Create a task when the same job should run again.

Improve it over time

When an agent gives a weak result, change one thing at a time: make the instructions clearer, give it a better source, or remove a tool or step it doesn't need. Test again with the same examples before you automate the job.

Agents are shared workspace resources. Free organizations can have 2 shared agents; paid plans have no limit.

Full guide: https://docs.mantle.chat/features/agents