uipath-tasks

UiPath Tasks（Action Center）— エージェントスキル

Action Center は、UiPath のヒューマン・イン・ザ・ループプラットフォームです。タスクは、人間による入力が必要な作業項目を表します。フォームの承認、ドキュメントの検証、データのラベリングなどが含まれます。

すべての操作は uip tasks <verb> --output json を通じて行います。

---

ログインとテナントの設定

デフォルトは Production です。リクエストで明示的に指定されている場合にのみ、環境／組織／テナントを切り替えてください。

• リクエストに環境の指定がない場合 → 現在のセッションを使用します（デフォルトは prod cloud.uipath.com）
• リクエストで環境／組織／テナントが明示的に指定されている場合 → uip login status を確認し、必要に応じて再ログインします

切り替えが必要な場合：

1. 現在のログイン状態を確認します：uip login status --output json — UIPATH_URL、Organization、Tenant を確認します
2. 環境が異なる場合にのみ、--authority を指定して再ログインします：
   • デフォルト以外のホスト（Automation Suite、dedicated、その他）：uip login --authority "<AUTHORITY_URL>" --tenant <tenant>
   • cloud.uipath.com：uip login --tenant <tenant>（デフォルトのため、--authority は不要です）
3. 環境は正しいもののテナントが異なる場合：uip login tenant set <tenant-name>

# Check current environment, org, and tenant
uip login status --output json

# Login to a specific environment (production cloud is the default)
uip login --authority https://cloud.uipath.com --tenant MyTenant

# List all available tenants (after login)
uip login tenant list --output json

# Switch tenant within the same environment
uip login tenant set MyTenant

重要： tasks コマンドの --tenant フラグでは、アクティブなセッションのテナントは切り替わりません。 環境は認証ファイル内の UIPATH_URL によって決まります。tasks コマンドを実行する前に、必ず login status で確認してください。

---

使用する場面

• フォルダーを横断して Action Center のタスクを一覧表示または確認する
• ユーザーへのタスクの割り当て、再割り当て、割り当て解除を行う
• アクションの結果とデータペイロードを指定してタスクを完了する
• フォルダー内でタスクの権限を持つユーザーを照会する
• タスクカタログとその保持ポリシーを管理する（一覧表示、取得、作成、更新）
• タスクのコメントを読み取り、追加する
• タスクラベルを設定する
• タスクのメタデータ（タイトル、優先度、カタログとの関連付け）を編集する
• タスクデータを取得し、保存する
• Agent または Maestro のタスクの実行トレースを取得し、トレースまたはスパンにフィードバックを送信する

対象外： Orchestrator のキューまたはキュー項目（uip or を使用）、Document Understanding のモデル学習、Action Center アプリの開発（uip codedapp を使用）。

---

タスクの種類

種類	CLI の値	説明
フォームタスク	FormTask	フォームベースの承認／アクションタスク
外部タスク	ExternalTask	汎用の外部タスク
アプリタスク	AppTask	Action Center アプリベースのタスク
ドキュメント検証	DocumentValidationTask	Document Understanding の検証
ドキュメント分類	DocumentClassificationTask	Document Understanding の分類
データラベリング	DataLabelingTask	データラベリングタスク

---

タスクのステータスと優先度

ステータス	意味
Unassigned	作成済みですが、ユーザーに割り当てられていません
Pending	割り当て済みで、完了待ちです
Completed	アクション／結果とともに完了しています

優先度	レベル
Low	低
Medium	中（デフォルト）
High	高
Critical	重大

---

クイックスタート

# Check login and active tenant
uip login status --output json

# Switch tenant if needed
uip login tenant set <tenant-name>

# List all tasks across folders
uip tasks list --output json

# Get details of a specific task
uip tasks get <task-id> --output json

# Assign a task to a user
uip tasks assign <task-id> --user [email protected] --output json

# Complete a task
uip tasks complete <task-id> --type ExternalTask --folder-id <folder-id> --output json

---

重要なルール

1. 必ず最初に組織とテナントを確認してください。 ユーザーが組織／環境とテナントを指定した場合は、uip login status を実行してアクティブなテナントを確認し、必要に応じて uip login tenant set <tenant> を実行して切り替えてください。アクティブなテナントがユーザーの意図と一致していると決めつけないでください。

