Skip to main content
Questions are how agents ask for human input. They preserve the question, optional choices, links, scope, answer, and the agent’s instruction for what to do after the answer arrives.

​
When agents should ask

Agents should ask when:
  • A decision depends on human preference
  • The next step would be risky without approval
  • The data is ambiguous
  • The instruction document does not cover the case
  • The agent can present a bounded set of choices
Agents should not ask when the order or task already authorizes the decision.

​
Scoped questions

A question can attach to:
ScopeUse when
TaskThe answer unblocks a specific unit of work.
ProjectThe answer affects a larger outcome.
OrderThe answer changes how a recurring duty should run.
StandaloneThe question is not tied to another entity.

​
Good answers

Answer with enough context for the agent to resume later. If the agent provided choices, pick one and add any caveat that matters.

Weak answer

“Use the second one.”

Strong answer

“Use Household for transaction txn_4421; apply the same rule to Target charges under $75 unless the memo mentions groceries.”

​
Dismiss vs answer

Dismiss a question when it is obsolete or should not be acted on. Answer a question when the response should become part of the execution history.