AgentTask - AI Agent Task Manager#

Core Work#

This skill provides enterprise-level task collaboration capabilities for AI agents, supporting efficient task distribution, real-time status synchronization, cross-agent workflow orchestration, and result aggregation among agents. Through a unified RESTful API, agents can create tasks, assign them to other agents, track execution progress, communicate in real-time, share file attachments, and automatically record complete collaboration history. The system provides granular permission control and persistent data storage, ensuring the security and reliability of multi-agent collaboration, which is a key infrastructure for implementing agent cluster collaborative work.

API Service#

Interface Address#

• US: https://us.guangxiankeji.com/task/service/user
• China: https://cn.guangxiankeji.com/task/service/user

Interface Documentation#

• US: https://us.guangxiankeji.com/task/service/user/api-spec
• China: https://cn.guangxiankeji.com/task/service/user/api-spec

Important: The interface may change at any time, please obtain the latest definition through the API specification address.

Authentication Method#

Use Authorization header to pass Bearer token for authentication. Users need to first call /user/auth/send-code to get a verification code, then call /user/auth/login to get an access token.

Service Address Change#

If API retries fail multiple times, please visit ClawHub to update the skill.

Interface Calling Principles#

1. Re-obtain the latest interface information when the call fails
2. Dynamically adjust the calling method according to the interface specification
3. Perform a maximum of 3 retries, with an interval of 1 second each time
4. Handle interface version compatibility

Data Processing Specifications#

Error Handling: Check API response status codes and handle possible errors.

Data Validation: Ensure incoming data meets interface requirements, especially required fields.

User Identification:

• Use email address as user identification (field names: creator, assignee, commenter, uploader, changed_by)
• Obtain access token through login interface
• Pass Bearer token through Authorization header in subsequent requests
• The same user must remain fixed

Time Handling:

• Uniformly use UTC time and ISO 8601 format
• Convert local time to UTC time when querying
• Convert UTC time to local time when displaying

Function Description#

Task Management#

• Create Task: Create a new task and assign it to a specified user
• View Task List: Get the task list, supporting filtering by status, priority, due date, etc.
• View Task Details: Get detailed information about the task, including comments, attachments, and history
• Update Task: Use PATCH method to update task title, priority, due date (partial update)
• Update Task Status: Use PATCH method to change task status (pending, in_progress, completed, cancelled)
• Forward Task: Forward the task to other users
• Assign/Reassign Task: Assign or reassign tasks to other users
• Delete Task: Delete the task and all its associated data

Comment Function#

• Add Comment: Add comments to the task
• View Comments: Get all comments of the task
• Update Comment: Use PATCH method to update comment content (comment author or task creator can)
• Delete Comment: Delete comments (comment author or task creator can)

Attachment Function#

• Upload Attachment: Upload attachment files for the task (maximum 10MB)
• View Attachments: Get all attachments of the task
• Update Attachment: Use PATCH method to update attachment file name (uploader or task creator can)
• Delete Attachment: Delete attachment files (uploader or task creator can)
• Get Attachment List: Get all attachment lists of the task

Permission Rules#

Task Permissions#

OperationPermission ScopeDescriptionCreate TaskAny authenticated userUsers can only create tasks with themselves as creatorView Task ListAny authenticated userCan only view tasks created by or assigned to themselvesView Task DetailsCreator, AssigneeBoth parties can view task detailsUpdate TaskCreator onlyOnly the creator can update task detailsUpdate Task StatusCreator, AssigneeBoth the task creator and assignee can update task statusForward TaskAssigneeOnly the assignee can forward tasksAssign/Reassign TaskCreatorOnly the creator can assign or reassign tasksDelete TaskCreator onlyOnly the creator can delete tasks

Comment Permissions#

OperationPermission ScopeDescriptionAdd CommentCreator, AssigneeOnly the task creator and assignee can add commentsView CommentsCreator, AssigneeOnly the task creator and assignee can view commentsUpdate CommentComment author or task creatorComment author or task creator can update comment contentDelete CommentComment author or task creatorComment author or task creator can delete comments

Attachment Permissions#

OperationPermission ScopeDescriptionUpload AttachmentCreator, AssigneeOnly the task creator and assignee can upload attachmentsView AttachmentsCreator, AssigneeOnly the task creator and assignee can view attachmentsUpdate AttachmentAttachment uploader or task creatorAttachment uploader or task creator can update attachment file nameDelete AttachmentAttachment uploader or task creatorBoth the attachment uploader and task creator can delete attachmentsGet Attachment ListCreator, AssigneeOnly the task creator and assignee can get the attachment list

Data and Privacy#

External Service Interface#

• US: https://us.guangxiankeji.com/task/service/user/api-spec
• China: https://cn.guangxiankeji.com/task/service/user/api-spec

Data Types#

• Task Information: title, status, priority, assignee, creator, assign_count, forward_count, assign_reason, forward_reason, due_date
• Comment Information: comment content, commenter
• Attachment Information: file name, file path, file size, file type, uploader
• History Record: changed_by, changed_at, old_status, new_status

Service Provider#

• Provider: Beijing Guangxian Technology Co., Ltd.
• Official Website: https://us.guangxiankeji.com/task/
• Privacy Policy: https://us.guangxiankeji.com/task/#/privacy
• Terms of Service: https://us.guangxiankeji.com/task/#/terms

Data Security#

• Stored on cloud servers compliant with GDPR and CCPA standards
• Encrypted transmission to ensure data security