Skip to main content
Tools define the actions an agent can take while answering a question. The agent configuration page covers how to add and remove tools on a given agent. This page is the catalog of every tool Circuit supports, grouped by category, with example use cases for each.
The tools available on a particular agent depend on its domain and configuration. Some tools also require additional setup, for example an integration must be connected before its tool can be used.

Search and discovery

ToolWhat it doesExample uses
SearchFinds relevant content across the agent’s reference scope.Pull policy guidance from a procedures index; locate product manuals that mention a specific error code.
EventSearchSearches business events recorded in indexed content (such as trainings, deadlines, promotions, maintenance windows, or product launches) within a date range, optionally filtered by event type.Find upcoming product trainings and deadlines this month; surface a current promotion to mention in a customer reply; list maintenance windows scheduled for next week.
CircuitReports what the agent can see: which workspaces and indexes it has access to, which other agents are available for hand-off, and what those agents can do.Confirm the agent is searching the right index before answering; show the user a list of agents they can hand off to.

Reading files and documents

ToolWhat it doesExample uses
ReadReads a file from the agent’s working area. Handles text, images, and PDFs.Open an uploaded contract to inspect a specific clause; re-read a draft the agent generated earlier.
ReadPDFReads PDF files page by page. Extracts text and images and supports content search within the document.Pull the diagram from page 12 of an installation manual; locate the warranty section in a 200-page product spec.
ReadOfficeReads Office files (.xlsx, .xlsm, .pptx, .docx). Extracts text and images, supports content search, and runs SQL queries against worksheet data.Pull figures from a quarterly financials spreadsheet; extract speaker notes from a deck.
ReadCADReads 3D CAD files in STEP and IGES format. Returns a summary, component names, assembly topology, and rendered views of individual components.List the parts in a customer-submitted assembly; render a component image to confirm with the user.
LSLists files and folders at a given location.Show the user what files are in their working folder.
GlobFinds files matching a filename pattern (for example, **/*.md to match any Markdown file in any subfolder).Locate every PDF in a project folder; find every draft document in a customer’s working area.
GrepSearches a text file for a pattern. Supports regular expressions.Find every line in a log file that mentions a given error code; locate references to a customer name across notes.

Writing files and documents

ToolWhat it doesExample uses
WriteWrites a file to the agent’s working area. Overwrites the file if it already exists.Save a generated quote into a customer folder; write a summary report the user can download.
EditReplaces an exact piece of text in an existing file with new content.Update one field in a generated proposal without rewriting the whole document.
WriteOfficeWrites values into Excel cells or paragraphs in Word documents. Can also create new Office files.Fill in a customer-information template (Word); update prices in a quote spreadsheet (Excel).
ConvertPDFConverts a Markdown file into a PDF.Turn a generated proposal into a PDF for the customer; export an internal report for sharing.
FSUtilsMoves files, copies files, and creates folders.Organize generated outputs into per-customer folders; archive completed work.
ArtifactPresents one or more files in the chat as an interactive artifact card the user can click to view or download.Present the proposal the agent just generated so the user can review and download it.

Data and analytics

ToolWhat it doesExample uses
CSVQueryRuns SQL queries against CSV files.Aggregate sales by region from an exported CSV; find the top 10 customers in a leads export.
NestedLoopsLoads CSV and spreadsheet data and runs SQL across multiple sources, including content-based similarity matching.Join an orders export with a customers export to answer questions that span both; find similar product descriptions across two catalogs.
GraphQueryRuns queries against a graph database using the Cypher query language.Trace a customer’s relationships across linked accounts and contacts; find every company connected to a given supplier.

Web

ToolWhat it doesExample uses
WebFetchRetrieves and processes content from a URL.Pull a competitor’s pricing page; read a public RFP posted online.
WebSearchRuns a web search and returns the results.Find recent news about a customer’s industry; look up a vendor’s public documentation.

Tasks and orchestration

ToolWhat it doesExample uses
TaskCreateCreates a task in the current chat’s task list.Break a complex troubleshooting request into ordered steps the agent will work through; track an RFP response across many sub-questions.
TaskUpdateUpdates a task’s status, subject, description, or dependencies.Mark a sub-task complete and unblock dependent tasks.
TaskGetRetrieves the full details of a task by ID.Recall a task’s full description before resuming work on it.
TaskListLists every task in the current chat’s task list.Show the user everything the agent is currently working on.
AgentLaunches a sub-agent to handle a focused multi-step task on behalf of the parent agent.Spin up a researcher to read through a large index while the main agent keeps replying to the user.
RWLoopRuns a sub-agent repeatedly with the same prompt across a batch of inputs.Apply the same enrichment prompt to every row in a 200-row spreadsheet.
SkillExecutes one of the agent’s configured skills.Run a saved “warranty lookup” workflow whenever the user provides a serial number.
In-chat tasks created with TaskCreate are scoped to a single chat. They are not the same as work items, which persist across chats.

User interaction

ToolWhat it doesExample uses
AskUserQuestionAsks the user a question with predefined answer choices.Confirm which of three product variants the user means; let the user pick a quote template before generation.

Code execution

ToolWhat it doesExample uses
BashRuns shell commands in an isolated environment.Run a one-off script to reformat a CSV; perform a calculation that is easier to express in code.

Business systems

ToolWhat it doesExample uses
SalesforceReads and writes Salesforce records, looks up object structure, and runs SOQL and SOSL queries.Look up an account before drafting a follow-up email; create an opportunity directly from chat.
DynamicsMicrosoft Dynamics 365 CRM. Query, create, and update records.Pull recent activities on a customer record; update a lead’s status after a call summary.
HubspotHubSpot integration. Sends an email to a HubSpot contact.Reply to a customer who submitted a HubSpot form; send a follow-up email after a feedback collection conversation.
OutlookMicrosoft 365 Outlook. Read, search, and draft email.Find emails from a customer about an open deal; draft a reply for the user to review.
GoogleWorkspaceGmail, Google Calendar, and Google Contacts. Read, search, and draft.Schedule a follow-up meeting on the user’s calendar; find email threads about a project.

Construction

ToolWhat it doesExample uses
BluebeamBluebeam Studio access. Manage sessions, projects, files, markups, and annotations.Add markups during a drawing review; pull annotations from a project file into a summary.
TakeoffPerforms construction takeoffs on PDF drawings. Identifies symbols in the drawing legend and finds every occurrence on the drawing.Count every duplex receptacle on a floor plan; quantify symbols across a 50-sheet drawing set.