Skip to Content
Docs

Named agents

Set up agents from templates, run them on a schedule or a trigger, and approve what they plan.

Named agents look into records on a schedule and plan the next step: a follow-up draft, a task, a note or a filled-in field. They never send anything. Drafts, tasks and notes wait for a person to approve them.

You'll find them under CRM → Agents.

Who can do what

CRM Admins set agents up, turn them on, pause and archive them. CRM Editors and Admins can describe a new agent with Build your own, and an admin reviews it before it runs. Planned actions are approved by the record's owner or a CRM Admin.

The templates

AgentRunsWhat it does
New-contact researcherEvery dayLooks into people added in the last two days: their current title, phone and LinkedIn address, and a short brief.
Job-change detectorEvery MondayRechecks people for a new job or company and plans a follow-up task for their owner when it finds one.
Stalled-deal nudgerWeekday morningsFinds open deals that have gone quiet, or quotes with no answer, and drafts a short follow-up email for the deal owner to approve.
Renewal watcherEvery MondayWatches a company's tracked expirations and plans a task for the owner as each one approaches, with a draft email if you want one.
Post-meeting summarizerNot on a scheduleReads what has been logged on a person or company and plans a short note and any follow-up tasks.

Schedules run in UTC. Each template card lists what the agent Can touch, what it Produces, its Cost and when it Runs. Agents only work on records everyone can see.

Set up an agent

Pick a template

On CRM → Agents, under Pick an agent to set up, select Set up on a template.

Adjust its settings

Each template has a few settings, such as Recheck each person every (days), Which deals or Look this far ahead (days). Select Continue. Nothing runs yet.

Review what it can do

The agent's page lists What it can do: which records it works on, how many per run, each thing it can do in plain words, and its limits.

Select Turn on

XODASH checks the agent before it turns on. If something is missing, such as a connected tool that hasn't been reviewed, you'll see "This version cannot be turned on yet" with a link to fix it. Turning it on also turns its schedule on.

You can have one agent per template. To start over, archive the agent and set it up again.

Change, pause or archive an agent

  • Settings: change a setting and select Save and switch to it. Every change makes a new version; versions in use are never edited. Versions lists them all, and you can open any to see what it could do and its Instructions (read only).
  • Schedule: select Turn schedule off or Turn schedule on.
  • Pause: no new runs start. A run that is already going finishes. Select Resume to start again.
  • Archive: retires the agent and turns its schedule off.

The agent's page shows what it spent this month and when it runs next. If the agent reaches its monthly spending limit, it pauses for the rest of the month. The Agent's workspace ceilings also apply.

Recent runs lists each run with the record, what happened and its cost.

Approve what agents plan

Planned actions appear under Waiting for you on CRM → Agents and on the agent's own page. Each shows the record, the agent and the content. Select Approve or Decline.

  • Email draft: approving creates a task for the owner holding the draft. It is not sent.
  • Task: approving creates the task for the record's owner.
  • Note: approving saves the note on the record, in your name.

Declining does nothing. The Stalled-deal nudger puts its drafts in the follow-up inbox on Approvals instead, where the deal owner reviews and sends them.

Other ways to start an agent

Under Other ways to start it, a CRM Admin can add:

  • When an activity is logged: enter an activity type, such as crm:email_received, and optionally a field and value to match. The agent runs at most once an hour for the same record. For example, to run the Post-meeting summarizer after each Zoom meeting, use crm:meeting_logged.
  • When another system calls: select Create webhook. XODASH shows an address and a secret once. Copy them right away. Creating it again with Make a new secret stops the old one.

For developers

Send a POST with JSON naming one shared record, such as {"entity_type":"company","entity_id":"…"}. Sign timestamp.raw body with HMAC-SHA256 using the secret, and send x-xodash-signature: sha256=hex and x-xodash-timestamp (seconds). Calls more than five minutes old or repeated are refused, and each webhook accepts 60 calls an hour. The body reaches the agent as data, never as instructions.

Build your own agent

Describe it

On CRM → Agents, under Build your own, select Describe an agent. Say what it should look at, when, and what it should produce, then select Start building.

Shape the draft

The builder drafts the agent as you talk. The draft shows what it can do and its limits. The builder can only choose from what XODASH allows, and it can't turn agents on or raise limits.

Test it with a dry run

Pick a record and select Run a dry run. The agent reads the record as you and shows what it would do. Nothing is changed, saved or sent. The test uses your own AI allowance.

Submit it for review

When the draft passes its checks, select Submit for review.

A CRM Admin then sees Waiting for your review on the agent's page, with What changed, the instructions and a dry run. The admin selects Approve and turn on, or writes a note and selects Send back.

Next steps

On this page