answers
orc answers は、保存済みAI回答を一覧・個別取得するコマンドです。prompt、topic、監視対象brand、計測チャネル、実行context、期間、感情の条件で回答を調べられます。export操作は利用者側で生成したCSVの記録を残します。
対象は選択したWorkspaceの回答です。回答を新しく計測するには orc runs を使用します。answer は互換aliasで、実行可能な操作は同じです。
使い方
orc answers list --workspace <workspace-id>保存済み回答を一覧表示します。
絞り込みの意味
--brand-id はpromptを所有する監視対象brandで、回答内の任意の言及brandではありません。--platform は保存されたチャネルIDへの完全一致です。personaは実行時の値でありPersona resource ID検索ではなく、regionは実行・prompt・snapshotの国や地域でWorkspace residencyではありません。
--tag は有効なWorkspace tag名を大文字小文字を区別せず照合し、IDを渡しません。保存済み実行tagが優先され、なければ現在のprompt tagを使います。--brand-mentioned は保存されたmentions arrayの有無をfilterし、応答の導出 brand_mentioned と異なる場合があります。感情は保存labelまたは数値scoreから判定し、未scoreの回答は一致しません。
サブコマンド
list
既定では created_at の降順で並べ、同時刻は回答IDで順序を決めます。prompt textでのsortと昇順も選べます。cursorをたどる間はsort・order・filterを維持します。--start-date は含むUTC日時、--end-date は含まない上限です。
orc answers list [options]固有のオプション
--prompt-id
Return answers for this prompt ID. Omit to include all accessible prompts.
型: string。任意。
orc answers list --prompt-id <value>--topic-id
Return answers associated with this topic through the current prompt or its saved observation snapshot.
型: string。任意。
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.
型: string。任意。
orc answers list --brand-id <value>--platform
Exact stored observation-channel filter, such as chatgpt-ui. Omit to include all channels.
型: string。任意。
orc answers list --platform <value>--persona
Exact persona value stored in the original execution request. This is not a Persona resource ID lookup.
型: string。任意。
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.
型: string。任意。
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.
型: string。任意。
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.
型: string。任意。
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.
型: string。任意。
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
型: string。任意。
orc answers list --sentiment <value>--start-date
Inclusive lower bound on created_at as a UTC date-time.
型: string。任意。
orc answers list --start-date <value>--end-date
Exclusive upper bound on created_at as a UTC date-time.
型: string。任意。
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
型: string。任意。
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
型: string。任意。
orc answers list --order <value>exports create
--export-format csv と --row-count を指定して、client生成ファイルのexportを記録します。サーバーは回答CSVを生成せず、行の内容や件数の一致を検証しません。
orc answers exports create [options]固有のオプション
--export-format
(required) Client-generated export format. Only csv is accepted.; enum: csv
型: string。任意。
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.
型: number。任意。
orc answers exports create --row-count <value>get
一覧で返された回答row ID(PromptAnswerData.id)を指定して保存済み回答を取得します。run IDとは区別してください。
orc answers get <id> [options]使用例
一つのチャネルとpromptに絞ります。
orc answers list --prompt-id <prompt-id> --platform chatgpt-ui --json一つのチャネルとpromptに絞ります。
回答の詳細を取得します。
orc answers get <answer-id> --json回答の詳細を取得します。
作成済みCSVのexportを記録します。
orc answers exports create --export-format csv --row-count 20作成済みCSVのexportを記録します。
必要な権限
認証し、対象Workspaceを選択して実行します。対象Workspaceへのアクセスが必要です。
グローバルオプション
orc answers では、次のグローバルオプションを使用できます。
各オプションの詳細と使用例は、グローバルオプションを参照してください。