Tools Reference
This reference documents every tool that agents can use, organised by category. Tools are the actions agents take during conversations — searching knowledge, sending messages, reading files, calling APIs, and working with integrations.
Built-in tools
Section titled “Built-in tools”These tools are available to all agents by default.
sprigr_search
Section titled “sprigr_search”Search your organisation’s knowledge bases using keyword and semantic search. Returns matching entries ranked by relevance.
Key parameters: query (search text), index (optional — target a specific knowledge base), limit (max results)
sprigr_write
Section titled “sprigr_write”Write a new entry to a knowledge base or update an existing one. Use this to store information the agent discovers during conversations.
Key parameters: index (target knowledge base), title, content, keywords (list of related terms for discoverability)
send_message
Section titled “send_message”Send a message to another agent. This is how agents collaborate — delegating tasks, asking questions, and sharing information.
Key parameters: agent (recipient agent name or ID), message (the content to send)
create_schedule
Section titled “create_schedule”Create a recurring scheduled task for the agent. The agent will automatically carry out the instruction at the specified time.
Key parameters: instruction (what to do), schedule (when to run, e.g. “every weekday at 9am”), name (descriptive label)
list_schedules
Section titled “list_schedules”List all active schedules for the current agent. Returns the name, instruction, and timing for each scheduled task.
delete_schedule
Section titled “delete_schedule”Remove a scheduled task so it no longer runs.
Key parameters: schedule_id (the schedule to remove)
list_task_blueprints
Section titled “list_task_blueprints”List available task blueprints — predefined templates for common workflows. Blueprints save time by providing a structured starting point.
get_task_blueprint
Section titled “get_task_blueprint”Retrieve the details of a specific task blueprint, including its steps and configuration.
Key parameters: blueprint_id
create_report
Section titled “create_report”Generate a formatted report from data the agent has collected. Reports can be sent to users, posted to channels, or saved to knowledge bases.
Key parameters: title, content, format (e.g. summary, detailed)
Companion-only tools
Section titled “Companion-only tools”These tools are exclusive to companion agents — the personal assistant provisioned for each user.
delegate_task
Section titled “delegate_task”Ask another agent to perform a task on your behalf. The companion handles the communication and returns the result.
Key parameters: agent (target agent), task (description of what needs to be done)
create_specialist
Section titled “create_specialist”Create a new specialist agent on the fly. The companion sets up the agent with an appropriate persona and tools based on your description.
Key parameters: description (what the new agent should do), name (optional agent name)
Workspace and files
Section titled “Workspace and files”Tools for managing the agent’s personal workspace and interacting with files.
workspace
Section titled “workspace”A personal scratchpad for the agent to store working notes, intermediate results, and context that persists across messages within a conversation.
Key parameters: action (read, write, append), content (text to store)
read_file
Section titled “read_file”Read the contents of an uploaded file. Supports documents, spreadsheets, and text files.
Key parameters: file_id
Manage files — list, upload, or retrieve files associated with conversations or the organisation.
Key parameters: action (list, get, upload), file_id (for get)
Web tools
Section titled “Web tools”Tools for accessing external websites and APIs.
Browse a website and extract content. The agent can navigate pages, read text, and pull information from public web pages.
Key parameters: url (the page to visit), instruction (what to look for)
http_request
Section titled “http_request”Make a direct HTTP request to an external API. Useful for integrations that do not have a dedicated tool.
Key parameters: method (GET, POST, PUT, DELETE), url, headers, body
code_execute
Section titled “code_execute”Run code snippets to perform calculations, data transformations, or custom logic during a conversation.
Key parameters: language (e.g. python, javascript), code (the code to run)
Workflow tools
Section titled “Workflow tools”Tools for managing multi-step workflows and team operations.
complete_workflow_step
Section titled “complete_workflow_step”Mark a step in a multi-step workflow as complete, optionally providing output data for the next step.
Key parameters: step_id, output (result data)
manage_team
Section titled “manage_team”A powerful tool with 40+ actions for managing your organisation. Actions include managing users, agents, teams, knowledge bases, integrations, and settings.
Key parameters: action (the specific management action), plus action-specific parameters
Integration tools
Section titled “Integration tools”When integrations are connected to your organisation or a specific agent, additional tools become available. Below is a summary of tools provided by each integration.
| Tool | Description |
|---|---|
gmail_search | Search emails by query, sender, date, or label |
gmail_read | Read the full content of a specific email |
gmail_send | Compose and send a new email |
gmail_reply | Reply to an existing email thread |
gmail_labels | List, create, or manage email labels |
Outlook Mail and Calendar
Section titled “Outlook Mail and Calendar”| Tool | Description |
|---|---|
outlook_search_mail | Search Outlook emails |
outlook_read_mail | Read a specific email |
outlook_send_mail | Send a new email |
outlook_reply_mail | Reply to an email thread |
outlook_list_events | List calendar events for a date range |
outlook_create_event | Create a new calendar event |
outlook_update_event | Update an existing calendar event |
Google Drive
Section titled “Google Drive”| Tool | Description |
|---|---|
drive_search | Search for files and folders in Google Drive |
drive_read | Read the content of a document or file |
drive_list | List files in a specific folder |
GitHub
Section titled “GitHub”| Tool | Description |
|---|---|
github_list_repos | List repositories for the connected account |
github_list_issues | List issues for a repository |
github_get_issue | Get details of a specific issue |
github_create_issue | Create a new issue |
github_list_prs | List pull requests |
github_get_pr | Get details of a specific pull request |
Gorgias
Section titled “Gorgias”| Tool | Description |
|---|---|
gorgias_list_tickets | List helpdesk tickets |
gorgias_get_ticket | Get details of a specific ticket |
gorgias_create_ticket | Create a new ticket |
gorgias_reply_ticket | Reply to an existing ticket |
simPRO
Section titled “simPRO”| Tool | Description |
|---|---|
simpro_list_jobs | List jobs and work orders |
simpro_get_job | Get details of a specific job |
simpro_list_quotes | List quotes |
simpro_get_quote | Get details of a specific quote |
simpro_list_schedules | List technician schedules |
simpro_get_schedule | Get a specific schedule |
Amazon Web Services integration provides approximately 30 tools covering common services:
| Category | Tools |
|---|---|
| S3 | List buckets, list objects, get/put objects |
| EC2 | List instances, start/stop instances, describe security groups |
| Lambda | List/invoke functions |
| CloudWatch | Get metrics, list alarms |
| IAM | List users, list roles |
| SES | Send email |
| SNS | List topics, publish messages |
Google Cloud Platform integration provides approximately 32 tools covering common services:
| Category | Tools |
|---|---|
| Compute | List instances, start/stop instances |
| Storage | List buckets, list/get/put objects |
| BigQuery | List datasets, run queries |
| Cloud Functions | List/invoke functions |
| Pub/Sub | List topics, publish messages |
| IAM | List service accounts, manage permissions |
| Logging | Query logs, list log entries |
Next steps
Section titled “Next steps”- Creating Agents — Create an agent and assign it the tools it needs.
- Agent Settings — Configure integrations and tool access for each agent.
- Companion Agents — Learn about the companion-only tools
delegate_taskandcreate_specialist. - Knowledge Bases — Understand how
sprigr_searchandsprigr_writeinteract with your knowledge bases.