Skip to main content

TablesTools

Toolkit that gives an agent access to your Abstra Tables. The agent gets one tool per allowed method (select, insert, update, delete, optionally run_sql), scoped to the tables and default WHERE clause you configure.

The where default is treated as a scoping invariant: it is merged into every select, update, and delete call AFTER the agent's call-site where, so the toolkit-level keys always win. Use this for tenant scoping (e.g. {"tenant_id": "abc"}) — the agent cannot override or remove those keys, even by accident.

Parameters

NameDescriptionTypeDefault
methodAllowed table operations. Either "all" (full CRUD), a single method ("select", "insert", "update", "delete"), or a list of methods. Defaults to "all".Union'all'
tableRestrict access to one or more table names. None (or "all") allows every table in the project. Defaults to None.OptionalNone
whereDefault WHERE clause merged into every select/update/delete. The toolkit keys always win over the agent's call-site where, so this is safe for scoping (e.g. \{"tenant_id": "abc"\}). Defaults to None.OptionalNone
allow_sqlIf True, exposes an extra run_sql tool that accepts arbitrary read-only SQL. Use with caution. Defaults to False.boolFalse