---
title: answers
description: 保存済みAI回答を取得し、export履歴を記録する。
canonical_url: https://orchestor.io/docs/cli/answer
markdown_url: https://orchestor.io/docs/cli/answer.md
contentType: reference
---

# answers

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

対象は選択したWorkspaceの回答です。回答を新しく計測するには [`orc runs`](https://orchestor.io/docs/cli/runs.md) を使用します。`answer` は互換aliasで、実行可能な操作は同じです。

## 使い方

```bash title="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` は含まない上限です。

```bash title="terminal"
orc answers list [options]
```

#### 固有のオプション

##### `--prompt-id`

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

型: `string`。任意。

```bash title="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`。任意。

```bash title="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`。任意。

```bash title="terminal"
orc answers list --brand-id <value>
```

##### `--platform`

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

型: `string`。任意。

```bash title="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`。任意。

```bash title="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`。任意。

```bash title="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`。任意。

```bash title="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`。任意。

```bash title="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`。任意。

```bash title="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`。任意。

```bash title="terminal"
orc answers list --sentiment <value>
```

##### `--start-date`

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

型: `string`。任意。

```bash title="terminal"
orc answers list --start-date <value>
```

##### `--end-date`

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

型: `string`。任意。

```bash title="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`。任意。

```bash title="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`。任意。

```bash title="terminal"
orc answers list --order <value>
```

### `exports create`

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

```bash title="terminal"
orc answers exports create [options]
```

#### 固有のオプション

##### `--export-format`

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

型: `string`。任意。

```bash title="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`。任意。

```bash title="terminal"
orc answers exports create --row-count <value>
```

### `get`

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

```bash title="terminal"
orc answers get <id> [options]
```

## 使用例

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

```bash title="terminal"
orc answers list --prompt-id <prompt-id> --platform chatgpt-ui --json
```

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

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

```bash title="terminal"
orc answers get <answer-id> --json
```

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

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

```bash title="terminal"
orc answers exports create --export-format csv --row-count 20
```

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

## 必要な権限

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

## グローバルオプション

`orc answers` では、次の[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を使用できます。

- [`--help`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%98%E3%83%AB%E3%83%97)
- [`--workspace`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AF%E3%83%BC%E3%82%AF%E3%82%B9%E3%83%9A%E3%83%BC%E3%82%B9)
- [`--json`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--pretty`](https://orchestor.io/docs/cli/global-flags.md#json-%E5%87%BA%E5%8A%9B)
- [`--format`](https://orchestor.io/docs/cli/global-flags.md#%E5%87%BA%E5%8A%9B%E5%BD%A2%E5%BC%8F)
- [`--field`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--fields`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A3%E3%83%BC%E3%83%AB%E3%83%89%E3%81%AE%E6%8A%BD%E5%87%BA)
- [`--raw`](https://orchestor.io/docs/cli/global-flags.md#%E5%80%A4%E3%81%A0%E3%81%91%E3%82%92%E5%87%BA%E5%8A%9B)
- [`--output`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%95%E3%82%A1%E3%82%A4%E3%83%AB%E3%81%B8%E3%81%AE%E5%87%BA%E5%8A%9B)
- [`--no-pager`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%9A%E3%83%BC%E3%82%B8%E9%80%81%E3%82%8A)
- [`--dry-run`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E3%81%AE%E4%BA%8B%E5%89%8D%E7%A2%BA%E8%AA%8D)
- [`--yes`](https://orchestor.io/docs/cli/global-flags.md#%E7%A2%BA%E8%AA%8D%E3%81%AE%E7%9C%81%E7%95%A5)
- [`--limit`](https://orchestor.io/docs/cli/global-flags.md)
- [`--cursor`](https://orchestor.io/docs/cli/global-flags.md)
- [`--stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--from-stdin`](https://orchestor.io/docs/cli/global-flags.md#%E6%A8%99%E6%BA%96%E5%85%A5%E5%8A%9B)
- [`--page-all`](https://orchestor.io/docs/cli/global-flags.md#%E3%81%99%E3%81%B9%E3%81%A6%E3%81%AE%E3%83%9A%E3%83%BC%E3%82%B8%E3%82%92%E5%8F%96%E5%BE%97)
- [`--timing`](https://orchestor.io/docs/cli/global-flags.md#%E3%83%AA%E3%82%AF%E3%82%A8%E3%82%B9%E3%83%88%E6%99%82%E9%96%93)
- [`--readonly`](https://orchestor.io/docs/cli/global-flags.md#%E8%AA%AD%E3%81%BF%E5%8F%96%E3%82%8A%E5%B0%82%E7%94%A8%E3%83%A2%E3%83%BC%E3%83%89)
- [`--wrap-untrusted`](https://orchestor.io/docs/cli/global-flags.md#%E5%A4%96%E9%83%A8%E3%83%86%E3%82%AD%E3%82%B9%E3%83%88%E3%81%AE%E7%9B%AE%E5%8D%B0%E4%BB%98%E3%81%91)

各オプションの詳細と使用例は、[グローバルオプション](https://orchestor.io/docs/cli/global-flags.md)を参照してください。

---

[Documentation index](https://orchestor.io/docs/llms.txt)