--- title: personas description: 再利用するペルソナと、その生成候補を管理する。 canonical_url: https://orchestor.io/docs/cli/persona markdown_url: https://orchestor.io/docs/cli/persona.md contentType: reference --- # personas `orc personas` は、Workspaceで使うオーディエンスのペルソナを管理するコマンドです。名前と説明、行動・属性・勤務情報から成るプロフィールを作成・取得・更新・削除できます。ブランドを基に非同期で候補を生成し、確認した内容を保存する操作もあります。 認証を設定し、対象Workspaceを指定してください。ペルソナを作成するだけではプロンプトとの関連付けや計測は始まりません。保存されたIDを [`orc prompts`](https://orchestor.io/docs/cli/prompt.md) の `persona_ids` に設定します。プロフィールは利用者が記述する仮説で、検証済みの顧客属性ではありません。 ## 使い方 ```bash title="terminal" orc personas list --workspace ``` *保存されたペルソナとIDを確認します。* ## サブコマンド ### `suggestions refresh` 現在のWorkspaceのブランドを指定して、buyer personaの仮説を非同期生成します。受付時点でdispatch失敗の状態を含む場合があるため、返された生成IDの状態を確認してください。生成はペルソナを保存・関連付け・計測しません。 ```bash title="terminal" orc personas suggestions refresh [options] ``` #### 固有のオプション ##### `--idempotency-key` Retry identity for operations that support idempotency. Use a unique key for each new operation, and reuse it only when retrying the same HTTP method, path, query values and exact request body. JSON whitespace changes can count as a different body. Keys contain 1–255 characters after trimming and expire after 24 hours. A completed JSON response is replayed without repeating the operation. A different request using the same key returns 409 idempotency_error. An in-progress request returns 409 idempotency_in_progress with Retry-After: 2. Whether this header is required depends on the operation. 型: `string`。任意。 ```bash title="terminal" orc personas suggestions refresh --idempotency-key ``` ##### `--brand-id` (required) Brand in the selected workspace whose profile supplies generation context. 型: `string`。任意。 ```bash title="terminal" orc personas suggestions refresh --brand-id ``` ##### `--count` Requested number of persona candidates, from 1 to 5. Defaults to 3. 型: `number`。任意。 ```bash title="terminal" orc personas suggestions refresh --count ``` ##### `--language-code` Language for the generated candidates. Defaults to ja-JP. 型: `string`。任意。 ```bash title="terminal" orc personas suggestions refresh --language-code ``` ##### `--instructions` Optional guidance for generation, up to 2000 characters. Omit for no additional instructions.; max 2000 chars 型: `string`。任意。 ```bash title="terminal" orc personas suggestions refresh --instructions ``` ### `suggestions generations get` 生成IDで候補生成の状態と結果を取得します。候補を確認・編集し、選んだプロフィールを `personas create` で保存してください。 ```bash title="terminal" orc personas suggestions generations get [options] ``` ### `list` 削除されていないペルソナを作成日時の新しい順に一覧します。ブランドによる絞り込みは行いません。同じcursorをそのまま使用して次ページを取得します。 ```bash title="terminal" orc personas list [options] ``` ### `create` 必須入力は `name` です。`description` を省略するとnull、`persona` を省略すると空のプロフィールになります。作成には `workspace:settings` 権限が必要です。 ```bash title="terminal" orc personas create [options] ``` #### 固有のオプション ##### `--idempotency-key` Retry identity for operations that support idempotency. Use a unique key for each new operation, and reuse it only when retrying the same HTTP method, path, query values and exact request body. JSON whitespace changes can count as a different body. Keys contain 1–255 characters after trimming and expire after 24 hours. A completed JSON response is replayed without repeating the operation. A different request using the same key returns 409 idempotency_error. An in-progress request returns 409 idempotency_in_progress with Retry-After: 2. Whether this header is required depends on the operation. 型: `string`。任意。 ```bash title="terminal" orc personas create --idempotency-key ``` ##### `--name` (required) Display name for this audience persona. 型: `string`。任意。 ```bash title="terminal" orc personas create --name ``` ##### `--description` Optional audience summary. Omit or send null to store no description.; (use "null" or "reset" to clear) 型: `string`。任意。 ```bash title="terminal" orc personas create --description ``` ##### `--persona` Optional audience attributes grouped into behavior, demographics and employment, plus visual identity. Omit unknown groups or fields. Nullable leaf values can be null. Text and string arrays describe the audience; they are not validated against demographic taxonomies. Use employment.roleSeniority; the removed employment.seniority field is rejected.; (JSON object, e.g. '{"custom_id":"x"}') 型: `string`。任意。 ```bash title="terminal" orc personas create --persona ``` #### 使用例 ```bash title="terminal" orc personas create --stdin --workspace < persona.json ``` *構造化プロフィールを保存する* ### `get` 一覧で返されたペルソナIDを指定して詳細を取得します。不明・削除済み・別WorkspaceのIDは404です。 ```bash title="terminal" orc personas get [options] ``` ### `update` 指定項目だけを変更します。`description: null` は説明を解除します。`persona` を渡すと入れ子をmergeせず、プロフィール全体を置き換えます。空プロフィールは空のJSON objectで指定します。 ```bash title="terminal" orc personas update [options] ``` #### 固有のオプション ##### `--name` Replacement display name. Omit to keep the current name. 型: `string`。任意。 ```bash title="terminal" orc personas update --name ``` ##### `--description` Replacement summary. Send null to clear it; omit to retain it.; (use "null" or "reset" to clear) 型: `string`。任意。 ```bash title="terminal" orc personas update --description ``` ##### `--persona` Optional audience attributes grouped into behavior, demographics and employment, plus visual identity. Omit unknown groups or fields. Nullable leaf values can be null. Text and string arrays describe the audience; they are not validated against demographic taxonomies. Use employment.roleSeniority; the removed employment.seniority field is rejected.; (JSON object, e.g. '{"custom_id":"x"}') 型: `string`。任意。 ```bash title="terminal" orc personas update --persona ``` ### `delete` ペルソナを論理削除します。削除されていないプロンプトに関連付いている場合は409です。先に各プロンプトの `persona_ids` から外して再試行してください。 ```bash title="terminal" orc personas delete [options] ``` ## 使用例 ### ペルソナの入力 ```json title="persona.json" { "name": "Mid-market SaaS CTO", "description": "Evaluates search software.", "persona": { "behavior": { "motivations": "Reduce research time", "painPoints": null }, "employment": { "jobTitle": [ "CTO" ], "roleSeniority": [ "Executive" ] } } } ``` *ペルソナの入力* ## プロフィールの構造 `persona` の主なグループは `behavior`、`demographics`、`employment` です。フィールド名はcamelCaseです。不明なグループ・項目は省略でき、nullableな末端値はnullにできます。 `behavior` は `motivations` と `painPoints`、`demographics` は `ageRange`・`gender`・`location`・`income`・`education`、`employment` は `companySize`・`industry`・`jobTitle`・`roleSeniority`・`department` を扱います。属性と勤務情報は文字列の配列です。削除済みの `employment.seniority` ではなく `roleSeniority` を使ってください。 任意の `avatar` は `colorToken`・`identityKind`・`iconToken`・`emoji`・`imageFileId` を持ちます。nullは既定のavatarへ戻します。更新時に一部のプロフィールだけを送ると残りも置き換わるため、保持したい項目を含む全体を送ってください。 ## 必要な権限 対象Workspaceへのアクセスが必要です。変更操作には対応する書き込み権限が必要です。 ## グローバルオプション `orc personas` では、次の[グローバルオプション](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)