- Who can: any member of your company
- Where in Cargofy: Tasks, and Studio › Digital Workers
What it is
The assistant manages your tasks on your behalf: it creates them with subtasks and deadlines, assigns, comments, attaches and reads files. Cargofy saves its changes and comments under your name. A task is also how the assistant starts a Digital Worker, an AI worker your company sets up in Studio: a task in “To do” assigned to a worker starts it.
Important
A task in “To do” assigned to a Digital Worker starts the worker. This happens when the task is created that way, when it moves to “To do”, and when it gets a new worker while in “To do”. Cargofy starts the worker at once, and the worker acts by its own instructions. The assistant cannot pause or stop a worker: that is done in Cargofy, outside the assistant. Keep the task in “Backlog” to assign it without starting, for example: “Assign it to Demo: Request dispatcher, keep it in Backlog.” To keep control, say it at the start of the chat: “Ask me before you start any Digital Worker.”
What it can do
A task from start to finish
A dispatcher’s conversation with the assistant and Cargofy’s real answers. The terms are in the Glossary. The tools behind each step are in the table at the end.
1. Create the task with a subtask and a deadline
Create a task “Demo: Check the Kyiv → Lviv request”, priority high, due tomorrow at 17:00 UTC, with a subtask “Demo: Confirm the loading time”.
Cargofy saves both tasks in “Backlog”. The deadline is in UTC, see Create and organize tasks. The subtask gets no deadline: give it one if it needs it.
2. Attach a file
Attach a CSV to the task with these rates: Kyiv-Lviv 25,000 UAH, Odesa-Dnipro 21,000 UAH. Then read it back.
The assistant writes the file itself and attaches it. Cargofy reads it back as rows:
Lane | Rate | Currency
Kyiv-Lviv | 25000 | UAH
Odesa-Dnipro | 21000 | UAH3. Block the subtask
Block the subtask: we are waiting for the consignee.
Cargofy moves the subtask to “Blocked” and saves the reason as your comment on it. Give the reason with the block.
4. Give the task to a Digital Worker
Give the task to Demo: Request dispatcher and start it now.
The assistant finds the worker by name, assigns the task and moves it to “To do”. The worker starts.
5. Check the task
What is the status of the task now?
The assistant reads the task: its status, priority, deadline and assignee. The worker’s answer is in the task in Cargofy.
| Step | Tool | What the assistant sends |
|---|---|---|
| 1 | tasks-create, tasks-update | title, priority; the subtask with parent_id of the task; deadline in UTC with tasks-update |
| 2 | tasks-add-attachment, then tasks-read-attachment | file_name, mime_type text/csv, content_base64; then the id from the answer as attachment_id |
| 3 | tasks-update | status blocked with comment |
| 4 | config-surfaces-list, tasks-assign, tasks-update | the worker’s id from the agent surface as assignee_id with assignee_type agent; then status todo |
| 5 | tasks-get | task_id |
Create and organize tasks
Create a task “Demo: Prepare the December tenders”, priority urgent, with subtasks “Demo: Collect lanes” and “Demo: Call carriers”. Due December 1 at 12:00 UTC.
A task has a title, a description, a status, a priority, a deadline and an assignee. A subtask is a task with a parent task. The assistant creates the task, then the subtasks. You can move a task under another parent, but not under its own subtask.
| Setting | Values |
|---|---|
| Status | “Backlog” (default), “To do”, “In progress”, “Blocked”, “Done”, “Cancelled” |
| Priority | “Low”, “Medium” (default), “High”, “Urgent” |
| Deadline | a date and a time in UTC, such as 2026-12-01T12:00:00Z: 17:00 in Kyiv is 15:00 UTC in winter and 14:00 UTC in summer. A date without a time is 00:00 UTC |
| Assignee | a Digital Worker or a person. See Assign a task |
Assign a task
Assign “Demo: Collect lanes” to user ID 101.
The assistant finds Digital Workers by name. It assigns a person by user ID. Assigning a worker to a task in “To do” starts the worker.
Start a Digital Worker
Give Demo: Request dispatcher a task “Demo: Check the request Kyiv → Lviv”. Start it now.
The assistant creates the task in “To do” with the worker as the assignee, in one call: tasks-create with status todo, assignee_type agent and the worker’s assignee_id. The worker starts and works by its own instructions. A paused worker does not start.
Keep tasks up to date
Comment on “Demo: Prepare the December tenders”: weight is 20 t. Mark “Demo: Call carriers” as done. Which tasks are blocked?
The assistant comments as you, changes the status, the priority, the title, the description and the deadline. It finds tasks with tasks-list by text in the title or description, by status, by assignee or by parent task. The answer holds the newest tasks: narrow the question to see older ones. To find subtasks, name the parent task. One task comes back with its number of subtasks.
Attach and read files
Attach a note to my comment on the task: loading at 08:00, gate 3. Then read the file back.
The assistant attaches a file it writes or you give it in the chat, to a task or to one of its comments, up to 25 MB. It reads Word (.docx), Excel (.xlsx), CSV, text and Markdown files as text; a table comes back as rows. For an image or a PDF it gets the file’s name and a link that works for one hour, not the content.
Glossary
The words of this page, what they mean in Cargofy and the name the assistant works with. Paste this table into the chat or add it to your assistant’s project knowledge.
| Term | Meaning | The assistant sees |
|---|---|---|
| Task | A piece of work for a person or a Digital Worker | task with id, title, description |
| Subtask | A task inside another task | parent_id; the parent shows children_count |
| Status | Where the task is | status: backlog “Backlog”, todo “To do”, in_progress “In progress”, blocked “Blocked”, done “Done”, cancelled “Cancelled” |
| Priority | How urgent the task is | priority: low, medium, high, urgent |
| Deadline | When the task is due, in UTC | deadline |
| Assignee | Who does the task | assignee_type: agent for a Digital Worker, user for a person; assignee_id |
| Digital Worker | A worker set up in Studio › Digital Workers | id of the agent surface in config-surfaces-list |
| Person | A member of your company | a user ID, a number |
| Start a worker | A task in “To do” assigned to a worker | status todo with assignee_type agent |
| Block | Stop a task with a reason | status blocked with comment |
| Comment | A note on a task | tasks-comment; the comment field of tasks-update |
| Attachment | A file on a task or a comment | tasks-add-attachment, tasks-read-attachment; the attachment id |
Limits
- The assistant cannot read comments, the worker’s answer included: it sees the status only.
- The assistant assigns a person by user ID.
- Only images (PNG, JPEG, GIF, WebP), PDF, Word (.docx), Excel (.xlsx), CSV, text and Markdown files are accepted.
- Tasks cannot be deleted over MCP: cancel them instead. A cancelled or done task can be moved back to any status.