Outputs

Outputs are the concrete work products a session asks for. They come in two kinds:

Artifacts

Documents or records the operator produces. Summary notes, action plans, referral letters.

Decisions

Choices the operator makes. Approve or deny, recommend a path, escalate.
In decision tasks, the output is the whole task: the operator reviews the inputs and produces one judgment. In conversation scenarios and journey simulations, outputs are produced alongside the dialogue, the way a case manager writes file notes during and after a call.

Inline or from the library

You can define an output in two places:
  • Inline on a single scenario, when the output is specific to that situation
  • Linked from your organization’s library, when the same output definition applies across many scenarios
A referral letter format that every scenario in your claims domain shares belongs in the library. Define it once, link it everywhere, and an update to the definition reaches every scenario that links it.

Simple and advanced modes

Each output definition uses one of two modes:
ModeHow it worksUse it when
SimpleFree text, or a choice from predefined optionsThe output is prose, or the decision is a pick from a known list
AdvancedValidated against a JavaScript Object Notation (JSON) schemaThe output has required fields and structure that must be exactly right
Simple mode covers most cases. A summary note is free text. An approve-or-deny decision is a predefined option list. Reach for advanced mode when the output feeds a downstream system or has a fixed structure, such as a referral that must always include a recipient, a reason, and an urgency level.
In advanced mode, a session output that does not match the schema is flagged, so structural mistakes are visible rather than buried in prose.

Exemplars

An exemplar is a model output attached to a definition: a complete example of what a good artifact or decision looks like for this scenario. Exemplars do two jobs:
  1. They make your standard concrete. “Write a good summary note” is vague; a model note is not.
  2. They sharpen scoring, because the criteria for a good output are grounded in an example of one.
Write the exemplar yourself, or take the best real output from an expert session and promote it. An exemplar drawn from real expert work is usually more honest than one written from imagination.

Next steps

Defining good

The criteria each output, and the session around it, is scored against.

Documents

The context files the operator works from when producing outputs.