Save weekly revenue query
The agent proposes saving a query after inspecting the connection and schema context.
Proposed action
save_query
- name:
- weekly_revenue_by_region
- connection:
- warehouse / analytics
Illustrative proposal
Platform capability
Configured agent-proposed actions pause for a person to review the operation, edit arguments, and approve or reject before execution proceeds.
Approval applies to configured agent-proposed consequential actions in Quantum Lab, not every manual notebook action or query.
Configured consequential action
The agent proposes saving a query after inspecting the connection and schema context.
Proposed action
save_query
Illustrative proposal
The action is held because save_query is configured as consequential. No execution until a person reviews.
Pending review
Illustrative status
Inspect the arguments, edit if needed, then approve to proceed or reject with feedback.
Approval card
Controls disabled -- illustrative only
When Kole proposes a configured consequential action in Quantum Lab, the notebook pauses execution and presents the proposal for review. The person reviewing can inspect what the agent wants to do, check or edit the arguments, and decide whether to approve or reject the action before it runs.
This keeps the human in the loop for operations that change data, structure, or stored queries -- the kind of work where reviewing the target and intent matters before committing to it.
Approval is triggered when Kole proposes an action using a tool that has been configured as consequential. Read-only discovery tools -- inspecting schemas, listing tables, browsing metadata -- run without pausing because they do not change anything. Only tools that write, mutate, or create are configured to require explicit review.
The distinction is deliberate: the agent can gather context freely, but it cannot act on that context without a person confirming the proposed operation. Not every action in a notebook requires approval -- manual blocks you write and run yourself proceed normally. The gate applies to configured agent-proposed consequential actions specifically.
When a consequential action is proposed, Quantum Lab shows an approval card with the action name, the arguments Kole intends to use, and the source context. The reviewer can read the proposed operation, edit the arguments to narrow scope or correct intent, and then approve or reject.
Rejecting an action lets you include feedback so the agent understands what to change. Approving with edited arguments lets you refine the proposal without starting over. The goal is that the person reviewing has enough information to make a judgment about whether this specific operation should proceed with these specific arguments.
An approved action proceeds with the final arguments (original or edited). A rejected action does not execute; the agent receives the rejection and any feedback provided. The notebook continues from there -- the reviewer's decision is the gate, and no configured consequential action bypasses it.
Approval workflow / gate scenarios
Each gate represents a configured tool that Kole uses in Quantum Lab. When the tool is marked as consequential, the proposed action pauses until a person approves or rejects it.
01 / Save a query
A write action proposed by the agent to persist a query for the team.
Illustrative scenario
02 / Add notebook blocks
Agent proposes structural changes to the notebook by adding new blocks.
Illustrative scenario
03 / Execute a mutation
A data modification requiring confirmation before the statement runs.
Illustrative scenario
04 / Schema change proposal
A DDL operation that alters database structure, requiring review before execution.
Illustrative scenario