Skip to main content
Create an agent when one responsibility keeps coming back, such as a weekly cash check, and you want every chat and Trigger about it to start from the same brief. An agent is Ari with a name, an icon, and instructions that you save once. It uses the same model as Ari and has the same access to your workspace that Ari has when it works for you. Its instructions do not give it access to anything more. Every administrator can chat with an agent and choose one for a Trigger. A member limited to named Pages chats with Ari only. Only administrators can create, change, archive, or restore an agent. Ari stays the default agent: you cannot rename, change, or archive it.

Create an agent

Describe the responsibility and ask Ari to save it as an agent:
Create an agent named Cash watch. Each week it compares our bank balance with the forecast and says what changed and why.
Ari saves the agent with the name and instructions you gave, and the agent appears in the agent menu of a new chat. Ari can also set the agent’s icon and color when you ask.
For the length limits, see Limits.

Chat with an agent

1

Start a new chat

Select New chat.
2

Choose the agent

Open the agent menu at the top of the chat and select the agent under Chat with.
3

Send your message

Type your question or request and send it.
You choose the agent before the first message. After that the chat keeps its agent: its name shows at the top of the chat and under the chat’s title in the chat list, and you cannot switch the chat to another agent. To ask Ari instead, start a new chat; a new chat starts with Ari.

Give a Trigger to an agent

1

Open the Triggers page

Open the account menu, your name or picture at the bottom of the sidebar, and choose Manage triggers.
2

Open the Trigger form

Select Write manually for a new Trigger, or select a Trigger and then Edit trigger.
3

Choose the agent

Under Agent, choose the agent, then select Create trigger or Save changes.
Each run then follows the agent’s instructions together with the Trigger’s own, and the Trigger’s details name the agent under Agent. A Trigger that Ari creates for you in a chat runs as Ari; to hand it to an agent, choose the agent in Edit trigger. For the rest of the Trigger form, see Schedule a report or a reminder with a Trigger.

Change an agent’s instructions, name, or icon

Ask Ari, for example “Add to Cash watch’s instructions: always show the 13-week view.” Or open the agent menu in a new chat, point at the agent, select Edit (the pencil), make the change, and select Save changes. New instructions apply from the agent’s next message or Trigger run. Chats you already had keep their history and stay with the agent.

Archive or restore an agent

Archive an agent you no longer use. Open the agent menu in a new chat, point at the agent, select Archive (the box), and confirm with Archive agent. Archiving also archives the agent’s chats and pauses its Triggers. The chat history is kept. cfo.ai has no way to delete an agent. To bring an agent back, open the agent menu, open the filter beside Chat with, and choose Archived. Point at the agent, select Restore, and confirm with Restore agent. The agent is available for new chats and Triggers again. Its earlier chats stay archived and its Triggers stay paused, so turn each Trigger back on in Edit trigger. You can also ask Ari to archive or restore an agent by name.

If something goes wrong

Only administrators can create or change agents. Ask an administrator of the workspace, or ask them to make you one; see Invite or remove teammates.
A Trigger whose agent is archived cannot be turned on; saving is refused with a message that says so. Restore the agent, or choose another agent under Agent, then turn the Trigger on again. For the message, see Trigger messages.
Each agent’s name must be different from every other agent’s in the workspace, and no agent can be named Ari. For the exact messages, see Agents.