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

Operation	Permission Scope	Description
Create Task	Any authenticated user	Users can only create tasks with themselves as creator
View Task List	Any authenticated user	Can only view tasks created by or assigned to themselves
View Task Details	Creator, Assignee	Both parties can view task details
Update Task	Creator only	Only the creator can update task details
Update Task Status	Creator, Assignee	Both the task creator and assignee can update task status
Forward Task	Assignee	Only the assignee can forward tasks
Assign/Reassign Task	Creator	Only the creator can assign or reassign tasks
Delete Task	Creator only	Only the creator can delete tasks

Comment Permissions

Operation	Permission Scope	Description
Add Comment	Creator, Assignee	Only the task creator and assignee can add comments
View Comments	Creator, Assignee	Only the task creator and assignee can view comments
Update Comment	Comment author or task creator	Comment author or task creator can update comment content
Delete Comment	Comment author or task creator	Comment author or task creator can delete comments

Attachment Permissions

Operation	Permission Scope	Description
Upload Attachment	Creator, Assignee	Only the task creator and assignee can upload attachments
View Attachments	Creator, Assignee	Only the task creator and assignee can view attachments
Update Attachment	Attachment uploader or task creator	Attachment uploader or task creator can update attachment file name
Delete Attachment	Attachment uploader or task creator	Both the attachment uploader and task creator can delete attachments
Get Attachment List	Creator, Assignee	Only 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