CLI を使い始める

answers

orc answers は、保存済みAI回答を一覧・個別取得するコマンドです。prompt、topic、監視対象brand、計測チャネル、実行context、期間、感情の条件で回答を調べられます。export操作は利用者側で生成したCSVの記録を残します。

対象は選択したWorkspaceの回答です。回答を新しく計測するには orc runs を使用します。answer は互換aliasで、実行可能な操作は同じです。

使い方

terminal
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 は含まない上限です。

terminal
orc answers list [options]

固有のオプション

--prompt-id

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

型: string。任意。

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

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

型: string。任意。

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.

型: string。任意。

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

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

型: string。任意。

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

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

型: string。任意。

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.

型: string。任意。

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.

型: string。任意。

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.

型: string。任意。

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.

型: string。任意。

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

型: string。任意。

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

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

型: string。任意。

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

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

型: string。任意。

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

型: string。任意。

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

型: string。任意。

terminal
orc answers list --order <value>

exports create

--export-format csv と --row-count を指定して、client生成ファイルのexportを記録します。サーバーは回答CSVを生成せず、行の内容や件数の一致を検証しません。

terminal
orc answers exports create [options]

固有のオプション

--export-format

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

型: string。任意。

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.

型: number。任意。

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

get

一覧で返された回答row ID(PromptAnswerData.id)を指定して保存済み回答を取得します。run IDとは区別してください。

terminal
orc answers get <id> [options]

使用例

一つのチャネルとpromptに絞ります。

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

一つのチャネルとpromptに絞ります。

回答の詳細を取得します。

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

回答の詳細を取得します。

作成済みCSVのexportを記録します。

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

作成済みCSVのexportを記録します。

必要な権限

認証し、対象Workspaceを選択して実行します。対象Workspaceへのアクセスが必要です。

グローバルオプション

orc answers では、次のグローバルオプションを使用できます。

各オプションの詳細と使用例は、グローバルオプションを参照してください。