A tool is one specific thing the agent can do during a conversation: list a schema, run a SQL query, send an email, post to Slack, build a chart, save an analysis. Whenever the agent uses one, you'll see a tool card show up in the chat. Some have their own custom UI, the rest fall back to a small generic card with the call inputs and the result.

Which tools an agent has depends on two things:

  1. The permissions you switched on for it.
  2. The blocks (SQL queries, email templates, Slack messages, Tableau views, Google Slides decks) you shared with it.

The rest of this page is the full list, grouped by what the tool actually does.

At a glance

Database
Browse schemas and tables, sample columns, and run SQL.
Knowledge
Search the knowledge base and read individual entries.
Metrics
Save and query reusable metrics views.
Analysis
Save full analysis documents with text, queries, and charts.
Charts
Turn results into interactive Plotly charts.
Email
Compose and send emails, with attachments and embedded charts.
Slack
Post messages to channels or reply in a thread.
Tableau & Slides
Search Tableau, export views, update Google Slides decks.
Reports
List, read, write, schedule, and run PushMetrics reports.
Conversation
Ask follow-up questions, post status, stay quiet when needed.
Recipients
Look up people in the contact list and add new ones.
Memory & Library
Read and write memory files, list and edit library content.

Database tools

Always available, the agent's first stop before writing SQL.

Tool What it does
list_schemas List the schemas in a database.
list_tables List tables in a schema.
describe_table Show columns, types, and metadata for one table.
batch_describe Describe several tables in one call. Saves round trips.
search_tables Find tables whose name matches a pattern.
select_star Pull a handful of sample rows so the agent knows what the data really looks like.
check_table_exists Confirm a table exists before referencing it in SQL.
get_column_values Look at the distinct values in one column.
get_all_column_values Same idea, for every column at once. Useful for understanding categorical fields.
list_function_names List the SQL functions the database supports.
apply_sql_limit Wrap a query with a LIMIT if one is missing.
detect_columns Figure out which columns a query references. Helps when validating against the schema.
run_sql Run the final SQL against the right database. Only read queries are accepted (SELECT, WITH, EXPLAIN, SHOW, DESCRIBE, DESC, VALUES). The agent gets back an inline preview (up to ~10k characters) plus a CSV download link if the result is bigger.
💡
Don't be surprised if the agent spends a turn or two looking around before running a query. It's checking columns and types so the SQL is right the first time.

How a SQL run works

1. AGENT WRITES picks the database drafts the SQL 2. READ-ONLY CHECK SELECT / WITH / EXPLAIN writes are rejected 3. RUNS 120s timeout CSV capped at 50k rows 4. RESULTS ~10k char preview CSV download URL

Knowledge tools

Available when the Knowledge permission is on. Used to ground answers in your team's documented facts.

Tool What it does
search_knowledge Find the most relevant knowledge entries for a question. Returns the top matches with snippets.
read_block Open one knowledge entry to read its full content.
list_blocks List every knowledge entry the agent can see.
📇
When a conversation starts the agent already gets a small index of the knowledge entries it has access to, so it knows what's available before it searches.

Metrics tools

Available when the Content permission is on. Metrics views are reusable definitions of measures and dimensions, stored as blocks.

Tool What it does
save_metrics_view Define a new metrics view: a model SQL plus measures, dimensions, optional time grain, parameters, and thresholds.
list_metrics_views Show every metrics view the agent can see.
query_metrics Pull numbers out of a metrics view. Pick measures, dimensions, filters, a time range, and a time grain. The tool generates the SQL behind the scenes and runs it.

Tableau tools

Tableau is a little different from the rest. The tool names are dynamic: each Tableau block you share with the agent gets its own pair of tools, named after the block. So if you share a block called "Sales Dashboard", the agent sees search_tableau_sales_dashboard and export_tableau_sales_dashboard. The suffix is a slugified, lowercased, max-20-character version of the block name.

Tool What it does
search_tableau_<slug> Search the Tableau site connected to that block for workbooks or views by keyword.
export_tableau_<slug> Export a view as an image, PDF, CSV, Excel, or crosstab, or export a workbook as PDF or PowerPoint. Filters can be applied.
🧩
The agent only ever sees Tableau sites you've explicitly shared with it. There's no general "any Tableau" tool.

Slack tools

Tool What it does
send_slack_message Post a Slack message using one of the Slack blocks shared with the agent. The block decides the workspace and default channel; the agent picks which block to use via an integration parameter when more than one is shared.

There's only ever one send_slack_message tool no matter how many Slack blocks you share. The agent picks the right one at call time.

Email tools

Tool What it does
send_email Send an email using one of the email blocks shared with the agent. Can include CSV attachments, charts as images, and arbitrary file attachments. The agent picks which email block to use via an integration parameter.

Same pattern as Slack: one send_email tool, multiple shared blocks selected at call time.

Analysis tools

Available when the Content permission is on. For writing the long-form output of a piece of work.

Tool What it does
save_analysis Save a full analysis document. Markdown text plus references to SQL queries and charts. Renders as a proper page you can share with the team.

Chart tools

Tool What it does
generate_chart Build an interactive Plotly chart from data. The agent passes a Plotly JSON spec and an optional source SQL result.

Google Slides tools

Same dynamic-naming pattern as Tableau: each Slides block you share with the agent gets its own tool, named after the block.

Tool What it does
google_slides_action_<slug> Add a slide, drop in a chart, edit text on a slide, or rearrange the deck. The <slug> part comes from the block name.

Reports tools

Available when the Reports permission is on. The agent can work with PushMetrics reports start to finish.

Tool What it does
list_reports Show reports in the workspace, with optional search.
list_folders List report folders.
get_report_yaml Open a report and read its full YAML setup, including blocks, schedule, and recipients.
create_report_yaml Create a brand new report from YAML.
update_report_yaml Update an existing report.
preview_schedule Show the next few times a recurrence rule (RRULE) would fire. Sanity-check before saving a schedule.
run_report Trigger a one-off report run right now.
get_report_run_status Check whether a run is still going, finished, or failed.

Conversation tools

Available when the matching permission is on. A scheduled run gets none of these.

Tool What it does
ask_user_question Pause and ask the user a question, with optional multiple-choice buttons.
send_interim_reply Post a quick "still working on it..." update so the user knows what's happening.
no_response In a busy Slack thread, decide a message wasn't meant for the agent and stay quiet.

Recipient tools

Tool What it does
search_recipients Look up someone by name or tag. Returns their email and Slack handle.
add_recipient Add a new contact to the workspace recipient list.

Library tools

Skills, knowledge entries, analysis documents, and metrics views all live as blocks in the workspace. The agent reads and writes them with the same four tools.

Tool What it does
list_blocks List blocks of a given type (skill, knowledge, analysis, metrics_view, etc.).
read_block Read the full content of one block by UID.
create_block Create a new block of the given type.
edit_block Update an existing block.

Memory tools

The agent's private notebook, scoped to /memories/. Available when the Content permission is on.

Tool What it does
read_file Open one of the agent's saved memory files.
write_file Create a new memory file.
edit_file Update an existing memory file.

See Memory & Knowledge for when memory wins over knowledge entries (and the other way around).

What tools do I have right now?

Every agent has one extra tool, list_tools, that returns its own toolbox. So if you ask "what can you do?" or "what reporting tools do you have?", the agent will check and tell you. Filter by category (sql, email, slack, tableau, kb, memory, skill, db, analysis, report, interaction) to narrow the answer.