Open an agent's page to see its To-do and Activity, change where it works and what it may do, or find out why it is not available yet.
Before you start
- AI Agents access. To open the To-do and Activity tabs, your role needs AI Agents access.
- AI Agents with Manage permission. To open the Settings tab, change settings, or pause and turn an agent on, your role needs AI Agents with Manage permission.
- Only the Assistant is released. The Assistant has its own home page, not an agent page. Every other agent shows Coming soon, so no agent has tabs yet.
Agent states
The page shows one state for each agent. The state decides whether the tabs appear.
- Coming soon. The page says "This agent is not available yet. Ask to be told when it is ready." Click Tell me when it is ready to be told later. There are no tabs.
- Not on your plan. The page says "This agent comes with the Agents add-on." or "This agent runs on the AI Assistant add-on." Members with Billing with Manage permission see See plans. Other members see "Ask a workspace owner to add it." There are no tabs.
- Turned off in Plugins. The page says "AI Agents is turned off for this workspace in Settings, Plugins." Members with Plugins with Manage permission see Open plugins. Other members see only "Ask a workspace owner to turn it on." There are no tabs.
- Not set up. The page says "On your plan, not set up yet." Click Set it up to open the Settings tab. Members who cannot manage agents see a note to ask a workspace owner. There are no tabs.
- Off. The page says "It starts no new work. Its log and its settings are kept." The To-do, Activity and Settings tabs remain. Members who manage agents see the turn-on controls in the state card.
- Ready, Active or Paused. The agent is running. The To-do and Activity tabs appear. The Settings tab appears only for members with AI Agents with Manage permission.
The status badge in the page header shows the same state, with the labels Coming soon, Not on your plan, Turned off in Plugins, Ready, Not set up, Active, Paused or Off.
To-do tab
The To-do tab lists what waits on you from this agent. Each item is one proposal from the agent. Approve an item, snooze it until tomorrow morning, for 3 days or for a week, or click Don't do it. Use Waiting on you in the sidebar to see items from every agent.
When the agent is running, its header shows pause controls for members who manage agents:
- Pause for 30 minutes, Pause for 2 hours, Pause until tomorrow, 8:00 AM, or Pause until I turn it back on.
- While paused, the page shows "Paused until {time}" or "Paused until someone turns it back on", and says that nothing new starts. Items already waiting stay in Waiting on you.
- Resume now or Turn it back on ends the pause.
Activity tab
The Activity tab lists everything this agent proposed and did, and who decided. It shows the agent's entries from the agent activity log. Each entry records a change to the agent, such as:
- "Set up the agent"
- "Changed where the agent works or who hears about it"
- "Set {actionKey} to {level}"
- "Paused the agent" and "Turned the agent back on"
- "Turned the agent off; waiting items expired: {expiredCount}"
When the agent has no entries yet, the page says "When your agents propose or do something, it shows up here."
Settings tab
Members who manage agents see the Settings tab.
Before the agent is set up, the tab shows Set up this agent. It says "Choose where it works and who hears about it. Every action starts at Ask me first." Fill in Where it works and Watchers, then click Set up the agent. The page then shows "The agent is set up. It asks you before every action."
After the agent is set up, the tab has three sections:
- Where it works. Choose All properties (count) or Only the properties I choose. If you choose specific properties, pick them under Properties it works on. Choose Watchers, the members who hear about what waits on the team and what the agent did. Click Save. The page confirms "Saved."
- What it may do. Each action has a Supervision level. The page lists the levels Ask me first, Act and tell me and Act on its own. For now, every action asks first. The page says that the other two levels become available when agents can act on their own. You can add a rule under Always ask when… that makes the agent ask more often. A rule compares a Fact with a Comparison and a Value. A rule can never make the agent ask less often. Some actions always ask first, and their supervision cannot be changed.
- Turn this agent off. Click Turn off {agent}, then confirm. The agent stops starting new work, its waiting items expire, and its log is kept. You can turn it back on later.
The Settings tab does not hold the pause controls. Those are in the page header.
Common problems
- "Someone changed this agent since you opened the page. Reload and try again." Reload the page, then make your change again.
- "You do not have permission to change this agent." Ask a workspace owner for AI Agents with Manage permission.
- "This agent is not available yet." The agent is not released. Use Tell me when it is ready.
- "This agent is not on your plan or is turned off." Check the agent's state. See the agent states above.
- "This action always asks first. Its supervision cannot be changed." Some actions always ask first. No setting changes them.
- "Choose at least one property." Choose a property, or choose All properties.
- "Every property is chosen, so leave the property list empty." When you choose all properties, clear the property list.
- "This change is not allowed. Check the values and try again." Check the rule values, such as the number in a rule.
- "Your change could not be saved. Try again." Try again.
- "This agent has no settings here." Some agents are set up in another part of Rentsera. Open the area the page names.
Related articles