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
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.
Give the agent a clear name and short description, such as “Customer feedback analyst”.
Write its instructions: the goal, the steps to follow, the result format, and what it must not do.
Choose a model. Agents that use connected tools need a model that supports tools.
Add only the files, canvases, and connected-app actions this role needs.
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:
Role: what job does this agent have?
Inputs: what information should it use?
Method: what steps should it follow?
Output: what should the result look like?
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
Was this helpful?
More in Agents & Tasks
Task triggers: manual, schedule, on complete, and app eventsStill need help? Ask the team