Workflow Management Skill

fx-api-cli

is the provided command-line program, all operations are completed by executing the

fx-api-cli

command.

fx-api-cli workflow <interface name> '<json input parameters>'

API List

workflow.instance.comment_list — Workflow Instance Comment List API

fx-api-cli workflow instance_comment_list '{"instance_id": "instance_id_1"}'

workflow.instance.get — Workflow Instance Details API

fx-api-cli workflow instance_get '{"instance_id": "instance_id_1"}'

workflow.instance.log_list — Workflow Instance Log List API

fx-api-cli workflow instance_log_list '{"instance_id": "instance_id_1"}'

workflow.instance.close — Workflow Instance Close API

fx-api-cli workflow instance_close '{"instance_id": "instance_id_1"}'

workflow.instance.activate — Workflow Instance Activate API

fx-api-cli workflow instance_activate '{"instance_id": "instance_id_1"}'

workflow.task.list — Workflow Task List API

fx-api-cli workflow task_list '{"app_id": "app_id_1", "entry_id": "entry_id_1"}'

workflow.task.approve — Workflow Task Approval API

fx-api-cli workflow task_approve '{"task_id": "task_id_1", "remark": "Approved"}'

workflow.task.rollback — Workflow Task Rollback API

fx-api-cli workflow task_rollback '{"task_id": "task_id_1", "remark": "Rollback"}'

workflow.task.transfer — Workflow Task Transfer API

fx-api-cli workflow task_transfer '{"task_id": "task_id_1", "user_id": "user_id_1", "remark": "Transfer"}'

workflow.task.add_sign — Workflow Task Add Signer API

fx-api-cli workflow task_add_sign '{"task_id": "task_id_1", "user_id": "user_id_1", "remark": "Add signer"}'

workflow.task.revoke — Workflow Task Revoke API

fx-api-cli workflow task_revoke '{"task_id": "task_id_1", "remark": "Revoke"}'

workflow.task.reject — Workflow Task Reject API

fx-api-cli workflow task_reject '{"task_id": "task_id_1", "remark": "Reject"}'

workflow.cc.list — Workflow CC List API

fx-api-cli workflow cc_list '{"instance_id": "instance_id_1"}'

Core Rules

Instance ID Search Rule

• When the user needs to operate a workflow instance but does not provide the instance ID:
  1. Call

     workflow.task.list

     to get the task list
  2. Extract the instance ID from the task list
  3. Matching Strategy:
     • Exact match with unique result: use directly
     • Fuzzy match with multiple results: display candidate list for user to choose
     • No matching result: inform the user that no result is found

Task ID Search Rule

• When the user needs to operate a workflow task but does not provide the task ID:
  1. Call

     workflow.task.list

     to get the task list
  2. Filter tasks according to the conditions provided by the user (such as task status, creation time, etc.)
  3. Matching Strategy:
     • Exact match with unique result: use directly
     • Fuzzy match with multiple results: display candidate list for user to choose
     • No matching result: inform the user that no result is found

Approval Rules

• Approval Opinion: Operations such as approval, rejection, and rollback must provide approval opinions
• Operation Confirmation: You must confirm with the user before performing operations such as approval, rejection, and closing

Typical Workflows

Query Workflow Instance Details

• "Help me query the details of the workflow instance"
• "View workflow instance information"

1. Determine the

   instance_id

   of the target instance through the Instance ID Search Rule
2. Call

   workflow.instance.get

   to get the instance details
3. Display the instance status, creation time, initiator and other information

Query Workflow Instance Logs

• "Help me query the workflow instance logs"
• "View the operation records of the workflow instance"

1. Determine the

   instance_id

   of the target instance through the Instance ID Search Rule
2. Call

   workflow.instance.log_list

   to get the log list
3. Display the operation time, operator, operation type and operation content of each log

Query Workflow Task List

• "Help me query workflow tasks"
• "View pending workflow tasks"

1. Determine query parameters (application ID, form ID, task status, etc.)
2. Call

   workflow.task.list

   to get the task list
3. Display the task ID, status, creation time, processor and other information of each task

Approve Workflow Task

• "Help me approve this workflow task"
• "Approve this workflow"

1. Determine the

   task_id

   of the target task through the Task ID Search Rule
2. Collect the approval opinion provided by the user
3. Confirm the approval operation with the user
4. Call

   workflow.task.approve

   to approve the task
5. Display the approval result

Reject Workflow Task

• "Help me reject this workflow task"
• "Reject this workflow"

1. Determine the

   task_id

   of the target task through the Task ID Search Rule
2. Collect the rejection opinion provided by the user
3. Confirm the rejection operation with the user
4. Call

   workflow.task.reject

   to reject the task
5. Display the rejection result

Transfer Workflow Task

• "Help me transfer this workflow task"
• "Transfer the task to someone else"

1. Determine the

   task_id

   of the target task through the Task ID Search Rule
2. Collect the recipient ID and transfer opinion provided by the user
3. Confirm the transfer operation with the user
4. Call

   workflow.task.transfer

   to transfer the task
5. Display the transfer result

Error Handling

• Instance not found: Clearly inform the user that the corresponding workflow instance is not found
• Task not found: Clearly inform the user that the corresponding workflow task is not found
• Insufficient permissions: Clearly inform the user that they have no permission to perform the operation
• API error: Display specific error information, retry if necessary
• Network problem: Actively retry up to 3 times when HTTP error occurs