レポート

perception-attributes

orc perception-attributes は、brandの観測済み属性とcustom属性を管理します。将来の観測に使う属性を追加し、表示名を変更し、レポートと根拠一覧から非表示にできます。

対象Workspaceのbrand IDを指定します。観測済み属性も list のIDを更新・削除にそのまま使えます。表示名変更や非表示化で履歴上の観測や元の source_label は失われません。

使い方

terminal
orc perception-attributes list --brand-id <brand-id>

brandの属性を取得します。

サブコマンド

list

観測済み属性とcustom属性を一覧表示します。対象brandが利用できない場合は404を返します。

terminal
orc perception-attributes list [options]

固有のオプション

--brand-id

Brand identifier in the selected workspace. Required; an unavailable brand returns 404.

型: string。必須。

terminal
orc perception-attributes list --brand-id <value>

create

brandごとに最大10件の有効なcustom属性を作成できます。labelはUnicode NFKC正規化、trim、連続空白の整理後に2〜80文字です。再試行にidempotency keyを使えます。

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。任意。

terminal
orc perception-attributes create --idempotency-key <value>
--brand-id

(required) Required brand in the selected workspace. Whitespace is trimmed.

型: string。任意。

terminal
orc perception-attributes create --brand-id <value>
--label

(required) Display label after Unicode NFKC normalization, trimming and whitespace collapsing. Must contain 2–80 characters after normalization.; max 80 chars

型: string。任意。

terminal
orc perception-attributes create --label <value>

update

永続化済みまたは観測済み属性の表示名を変更します。labelの正規化と2〜80文字の条件は作成と同じです。元のsource labelと既存の根拠の対応は維持します。

terminal
orc perception-attributes update <id> [options]

固有のオプション

--brand-id

(required) Required brand in the selected workspace. Whitespace is trimmed.

型: string。任意。

terminal
orc perception-attributes update <id> --brand-id <value>
--label

(required) Display label after Unicode NFKC normalization, trimming and whitespace collapsing. Must contain 2–80 characters after normalization.; max 80 chars

型: string。任意。

terminal
orc perception-attributes update <id> --label <value>

delete

属性をレポートと根拠一覧から非表示にします。履歴上の観測とsource labelは保持します。非対話で確認を省略する場合は --yes を指定します。

terminal
orc perception-attributes delete <id> [options]

固有のオプション

--brand-id

Brand identifier in the selected workspace. Required; an unavailable brand returns 404.

型: string。必須。

terminal
orc perception-attributes delete <id> --brand-id <value>

使用例

custom属性を追加します。

terminal
orc perception-attributes create --brand-id <brand-id> --label "Customer support"

custom属性を追加します。

表示名を変更します。

terminal
orc perception-attributes update <attribute-id> --brand-id <brand-id> --label "Support quality"

表示名を変更します。

必要な権限

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

グローバルオプション

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

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