Skip to Content
Docs

The Agent

What the Agent does, how to turn it on, pause it and cap its spending, and how to work with it on a record.

The Agent researches your people and companies for you. It fills blank fields it can back up with evidence, proposes everything else for a person to accept, asks you when only a person can answer, and lets you chat about a record. It never changes a value a person typed, and it waits for your approval before it changes anything from a chat.

The Agent is off until a CRM Admin turns it on for the workspace.

Turn the Agent on

Who can do this

Only CRM Admins can see or change the Agent settings. Everyone else sees "Only CRM admins can view or change the Agent settings."

Open the Agent settings

Go to Settings → CRM and open the Agent tab.

Set a monthly spending ceiling

Under Agent is off, enter a Monthly spending ceiling (USD). Leave it blank for no ceiling.

Select Turn on

XODASH asks you to confirm, for example "Turn on with a $25 monthly ceiling?" Select Confirm.

Choose what starts the Agent

Under What starts the agent, switch on the events you want it to act on. Each switch takes effect right away. See Research and suggestions.

The Agent uses your workspace's AI allowance and, for some lookups, Apollo credits. That's why it only runs once you turn it on.

Pause, resume or turn it off

On the Agent tab, a CRM Admin can:

  • Select Pause to stop new work at once. A run that is already going finishes. A banner shows who paused it and when. Select Resume to start again.
  • Select Turn off to switch the Agent off entirely.

While the Agent is paused or off, it starts no research, and the Agent section on each record says so.

Spending ceilings and the monthly total

The top card shows Spend for the current month (UTC) against two ceilings:

  • AI spend: dollars of AI use, against the Monthly AI ceiling (USD, blank for none).
  • Vendor calls (Apollo and similar): lookups at outside data vendors, against the Monthly vendor-call ceiling (blank for none).

Vendor calls per task (1–50) limits how many vendor lookups a single piece of research can make.

The monthly total counts the work the Agent does on its own: research it starts itself, named agent runs, and the sender's signature it reads when someone uses Add to XODASH in the Outlook add-in.

When either ceiling is reached, the Agent stops until the month rolls over (UTC) or you raise the ceiling. The settings page shows "The monthly spending ceiling has been reached." or "The monthly vendor-call ceiling has been reached."

Your own allowance

Research you ask for on a record and chats about a record run as you. They come out of your own Assistant allowance, not the Agent's monthly total. If your plan sets a per-person limit, you'll see it under Settings → Assistant as Your hosted cap (this month). You can't ask for research while the Agent is off, paused or over a ceiling.

Check what the Agent is doing

The Status card on the Agent tab shows Waiting, Running now, Runs today and Last run, and a table of recent runs with the record, why it ran, the outcome and the cost.

If several runs in a row fail, the card shows a warning with the last error. Recent changes lists every change to the Agent settings and who made it.

Behavior settings

  • Autonomy: Fill blanks, propose the rest or Propose everything.
  • Evidence needed to fill a blank: Probable or better or Verified only.
  • When Apollo disagrees with a value: Ignore it or Propose the change.
  • Tracked fields: the people and company fields the Agent looks after. Stage (suggested only) is never written by the Agent; it can only suggest it.

Select Save to keep your changes.

What the Agent never does on its own

  • It never overwrites a value a person typed. It proposes a change instead.
  • It never works on a private record by itself. The record's owner can still ask for research by hand.
  • It never sends email. Drafts, tasks and notes it plans wait for a person to approve them.
  • It never changes anything from a chat without your approval.
  • It never sets a company's stage. It can suggest one, and a person decides.

To check a contact's job title, the Agent may read the last lines (the signature) of a message that contact sent to a connected Outlook mailbox. A member can keep their mailbox out by switching off Sync email on their Outlook connection.

The Agent on a record

People and companies have an Agent panel beside the record. You can collapse it to a slim rail; it then shows how many items are waiting for you. A deal has an Agent tab with the chat only.

The panel shows, from top to bottom:

  • Where the Agent stands: off, paused, queued (with the reason), working, done, or "The agent hasn't looked at this record yet." CRM Editors and Admins can select Research now, Research again or Try again.
  • Brief: a short summary the Agent wrote about the record.
  • Needs you: questions the Agent asked and changes it suggested, each decided right there.
  • What the agent did and Coming up: what it did and any research it has planned. An editor can Cancel planned research that hasn't started.
  • Ask about the record: the chat.

Answer the Agent's questions

When only a person can answer something, the Agent asks under Needs you. Pick an option or type an answer and select Answer, or select Dismiss. After you answer, the Agent looks at the record again with your answer in mind. A question about whether two records are the same person is decided on the duplicate review.

Chat about a record

Type a question under Ask about, or pick a suggestion such as "What is missing on this record?" The Agent can read the record and search your CRM. When the Agent is on, it can also look things up on the web and in Apollo.

When the Agent wants to change something, the chat stops and shows Needs your OK with what it wants to do in plain words and Exact details. Select Approve or Decline. If you decline, nothing is changed. Only one change waits at a time, and an unanswered request expires after 24 hours.

Roles

Chatting and approving changes need the CRM Editor or CRM Admin role. CRM Viewers can read the chat but can't send messages or approve changes.

The inbox

Everything waiting for a person is collected on CRM → Approvals. See Approvals.

Next steps

On this page