--- title: tags description: Workspaceのタグ名と表示色を管理する。 canonical_url: https://orchestor.io/docs/cli/tag markdown_url: https://orchestor.io/docs/cli/tag.md contentType: reference --- # tags `orc tags` は、Workspaceで質問の分類に使うタグを管理するコマンドです。一覧を取得し、名前と表示色を作成・更新したり、タグを論理削除したりできます。 認証と対象Workspaceへのアクセスが必要です。一覧で返されたタグIDを変更・削除に使います。質問への関連付けは [`orc prompts tags update`](https://orchestor.io/docs/cli/prompt.md) で行い、タグを作成する操作とは別です。 ## 使い方 ```bash title="terminal" orc tags list --workspace ``` *タグとIDを確認します。* ## サブコマンド ### `list` Workspaceのタグを一覧します。`--limit` と返されたcursorでページを取得できます。 ```bash title="terminal" orc tags list [options] ``` ### `create` `name` は必須で最大64文字です。任意の `color` は登録された色名を指定します。変更の再試行に `--idempotency-key` を使用できます。 ```bash title="terminal" orc tags 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 tags create --idempotency-key ``` ##### `--name` (required) Tag name, from 1 to 64 characters. Must be unique among active tags in this workspace, ignoring case.; max 64 chars 型: `string`。任意。 ```bash title="terminal" orc tags create --name ``` ##### `--color` Display color token. Defaults to gray when omitted.; enum: gray|red|orange|yellow|lime|green|cyan|blue|purple|fuchsia|pink|emerald|amber|violet|indigo|teal|sky|rose|slate|zinc|neutral|stone 型: `string`。任意。 ```bash title="terminal" orc tags create --color ``` #### 使用例 ```bash title="terminal" orc tags create --name "Priority" --color blue --workspace ``` *表示色付きのタグを作成する* ### `update` タグIDを指定して入力した `name` と `color` を変更します。色は `--color null` または `--color reset` で解除できます。 ```bash title="terminal" orc tags update [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 tags update --idempotency-key ``` ##### `--name` Replacement tag name. Omit to retain the current name.; max 64 chars 型: `string`。任意。 ```bash title="terminal" orc tags update --name ``` ##### `--color` Replacement color token. Send null to clear the stored color; omit to retain it.; enum: |gray|red|orange|yellow|lime|green|cyan|blue|purple|fuchsia|pink|emerald|amber|violet|indigo|teal|sky|rose|slate|zinc|neutral|stone; (use "null" or "reset" to clear) 型: `string`。任意。 ```bash title="terminal" orc tags update --color ``` #### 使用例 ```bash title="terminal" orc tags update --color null --workspace ``` *タグの表示色を解除する* ### `delete` タグIDを指定して論理削除します。対象WorkspaceとIDを確認してから実行します。 ```bash title="terminal" orc tags delete [options] ``` ## 表示色と質問への関連付け 色は `gray`、`red`、`orange`、`yellow`、`lime`、`green`、`cyan`、`blue`、`purple`、`fuchsia`、`pink`、`emerald`、`amber`、`violet`、`indigo`、`teal`、`sky`、`rose`、`slate`、`zinc`、`neutral`、`stone` です。 `prompts tags update` は関連付け全体を置き換えるため、新しいタグだけでなく保持する既存タグIDも送ってください。タグ名をそのままpromptのID引数へ指定する操作ではありません。 ## 必要な権限 対象Workspaceへのアクセスが必要です。変更操作には対応する書き込み権限が必要です。 ## グローバルオプション `orc tags` では、次の[グローバルオプション](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)