Attaching a sheet to an agent
You can give an agent direct access to a Data Sheet so it can look records up — or maintain them — as part of completing its task. On the agent's edit page, add a data sheet tool and pin it to a specific sheet by its database and sheet slug (database_id + sheet_slug). The database must belong to the agent's app and team.
Access modes
- read — the agent gets a query tool only. It can search and read rows (using the standard query DSL) but cannot change anything. Use this for reference data: a price list, a knowledge table, a directory.
- read_write — in addition to querying, the agent gets create / edit / upsert / delete tools, so it can maintain the sheet. Use this when the agent should log outcomes, update a record's status, or append results.
The mode is per attachment, so you can give one agent read-only access to a reference sheet and read-write access to a working sheet at the same time. Without an attachment, an agent has no access to Data Sheets at all — like every other agent tool, sheet access must be explicitly granted.
How the agent uses it
At run time the attached sheet shows up in the agent's tool list. The agent decides when to call it based on its task and your tool guidance — querying to ground an answer, or writing to record a result. Writes go through the same ownership gate, cell validation, and row caps as every other Data-Sheet write, and deletes are soft (recoverable for 90 days). For agent setup in general see Agents overview; for the feature and plan gating see Data Sheets overview.