Getting started

answers

orc answers lists and retrieves persisted AI answers. Inspect answers by prompt, topic, monitored brand, measurement channel, execution context, time range, and sentiment. The export operation records a CSV generated by the client.

The target is answers in the selected Workspace. To measure new answers, use orc runs. answer is a compatibility alias for the same operations.

Usage

terminal
orc answers list --workspace <workspace-id>

List persisted answers.

Filter semantics

--brand-id selects the monitored brand owning the prompt, not any brand mentioned in an answer. --platform exactly matches a stored channel ID. Persona is an execution-time value rather than a Persona resource ID lookup; region uses execution, prompt, or snapshot locale, not Workspace residency.

--tag matches active Workspace tag names case-insensitively; supply a name, not an ID. Stored execution tags take precedence, otherwise current prompt tags are used. --brand-mentioned filters by whether the stored mentions array is nonempty; it can differ from the derived brand_mentioned response. Sentiment uses a stored label or numeric score; unscored answers do not match.

Subcommands

list

Defaults to descending created_at, with answer ID breaking ties. Prompt text sorting and ascending order are also available. Retain sort, order, and filters while following cursors. --start-date is an inclusive UTC timestamp; --end-date is exclusive.

terminal
orc answers list [options]

Unique options

--prompt-id

Return answers for this prompt ID. Omit to include all accessible prompts.

Type: string. Optional.

terminal
orc answers list --prompt-id <value>
--topic-id

Return answers associated with this topic through the current prompt or its saved observation snapshot.

Type: string. Optional.

terminal
orc answers list --topic-id <value>
--brand-id

Return answers whose topic belongs to this monitored brand. This selects the target brand, not a brand mentioned anywhere in the answer.

Type: string. Optional.

terminal
orc answers list --brand-id <value>
--platform

Exact stored observation-channel filter, such as chatgpt-ui. Omit to include all channels.

Type: string. Optional.

terminal
orc answers list --platform <value>
--persona

Exact persona value stored in the original execution request. This is not a Persona resource ID lookup.

Type: string. Optional.

terminal
orc answers list --persona <value>
--region

Observation country or region, matched without case sensitivity. The server uses the execution request, then prompt or saved snapshot locale; this is not workspace residency.

Type: string. Optional.

terminal
orc answers list --region <value>
--tag

Tag name, matched without case sensitivity among active workspace tags. Stored request tag IDs take precedence; otherwise current prompt tags are used. Supply a name, not an ID.

Type: string. Optional.

terminal
orc answers list --tag <value>
--prompt-type

Exact free-form prompt_type stored in the execution request or saved observation snapshot. Omit to include every type.

Type: string. Optional.

terminal
orc answers list --prompt-type <value>
--brand-mentioned

Filter by whether the stored answer mentions array is nonempty (true) or empty/missing (false). This filter is based on stored mentions and can differ from the derived brand_mentioned response field.

Type: string. Optional.

terminal
orc answers list --brand-mentioned <value>
--sentiment

Filter by the stored analysis label. If a label is absent, positive and negative numeric scores map to their respective labels and zero maps to neutral. Unscored answers do not match.; enum: positive|neutral|negative

Type: string. Optional.

terminal
orc answers list --sentiment <value>
--start-date

Inclusive lower bound on created_at as a UTC date-time.

Type: string. Optional.

terminal
orc answers list --start-date <value>
--end-date

Exclusive upper bound on created_at as a UTC date-time.

Type: string. Optional.

terminal
orc answers list --end-date <value>
--sort

Sort by creation time (default) or prompt text. The answer ID breaks ties. Keep the same sort and filters while following a cursor.; enum: prompt|created_at

Type: string. Optional.

terminal
orc answers list --sort <value>
--order

Sort direction for the selected field and ID tie-breaker. Defaults to desc. Keep this value unchanged while paging.; enum: asc|desc

Type: string. Optional.

terminal
orc answers list --order <value>

exports create

Record a client-generated file export using --export-format csv and --row-count. The server does not generate the answer CSV or verify its rows or actual row count.

terminal
orc answers exports create [options]

Unique options

--export-format

(required) Client-generated export format. Only csv is accepted.; enum: csv

Type: string. Optional.

terminal
orc answers exports create --export-format <value>
--row-count

(required) Number of rows in the client-generated file. Validated as request metadata; the server does not generate or verify the exported rows.

Type: number. Optional.

terminal
orc answers exports create --row-count <value>

get

Retrieve a persisted answer using the answer row ID (PromptAnswerData.id) returned by listing. Distinguish it from a run ID.

terminal
orc answers get <id> [options]

Examples

Filter by one channel and prompt.

terminal
orc answers list --prompt-id <prompt-id> --platform chatgpt-ui --json

Filter by one channel and prompt.

Retrieve answer details.

terminal
orc answers get <answer-id> --json

Retrieve answer details.

Record an already generated CSV export.

terminal
orc answers exports create --export-format csv --row-count 20

Record an already generated CSV export.

Permissions

Authenticate and select the target Workspace. Access to that Workspace is required.

Global Options

The following global options can be used with orc answers:

For details and examples, see global options.