These are the tools a connected agent can call. Tools marked write change
data; inside a project they follow the project’s
autonomy level and are recorded in the agent activity
log.
Databases
| Tool |
Type |
Description |
list_databases |
read |
Databases of the workspace. |
create_database |
write |
Create a database. |
list_tables |
read |
Tables of a database. |
get_table_schema |
read |
Fields of a table with their types and options. |
create_table, update_table, delete_table |
write |
Manage tables. |
create_fields, update_fields, delete_fields |
write |
Manage fields. |
list_table_rows |
read |
Read rows, with search and paging. |
create_rows, update_rows, delete_rows |
write |
Manage rows in bulk. |
Projects and schema
| Tool |
Type |
Description |
list_projects |
read |
Projects of the workspace. |
create_project |
write |
Create a project and optionally attach databases. |
get_project_schema |
read |
All tables and fields of the project’s databases. |
schema_diff |
read |
Compare a desired schema with the current one. Never writes. |
apply_schema |
write |
Create or change tables and fields to match a desired schema, in one atomic step. |
records_query |
read |
Filter, search, group and aggregate records with the query language. |
Declarative schemas
schema_diff and apply_schema take the schema you want:
{
"database_name": "Sales",
"tables": [
{
"name": "Companies",
"fields": [
{ "name": "Name", "type": "text" },
{ "name": "Country", "type": "single_select",
"select_options": [{ "value": "US" }, { "value": "DE" }] }
]
},
{
"name": "Deals",
"fields": [
{ "name": "Title", "type": "text" },
{ "name": "Amount", "type": "number", "number_decimal_places": 2 },
{ "name": "Company", "type": "link_row", "link_row_table": "Companies" }
]
}
]
}
The plan lists every operation first. Tables are never deleted and fields are
only deleted with delete_missing_fields. Applying the same schema twice
does nothing the second time.
Memory
| Tool |
Type |
Description |
get_project_context |
read |
The project briefing: decisions, assumptions, facts, summaries, documents, reports and relevant memories. |
search_project_memory |
read |
Semantic (or text) search in memory. |
remember |
write |
Add a memory entry. |
update_memory |
write |
Change an entry. |
forget_memory |
write |
Delete an entry. |
Reports
| Tool |
Type |
Description |
list_reports |
read |
Reports of a project. |
create_report, update_report |
write |
Manage report definitions. |
render_report |
read |
Compute a report (or preview an unsaved definition). |
snapshot_report |
write |
Freeze the current data. |
publish_report |
write |
Publish with an access mode; returns public_url. |
Applications, dashboards and automations
| Tool |
Type |
Description |
| Builder tools |
write |
Create applications, pages, elements, data sources and workflow actions. |
publish_application |
write |
Publish an application on a subdomain or custom domain. |
create_dashboard_widget |
write |
Add a summary or chart widget and configure its data. |
list_dashboard_widgets |
read |
Widgets of a dashboard. |
| Automation tools |
write |
Create workflows, triggers and action nodes. |
publish_workflow |
write |
Make a workflow live. |
Agent actions
| Tool |
Type |
Description |
get_agent_action |
read |
Status of an action that is waiting for approval, so the agent can follow up after you approve or reject it. |
Errors
Expected problems (an unknown field, a table outside the project, an invalid
report) come back as {"error": "..."} results that the agent can read and
correct, instead of failing the whole call.