AI Agents use tools to take actions — querying databases, sending messages, creating charts, and more. The available tools depend on the agent's configuration and the blocks shared with it.

Tool Categories

AI Agent Database SQL, schema, tables Email Send & compose Slack Messages & alerts Charts Plotly visualizations Tableau & Slides Recipients & Memory

Database Tools

These tools are always available and let the agent explore and query your connected databases.

Tool Description
list_schemas List available databases and schemas
list_tables List tables in a schema
describe_table Get column names, types, and details for a table
select_star Preview sample data from a table
check_table_exists Verify whether a table exists
get_column_values Sample distinct values from a column
search_tables Find tables by name pattern
batch_describe Describe multiple tables at once
list_function_names List available SQL functions
💡
The agent uses these tools to understand your data schema before writing queries — it explores tables, checks column types, and previews data to write accurate SQL.

Block Tools

Blocks are the core executable tasks in PushMetrics (SQL queries, email templates, Slack messages, charts, Tableau exports, Google Slides). When blocks are shared with an agent, they become tools the agent can run.

For each assigned block, the agent gets a run tool (e.g., run_weekly_sales_query) that executes the block with optional parameter overrides.

SQL Blocks
Run queries, receive results as interactive tables with CSV download.
Email Blocks
Send emails with customizable recipients, subject, and body.
Slack Blocks
Send formatted messages to configured Slack channels.
Chart Blocks
Generate interactive Plotly charts, export as images for email/Slack.
Tableau Blocks
Search workbooks, apply filters, and export views.
Google Slides
Update presentations with fresh data and charts.

Block Management Tools

Tool Description
read_block Read the configuration and content of a block
create_block Create a new block (SQL query, email template, etc.)
edit_block Modify an existing block's content or settings

These tools let the agent create and refine blocks during a conversation — for example, writing a new SQL query, testing it, then saving it as a reusable block.

Interaction Tools

Tool Description
ask_user_question Pause and present the user with a question (multiple choice or open text)
send_interim_reply Send a status update while the agent continues working
no_response In multi-user threads, the agent can decide not to respond
💡
The ask_user_question tool is only available if the "Ask User Question" permission is enabled in the agent's configuration.

Recipient Tools

Tool Description
search_recipients Find recipients by name or tag, returns contact details and destinations
add_recipient Create a new recipient with email and/or Slack destinations

Analysis & Utility Tools

Tool Description
save_analysis Create a formatted analysis document with markdown, charts, and visualizations
list_tools List all available tools, optionally filtered by category (sql, email, slack, tableau, chart, db, memory, skill, block, analysis)