gtme answer

Record a participant's answer for one pending human/* or agent/* step

What you'll learn

You're about to type gtme answer and want its forms and its flags.

  • every form of gtme answer and what each does
  • each flag and what it changes
  • where the docs use it

Record a participant's answer for one pending human/* or agent/* step: a filter takes pass=true|false and reason, a compose or review its declared fields; the value is validated against the step's declared outputs and refused naming them otherwise. Writes an answered event and nothing else — it never sends. STEP may be omitted when one step is pending; with no identity key and a terminal it walks the pending records. --as names the participant (default the OS user; the human/ or agent/ prefix follows the adapter), --cost records what the participant spent (estimated unless --measured), --note is free text kept with the answer (never part of a cache key)

Forms

gtme answer [RUN_ID|last|PIPELINE] [STEP] [IDENTITY_KEY] [--set field=value ...] [--as NAME] [--cost USD [--measured]] [--note TEXT]

Flags

FlagTakesWhat it does
--setfield=valueSee the form.
--asNAME--as names the participant (default the OS user; the human/ or agent/ prefix follows the adapter)
--costUSD--cost records what the participant spent (estimated unless --measured)
--measurednothing--cost records what the participant spent (estimated unless --measured)
--noteTEXT--note is free text kept with the answer (never part of a cache key)

It exits with one of the exit codes every verb shares.

Example

From Participants:

gtme answer grading grade jane.doe@acme.com --set grading.grade=A \
    --note "owns the budget" --as dana

Used in