2. タスク ID は数値です。 GUID を使用する他の UiPath サービスとは異なり、Action Center では数値のタスク ID を使用します。tasks list を使ってタスク ID を確認してください。

3. フォルダーのスコープは、相互に置き換え可能な 3 つの形式で指定できます。 フォルダーをスコープとするコマンドでは、--folder-id <numeric-id>、--folder-path <path>、または --folder-key <guid> を受け付けます（同時には指定できません）。パスとキーは uip or folders list の出力内容と完全に一致します（数値 ID の列はありません）。そのため、フォルダーの一覧から確認したフォルダーには、これらを使用することを推奨します。タスクの行に folderId がある場合は、数値 ID も使用できます。

4. 完了には --type が必要です。 API はタスクの種類ごとに異なるエンドポイントにルーティングします。タスクを完了するときは、必ず --type を指定してください。まず tasks get を使ってタスクの種類を確認してください。

5. FormTask と AppTask の完了には --action と --data が必要です。 その他のタスクの種類では、アクションとデータは任意です。

6. 割り当てには --user-id または --user（メールアドレス）を指定できます。 割り当て可能なユーザーとその ID を確認するには、tasks users <folder-id>（または tasks users --folder-path <path>／--folder-key <guid>）を使ってください。

7. 操作する前に、必ず状態を確認してください。 割り当てや完了の操作を行う前に、tasks list または tasks get を使ってタスクの状態を確認してください。

8. すでに完了しているタスクは完了させないでください。 タスクの status フィールドを確認し、Completed の場合はユーザーに伝えてください。

9. 完了／カタログ／コメント／ラベル／メタデータ／データにはフォルダーのスコープが必要です。 これらのコマンドにはフォルダーが必要です。--folder-id／--folder-path／--folder-key のいずれかを指定するか、対話型ターミナルでは 3 つとも省略して一覧から選択してください。非対話型の実行（エージェント、CI）ではフォルダーの指定が必須です。指定しない場合、コマンドは A folder is required で失敗するため、必ず明示的にいずれか 1 つを指定してください。

10. 保持アクションは Delete または Archive です。 Archive には --retention-bucket-id も必要です。--encrypted は作成時のみ指定でき、更新時に変更することはできません。

11. ラベルを指定すると、既存のラベルセット全体が置き換わります。 tasks labels --labels はタスク上のすべてのラベルを上書きするため、残すラベルはすべて含めてください。すべてのラベルを消去するには [] を指定してください。

12. data save に型フラグは不要です。 コマンドがタスクの種類を自動的に判定します。タスク ID、フォルダーオプション（--folder-id／--folder-path／--folder-key）、および --data（JSON オブジェクト）を指定してください。

---

タスクのナビゲーション

タスク	使用するコマンド
すべてのタスクを一覧表示する	tasks list
フォルダー内のタスクを一覧表示する	tasks list --folder-id <id>
パス／キーでフォルダー内のタスクを一覧表示する	tasks list --folder-path "<path>" または tasks list --folder-key <guid>
管理者としてタスクを一覧表示する	tasks list --as-admin
タスクの詳細を取得する	tasks get <task-id>
タイプのヒントを指定してタスクを取得する	tasks get <task-id> --task-type FormTask --folder-id <id>
タスクを割り当てる	tasks assign <task-id> --user <email>
ユーザー ID で割り当てる	tasks assign <task-id> --user-id <id>
タスクを再割り当てする	tasks reassign <task-id> --user <email>
タスクの割り当てを解除する	tasks unassign <task-id>
タスクを完了する	tasks complete <task-id> --type <type> --folder-id <id>
アクションを指定して完了する	tasks complete <task-id> --type FormTask --folder-id <id> --action "Approve" --data '{...}'
割り当て可能なユーザーを一覧表示する	tasks users <folder-id>、tasks users --folder-path "<path>"、または tasks users --folder-key <guid>
タスクカタログを一覧表示する	tasks catalogs list --folder-id <id>
カタログを取得する	tasks catalogs get <catalog-id> --folder-id <id>
カタログを作成する	tasks catalogs create --name <name> --folder-id <id>
カタログを更新する	tasks catalogs update <catalog-id> --folder-id <id>
タスクのコメントを一覧表示する	tasks comments list <task-id> --folder-id <id>
コメントを追加する	tasks comments add <task-id> --text <text> --folder-id <id>
タスクのラベルを設定する	tasks labels <task-id> --labels '[{"name":"region","displayName":"Region","displayValue":"EMEA"}]' --folder-id <id>
タスクのメタデータを編集する	tasks metadata <task-id> --folder-id <id> [--title --priority --catalog-id]
タスクデータを取得する	tasks data get <task-id> --folder-id <id>
タスクデータを保存する	tasks data save <task-id> --data '{...}' --folder-id <id>
タスクの実行トレースを取得する（Agent/Maestro のみ）	tasks get <task-id> --output json を実行し、その後 traces spans get <trace-id> を実行します。references/task-execution-trace.md を参照してください
トレースまたはスパンにフィードバックを送信する	traces feedback create --trace-id <id> --folder-key <key> --positive。references/task-execution-trace.md を参照してください

