capabilities array on defineAgent. Each entry is a capability slug (or a { slug, config } object for ones that take options):
agents/researcher.ts
webSearch, memory, document (Canvas), suggestedActions, action, file, model, documentationSearch, sandbox, and context. The sections below explain the most common ones and when to enable them.
file and model are also enabled automatically when files or models are attached to the Agent, so you rarely list those by hand. file covers listing, reading, searching and analysing files — analysing runs code over them in a sandbox, which is what the separate codeInterpreter slug used to do.
Available capabilities
Memory
Memory allows Agents to retain and recall information across interactions, enabling personalization and continuity.Web Search
Gives Agents access to real-time information from the internet. When to enable:- Account research requiring current market data
- Validating company information that may have changed
- Finding recent news, funding announcements, or leadership changes
“What is the latest funding round for Acme Corp?”
Canvas
Enables Agents to generate structured, shareable digital assets. The capability slug isdocument (surfaced as Canvas in the web app).
Supported outputs:
- Spreadsheets and CSV files
- Text documents
- Formatted reports
Suggested Actions
A proactive assistant that recommends the next best step after completing a task. How it works:- Agent completes the requested task
- Analyzes what logical next steps might help the user
- Offers actionable suggestions
“Would you like me to add these contacts to Sequence XX?” “Should I enrich these contacts with email addresses?”
Suggested Actions keep workflows moving and help users discover capabilities
they might not have thought to request.
Actions
action lets the Agent search and run any action in the workspace, instead of only the ones you attached in uses. It is the same four steps Cargo’s MCP server exposes, running inside the Agent: search the catalog, read the action’s input schema, resolve any field that needs a picked id, then execute — over one record or a batch.
agents/operator.ts
- Open-ended operator Agents, where you cannot predict which integration a request will need
- Exploratory work, where pinning every candidate action ahead of time is impractical
Models
model gives the Agent your data models: list them, read their columns, search records, and run read-only SQL.
It has two widths on the same slug:
- Enabled on its own — every model in the workspace, read-only.
- With models attached to the Agent — only those, with each attachment’s filter, column selection and row limit re-applied on every call. This is also the only way to allow writes, by attaching a model that is not read-only.
model by hand unless you want the whole-workspace read.

