AI Agent Tool Reference
Professional+
The Calabi AI Agent has access to 117 tools organized across 8 categories. Each tool is a discrete capability that the Agent calls automatically based on your question — you never invoke tools directly. This reference documents every tool, its purpose, and an example question that would cause the Agent to use it.
Tool Categories
| Category | Tools | Description |
|---|---|---|
| Calabi Catalogue Tools | 22 | Asset search, lineage, quality, glossary |
| CalabiIQ Tools | 18 | Chart generation, dashboard management, SQL execution |
| Calabi Connect Tools | 12 | Connector status, sync history, schema inspection |
| Calabi Pipelines Tools | 16 | DAG status, run history, log retrieval |
| Calabi Transform Tools | 14 | dbt model lineage, run results, test outcomes |
| Calabi ML Tools | 13 | Experiment tracking, model registry, artifact access |
| Calabi Automate Tools | 11 | Workflow status, trigger management, execution history |
| AI Builder Tools | 11 | Chatflow status, agent deployment, embedding config |
| Total | 117 |
Calabi Catalogue Tools
| # | Tool Name | Description | Example Question |
|---|---|---|---|
| 1 | catalogue_search_entities | Full-text search across all asset types (tables, dashboards, topics, pipelines, ML models). | "Find assets related to customer churn." |
| 2 | catalogue_get_table | Retrieve full metadata for a specific table: columns, tags, owner, description, quality summary. | "Tell me about the fact_orders table." |
| 3 | catalogue_list_tables | List all tables in a schema or database, optionally filtered by tag or owner. | "List all tables in the prod.sales schema." |
| 4 | catalogue_get_column | Retrieve metadata for a specific column: type, description, tags, sample values, quality results. | "What does the customer_id column in fact_orders contain?" |
| 5 | catalogue_get_lineage | Retrieve upstream and downstream lineage for any asset (table, dashboard, pipeline). | "What feeds into the revenue_summary dashboard?" |
| 6 | catalogue_get_owner | Look up the owner (user or team) of a data asset. | "Who owns the dim_customers table?" |
| 7 | catalogue_list_quality_tests | List all data quality tests defined for an asset. | "What quality tests are configured for fact_orders?" |
| 8 | catalogue_get_quality_results | Retrieve the latest quality test results for an asset. | "Did fact_orders pass its quality checks today?" |
| 9 | catalogue_list_failing_tests | List all assets with currently failing quality tests across the platform. | "Which tables have failing data quality tests right now?" |
| 10 | catalogue_search_glossary | Search the data glossary for term definitions. | "What does 'Monthly Active User' mean according to our glossary?" |
| 11 | catalogue_get_glossary_term | Retrieve full details for a specific glossary term. | "Show me the full definition and related assets for 'ARR'." |
| 12 | catalogue_list_glossary_terms | List all glossary terms, optionally filtered by domain or tag. | "What glossary terms are defined in the Finance domain?" |
| 13 | catalogue_list_pii_assets | List all assets tagged with PII classification. | "Which tables contain PII data?" |
| 14 | catalogue_get_tags | List all tags applied to an asset. | "What tags does the users table have?" |
| 15 | catalogue_tag_asset | Apply a tag to a data asset. | "Tag the raw_events table as 'Needs Review'." |
| 16 | catalogue_update_description | Update the description of a table or column. | "Set the description of user_id in dim_customers to 'Unique identifier for each registered user'." |
| 17 | catalogue_get_usage | Retrieve usage statistics for an asset (query count, unique users, last accessed). | "How often is the fact_revenue table queried?" |
| 18 | catalogue_list_domains | List all configured data domains. | "What data domains are defined in Calabi Catalogue?" |
| 19 | catalogue_list_assets_in_domain | List all assets belonging to a specific domain. | "What assets are in the Finance domain?" |
| 20 | catalogue_suggest_owner | Suggest a likely owner for an un-owned asset based on query history. | "Who should own the marketing_attribution table?" |
| 21 | catalogue_get_schema | Retrieve the full column schema of a table. | "What columns does the fact_sessions table have?" |
| 22 | catalogue_list_dashboards | List dashboards registered in the catalogue, with owner and quality info. | "Show me all dashboards owned by the Data team." |
CalabiIQ Tools
| # | Tool Name | Description | Example Question |
|---|---|---|---|
| 23 | calabiiq_run_sql | Execute a SQL query against the connected data warehouse and return results. | "How many orders were placed yesterday?" |
| 24 | calabiiq_create_chart | Generate a new chart (bar, line, pie, scatter, big number) from a SQL query. | "Show me a bar chart of revenue by region." |
| 25 | calabiiq_get_chart | Retrieve an existing chart's definition and last-rendered data. | "What data is the 'Daily Active Users' chart showing?" |
| 26 | calabiiq_list_charts | List all charts in a dashboard or across the workspace. | "What charts are on the Executive dashboard?" |
| 27 | calabiiq_update_chart | Modify an existing chart's query, filters, or visualization type. | "Change the 'Revenue by Region' chart to a line chart." |
| 28 | calabiiq_delete_chart | Delete a chart from a dashboard. | "Remove the 'Old Orders' chart from the Operations dashboard." |
| 29 | calabiiq_create_dashboard | Create a new empty CalabiIQ dashboard. | "Create a new dashboard called 'Q2 2026 KPIs'." |
| 30 | calabiiq_get_dashboard | Retrieve a dashboard's metadata and list of charts. | "What's on the Sales Performance dashboard?" |
| 31 | calabiiq_list_dashboards | List all dashboards, optionally filtered by owner or tag. | "Show me all dashboards created this month." |
| 32 | calabiiq_add_chart_to_dashboard | Add a chart to an existing dashboard. | "Add the revenue chart to the CFO dashboard." |
| 33 | calabiiq_export_chart_data | Export the data behind a chart as CSV or Excel. | "Download the data from the 'Monthly Revenue' chart as a CSV." |
| 34 | calabiiq_export_dashboard_pdf | Render an entire dashboard as a PDF for sharing or archiving. | "Export the Executive dashboard as a PDF." |
| 35 | calabiiq_get_dataset | Inspect a saved dataset (virtual table) definition. | "What SQL defines the 'Revenue by Customer' dataset?" |
| 36 | calabiiq_list_datasets | List all saved datasets in the workspace. | "What datasets are available in CalabiIQ?" |
| 37 | calabiiq_list_saved_queries | List all saved SQL queries in the SQL Lab. | "What saved queries exist for the Finance team?" |
| 38 | calabiiq_get_query_results | Retrieve the results of a previously run or saved query. | "Show me the results of the 'Weekly Revenue' saved query." |
| 39 | calabiiq_apply_filter | Apply a time range or dimension filter to a chart's query. | "Filter the revenue chart to show only the last 90 days." |
| 40 | calabiiq_set_chart_color | Update a chart's color scheme or palette. | "Change the revenue chart colors to the corporate blue palette." |
Calabi Connect Tools
| # | Tool Name | Description | Example Question |
|---|---|---|---|
| 41 | connect_list_connectors | List all configured Calabi Connect source connectors. | "What data sources are connected to Calabi?" |
| 42 | connect_get_connector | Retrieve configuration and status for a specific connector. | "Tell me about the Salesforce connector setup." |
| 43 | connect_get_sync_status | Check the current sync status of a connector (running, failed, idle). | "Is the Stripe connector syncing right now?" |
| 44 | connect_list_sync_history | Retrieve the sync history for a connector, including success/failure and row counts. | "Show me the last 10 syncs for the HubSpot connector." |
| 45 | connect_trigger_sync | Manually trigger a sync for a connector. | "Start a full sync of the Salesforce connector now." |
| 46 | connect_get_sync_logs | Retrieve detailed logs from a sync run. | "What errors did the Stripe sync have yesterday?" |
| 47 | connect_list_streams | List all streams (tables/objects) configured for a connector. | "Which Salesforce objects are being synced?" |
| 48 | connect_get_stream_schema | Retrieve the field schema for a specific stream. | "What fields are available in the Salesforce Opportunity stream?" |
| 49 | connect_enable_stream | Enable a previously disabled stream in a connector. | "Enable the Salesforce Account stream." |
| 50 | connect_disable_stream | Disable a stream from syncing without deleting the connector. | "Stop syncing the HubSpot Email Events stream." |
| 51 | connect_get_row_counts | Retrieve the number of rows synced per stream in the last run. | "How many rows did the Stripe connector sync last night?" |
| 52 | connect_list_failed_connectors | List all connectors that are currently in a failed state. | "Which connectors are broken right now?" |
Calabi Pipelines Tools
| # | Tool Name | Description | Example Question |
|---|---|---|---|
| 53 | pipelines_list_dags | List all DAGs in Calabi Pipelines, with status and schedule. | "What pipelines are scheduled to run today?" |
| 54 | pipelines_get_dag | Retrieve details for a specific DAG: schedule, owner, task list, last run. | "Tell me about the customer_ltv DAG." |
| 55 | pipelines_get_dag_runs | Retrieve recent run history for a DAG. | "Show me the last 10 runs of the daily_dbt_run pipeline." |
| 56 | pipelines_get_run_status | Get the status of a specific DAG run. | "What happened to the fact_orders_refresh run yesterday?" |
| 57 | pipelines_list_failed_runs | List all DAG runs that failed in a given time window. | "Which pipelines failed overnight?" |
| 58 | pipelines_get_task_instances | List all task instances for a DAG run with their statuses. | "Which tasks failed in the customer_ltv run this morning?" |
| 59 | pipelines_get_task_logs | Retrieve the execution logs for a specific task instance. | "Show me the error logs for the failed transform_orders task." |
| 60 | pipelines_trigger_dag | Manually trigger a DAG run. | "Run the daily_dbt_run pipeline now." |
| 61 | pipelines_pause_dag | Pause a DAG to prevent scheduled runs. | "Pause the hourly_sync DAG while we investigate." |
| 62 | pipelines_unpause_dag | Unpause a previously paused DAG. | "Resume the hourly_sync DAG." |
| 63 | pipelines_clear_task | Clear a task instance to allow it to be retried. | "Retry the load_to_redshift task in yesterday's run." |
| 64 | pipelines_get_run_duration | Get the execution duration for a DAG run. | "How long did the dbt pipeline take to run yesterday?" |
| 65 | pipelines_compare_run_durations | Compare run durations across a time range to detect regressions. | "Is the daily_dbt_run getting slower over time?" |
| 66 | pipelines_list_sla_misses | List runs that exceeded their configured SLA. | "Which pipelines missed their SLA this week?" |
| 67 | pipelines_get_dag_dependencies | Show inter-DAG dependencies (sensor-based triggers). | "What pipelines depend on fact_orders_refresh completing?" |
| 68 | pipelines_get_variables | List Calabi Pipelines variables (global configuration values). | "What variables are set in Calabi Pipelines?" |
Calabi Transform Tools
| # | Tool Name | Description | Example Question |
|---|---|---|---|
| 69 | transform_list_models | List all dbt models in the project, with their materialization type. | "What dbt models are in the marts folder?" |
| 70 | transform_get_model | Retrieve a model's SQL, description, and test definitions. | "Show me the SQL for the dim_customers model." |
| 71 | transform_get_model_lineage | Show upstream sources and downstream models for a dbt model. | "What tables does fct_revenue depend on?" |
| 72 | transform_get_run_results | Retrieve the results of the latest dbt run, including pass/fail per model. | "Did all dbt models pass in last night's run?" |
| 73 | transform_get_test_results | List dbt test outcomes (schema tests, data tests) from the latest run. | "What dbt tests failed in last night's run?" |
| 74 | transform_get_model_docs | Retrieve the dbt documentation block for a model or column. | "What is the documented purpose of the fct_orders model?" |
| 75 | transform_list_sources | List all dbt source definitions (raw tables referenced by models). | "What raw sources does our dbt project use?" |
| 76 | transform_get_source_freshness | Retrieve the freshness status of dbt sources. | "Are any dbt sources stale right now?" |
| 77 | transform_list_exposures | List all dbt exposures (dashboards, models that consume dbt outputs). | "Which dashboards consume the fct_revenue model?" |
| 78 | transform_get_manifest | Download the latest dbt manifest.json for programmatic use. | "Give me the dbt manifest for lineage analysis." |
| 79 | transform_trigger_run | Trigger a dbt run for specific models or the full project. | "Run just the mart_sales dbt model now." |
| 80 | transform_get_run_logs | Retrieve logs from a specific dbt run. | "Show me the logs from last night's dbt run." |
| 81 | transform_list_macros | List all dbt macros defined in the project. | "What dbt macros are available?" |
| 82 | transform_get_compiled_sql | Get the compiled (rendered) SQL for a dbt model, with all Jinja resolved. | "Show me the actual SQL that fct_orders compiles to." |
Calabi ML Tools
| # | Tool Name | Description | Example Question |
|---|---|---|---|
| 83 | ml_list_experiments | List all ML experiments registered in Calabi ML. | "What ML experiments are we running?" |
| 84 | ml_get_experiment | Retrieve metadata for a specific experiment: runs, parameters, tags. | "Tell me about the churn_prediction experiment." |
| 85 | ml_list_runs | List all runs within an experiment, with metrics and status. | "Show me all runs for the churn_prediction experiment." |
| 86 | ml_get_run | Retrieve full details for a specific run: parameters, metrics, artifacts. | "What were the accuracy and F1 scores for run abc123?" |
| 87 | ml_compare_runs | Compare metrics across multiple runs side by side. | "Compare the last 5 churn model runs by accuracy and AUC." |
| 88 | ml_get_best_run | Find the run with the best score for a given metric. | "Which run had the highest AUC in the churn experiment?" |
| 89 | ml_list_models | List all registered models in the Calabi ML model registry. | "What models are registered in Calabi ML?" |
| 90 | ml_get_model | Retrieve a registered model's versions, stages, and tags. | "What versions of the CustomerChurnModel exist?" |
| 91 | ml_get_model_version | Retrieve details for a specific model version. | "Tell me about version 3 of the churn model." |
| 92 | ml_transition_model_stage | Transition a model version to Staging or Production. | "Promote churn model v4 to Production." |
| 93 | ml_get_artifacts | List and retrieve artifacts (files) from a run: models, plots, data samples. | "Download the confusion matrix from the best churn run." |
| 94 | ml_log_metric | Log a metric to an active run (for integration with automated pipelines). | "Log an accuracy of 0.923 to the current churn run." |
| 95 | ml_get_run_params | Retrieve the hyperparameters used in a specific run. | "What hyperparameters were used in churn run abc123?" |
Calabi Automate Tools
| # | Tool Name | Description | Example Question |
|---|---|---|---|
| 96 | automate_list_workflows | List all Calabi Automate workflows with their active/inactive status. | "What automation workflows are active?" |
| 97 | automate_get_workflow | Retrieve a workflow's configuration and node structure. | "Tell me about the 'Pipeline Failure Alert' workflow." |
| 98 | automate_get_execution_history | Retrieve recent execution history for a workflow. | "Did the 'Daily Report' workflow run successfully this morning?" |
| 99 | automate_get_execution_detail | Get full details for a specific workflow execution, including per-node output. | "Show me the full log of workflow execution exec_789." |
| 100 | automate_trigger_workflow | Manually trigger a workflow (if it has a manual or webhook trigger). | "Trigger the 'Weekly Report' workflow now." |
| 101 | automate_activate_workflow | Activate an inactive workflow. | "Activate the 'SLA Alert' workflow." |
| 102 | automate_deactivate_workflow | Deactivate an active workflow without deleting it. | "Pause the 'Hourly Data Quality Check' workflow." |
| 103 | automate_list_credentials | List credential names available in the workspace (values are not returned). | "What credentials are configured in Calabi Automate?" |
| 104 | automate_list_failed_executions | List workflow executions that failed in a given time window. | "Which automation workflows failed today?" |
| 105 | automate_get_workflow_tags | List tags applied to workflows for filtering. | "Show me all workflows tagged 'alerting'." |
| 106 | automate_get_schedule | Retrieve the cron schedule for a workflow. | "When is the 'Daily Report Email' workflow scheduled to run?" |
AI Builder Tools
| # | Tool Name | Description | Example Question |
|---|---|---|---|
| 107 | aibuilder_list_chatflows | List all chatflows defined in Calabi AI Builder. | "What AI chatflows have been built?" |
| 108 | aibuilder_get_chatflow | Retrieve the configuration of a specific chatflow. | "Tell me about the 'HR Onboarding Bot' chatflow." |
| 109 | aibuilder_get_chatflow_status | Check whether a chatflow is deployed and accessible. | "Is the 'Customer Support Bot' chatflow live?" |
| 110 | aibuilder_list_agentflows | List all agent flows (multi-agent RAG pipelines) in AI Builder. | "What RAG agents are deployed?" |
| 111 | aibuilder_get_agentflow | Retrieve the configuration of a specific agent flow. | "What documents does the 'Policy Knowledge Base' agent use?" |
| 112 | aibuilder_get_vector_store_stats | Get statistics for a vector store: document count, last indexed. | "How many documents are in the HR policy vector store?" |
| 113 | aibuilder_trigger_reindex | Trigger a re-index of a vector store's document collection. | "Re-index the HR policy documents." |
| 114 | aibuilder_get_chatflow_api_url | Retrieve the REST API endpoint URL for a deployed chatflow. | "What's the API endpoint for the 'Support Bot' chatflow?" |
| 115 | aibuilder_list_models | List the LLM and embedding models configured in AI Builder. | "What LLMs are available in AI Builder?" |
| 116 | aibuilder_get_embed_config | Retrieve the embed script configuration for a chatflow widget. | "Give me the embed code for the 'Help Center' chatflow." |
| 117 | aibuilder_get_usage_stats | Retrieve usage statistics for a chatflow: message count, active users. | "How many users have talked to the HR bot this week?" |
Related Pages
- Asking Questions — How to phrase questions effectively
- Downloads & Charts — Export and visualization capabilities
- AI Builder Chatflows — Build custom chatflows and agents