--- title: perception-attributes description: ブランド認識属性を作成・表示名変更・非表示化する。 canonical_url: https://orchestor.io/docs/cli/perception-attributes markdown_url: https://orchestor.io/docs/cli/perception-attributes.md contentType: reference --- # perception-attributes `orc perception-attributes` は、brandの観測済み属性とcustom属性を管理します。将来の観測に使う属性を追加し、表示名を変更し、レポートと根拠一覧から非表示にできます。 対象Workspaceのbrand IDを指定します。観測済み属性も `list` のIDを更新・削除にそのまま使えます。表示名変更や非表示化で履歴上の観測や元の `source_label` は失われません。 ## 使い方 ```bash title="terminal" orc perception-attributes list --brand-id ``` *brandの属性を取得します。* ## サブコマンド ### `list` 観測済み属性とcustom属性を一覧表示します。対象brandが利用できない場合は404を返します。 ```bash title="terminal" orc perception-attributes list [options] ``` #### 固有のオプション ##### `--brand-id` Brand identifier in the selected workspace. Required; an unavailable brand returns 404. 型: `string`。必須。 ```bash title="terminal" orc perception-attributes list --brand-id ``` ### `create` brandごとに最大10件の有効なcustom属性を作成できます。labelはUnicode NFKC正規化、trim、連続空白の整理後に2〜80文字です。再試行にidempotency keyを使えます。 ```bash title="terminal" orc perception-attributes 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 perception-attributes create --idempotency-key ``` ##### `--brand-id` (required) Required brand in the selected workspace. Whitespace is trimmed. 型: `string`。任意。 ```bash title="terminal" orc perception-attributes create --brand-id ``` ##### `--label` (required) Display label after Unicode NFKC normalization, trimming and whitespace collapsing. Must contain 2–80 characters after normalization.; max 80 chars 型: `string`。任意。 ```bash title="terminal" orc perception-attributes create --label ``` ### `update` 永続化済みまたは観測済み属性の表示名を変更します。labelの正規化と2〜80文字の条件は作成と同じです。元のsource labelと既存の根拠の対応は維持します。 ```bash title="terminal" orc perception-attributes update [options] ``` #### 固有のオプション ##### `--brand-id` (required) Required brand in the selected workspace. Whitespace is trimmed. 型: `string`。任意。 ```bash title="terminal" orc perception-attributes update --brand-id ``` ##### `--label` (required) Display label after Unicode NFKC normalization, trimming and whitespace collapsing. Must contain 2–80 characters after normalization.; max 80 chars 型: `string`。任意。 ```bash title="terminal" orc perception-attributes update --label ``` ### `delete` 属性をレポートと根拠一覧から非表示にします。履歴上の観測とsource labelは保持します。非対話で確認を省略する場合は `--yes` を指定します。 ```bash title="terminal" orc perception-attributes delete [options] ``` #### 固有のオプション ##### `--brand-id` Brand identifier in the selected workspace. Required; an unavailable brand returns 404. 型: `string`。必須。 ```bash title="terminal" orc perception-attributes delete --brand-id ``` ## 使用例 ### custom属性を追加します。 ```bash title="terminal" orc perception-attributes create --brand-id --label "Customer support" ``` *custom属性を追加します。* ### 表示名を変更します。 ```bash title="terminal" orc perception-attributes update --brand-id --label "Support quality" ``` *表示名を変更します。* ## 必要な権限 認証し、対象Workspaceを選択して実行します。対象Workspaceへのアクセスが必要です。 ## グローバルオプション `orc perception-attributes` では、次の[グローバルオプション](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)