---

ワークフロー：検出 → 計画 → 実行 → 確認

常に次のパターンに従ってください：

1. 検出 — タスクを一覧表示し、詳細を取得して、割り当て可能なユーザーを探します
2. 計画 — 操作（割り当て、完了など）を決定します
3. 実行 — 操作を実行します
4. 確認 — タスクを再読み込みし、状態が変更されたことを確認します

# 0. Ensure correct tenant
uip login status --output json
uip login tenant set <tenant-name>   # only if needed

# 1. Discover
uip tasks list --output json
uip tasks get <task-id> --output json

# 2. Plan — determine the task type, folder ID, and action needed

# 3. Act — assign a task
uip tasks assign <task-id> --user [email protected] --output json

# 4. Verify
uip tasks get <task-id> --output json

---

トラブルシューティング

エラー	原因	対処方法
Not logged in	認証の有効期限が切れています	uip login
HTTP 401	トークンが無効です	再ログインします
HTTP 403	アクセスが拒否されました	アカウントにフォルダー内の Action Center の権限があることを確認します
Missing assignee	--user-id も --user も指定されていません	--user <email> または --user-id <id> を追加します
Task not found	タスク ID が間違っています	tasks list を実行して正しい ID を取得します
完了に失敗する	--type が間違っています	tasks get を使って実際のタスクタイプを確認します
FormTask の完了に失敗する	--action または --data が指定されていません	FormTask と AppTask には --action と --data の両方が必要です
割り当てられない	ユーザーにフォルダー内の権限がありません	tasks users <folder-id> を実行して、対象ユーザーを一覧表示します
A folder is required	フォルダーオプションを指定せず、非対話モードで実行しています	--folder-id、--folder-path、または --folder-key を指定します
Folder not found: '<value>'.	パス／キーが、このログインでアクセス可能なフォルダーと一致しません	uip or folders list を実行し、一覧にある Path または Key を使用します
Invalid --folder-key: <value>	キーが UUID ではありません	uip or folders list の Key 列にある GUID を使用します
Error resolving folder path/key '<value>'	フォルダーの検索に失敗しました（権限またはネットワークの問題）	Instructions のエラー詳細を確認し、uip or folders list でアクセス権を確認します

---

参考資料

より詳しいガイダンスが必要な場合に限り、以下のファイルをお読みください。

• references/task-lifecycle.md — タスクの一覧表示と取得、タイプヒントに基づくエンドポイントのルーティング、および検出→割り当て→完了までの全ワークフロー
• references/task-completion.md — 完了エンドポイントのルーティング、タスクタイプごとの必須フィールド
• references/task-assignment.md — 割り当て、再割り当て、割り当て解除のパターンとユーザーの検索
• references/task-catalogs.md — タスクカタログの一覧表示／取得／作成／更新と保持ポリシー
• references/task-metadata.md — タスクメタデータの編集、タスクのコメントとラベル
• references/task-data.md — タスクデータの取得と保存、および保存タイプのルーティング
• references/task-execution-trace.md — Action Center の従来のアプリ内 Autopilot ツールから移植された、Agent/Maestro タスクの実行トレースの検索とフィードバック
• references/action-center-urls.md — Action Center の標準 URL パターン。タスクのディープリンクを作成または共有する前に、必ずこちらをお読みください（ポータル UI はテナントを含まない URL を「Orchestrator not enabled」と誤分類します）