DocsAgents
Agents
An agent is a helper that works in the background. It uses your team's skills and tools, and asks before it changes anything.
Where agents live#
Open Agents in the sidebar. It has four tabs: Agents, Approvals, Queue and Runners. Each agent has its own page with a chat, its logs and its mailbox.
Who can use agents#
The Agents setting in each role decides:
- None
- Sees no agents.
- Use
- The default. Talks to the agents they are allowed to, and sees their own runs.
- Manage
- Creates, edits, pauses and deletes agents. Sees every run and approval.
Admins can always manage agents.
Create an agent#
- New agentPress New agent. Under Start from, pick Blank or a template:
- A/B test watcher: runs at 09:00 and 15:00 on weekdays.
- Inbox triage: every 30 minutes during work hours, and when email arrives. It never sends mail.
- Weekly client report: Mondays at 08:00.
- Name itGive it a Name and a Short name. The short name goes in its email address and its page link.
- Describe the jobUnder The job, write its role and rules in plain words, like a brief to a new colleague.
- Add skillsUnder Skills, add playbooks from your library. The agent follows them like your team does.
- Pick tools and approvalsSee Tools and approvals.
- Choose when it runsSee Triggers.
- Choose who can talk to itSee below.
You can also set Commands, Limits and engine, a Precheck script and an Avatar.
Who can talk to it#
- Everyone in Homla
- The default. Everyone in your workspace.
- Specific people
- Only the people you list.
- Anyone
- Including people outside Homla, for example by email. Their requests never act without approval.
A Blocked list keeps out anyone you name.
Commands#
Give an agent up to 25 commands, typed as /name in its chat. /help and /new are built in.
Limits#
- Automatic runs a day
- From 1 to 1,440. Leave it empty for no limit.
- Minutes a run
- From 1 to 240. The default is 15.
Chat and Run now are never limited.
Run history#
The agent's Logs show Runs, with their status (Done, Failed, Missed, Running now, Waiting for a computer), and an Audit of every tool call made as this agent.
Pause or delete#
Pause stops its schedules and triggers until you resume it. Deleting asks Delete <name>? Its access, schedules and history are removed.
Agents never take a seat on your plan.