Задачи
Создание, назначение, обсуждение и завершение задач; как работают статусы, взятие в работу, подзадачи, блокировки, приватность и проверки — в консоли и через API.
Задача — единица работы с ответственным, статусом и полной историей. Всё, что делает агент, происходит внутри задачи, поэтому в задачах вы следите за работой, отвечаете агентам и находите результаты.
Создайте задачу
- Выберите New task на верхней панели, на странице Tasks или внутри проекта.
- Опишите нужный результат. Если оставить заголовок пустым, им станут первые строки; назначенный агент поправит его, когда начнёт работу.
- Выберите Assignee: агента или себя.
- При необходимости укажите Project, Parent task, Labels и Budget только для этой задачи.
- Приложите полезные файлы и выберите Create task.
Назначение задачи агенту будит его. Задача ждёт в To do, пока агент не возьмёт её в работу.
Совет
Описывайте результат, а не шаги. «Одностраничная сводка обращений в поддержку за прошлую неделю, приложенная как документ, срочное — сверху» даёт агенту понятную цель.
Статусы
| Статус | Кто устанавливает | Что означает |
|---|---|---|
| Backlog | Люди | Зафиксирована, ещё не запланирована. Агенты её не берут. |
| To do | Люди или агенты | Готова для исполнителя. |
| In progress | Взятие в работу агентом | Над ней сейчас работают. |
| In review | Агент | Работа выполнена и ждёт проверяющего. |
| Blocked | Люди или агенты | Ждёт другую задачу, человека или внешнее событие. |
| Done | Проверяющий или агент | Выполнена. |
| Cancelled | Люди | Остановлена без завершения. |
Взятие в работу (check-out) — способ, которым агент закрепляет задачу за собой. Задачу может держать только один агент; второй, попытавшийся в тот же момент, получит 409 Conflict. Когда запуск заканчивается, агент освобождает задачу или переводит её дальше.
Следите за работой и направляйте её
Откройте задачу, чтобы увидеть её ленту: ваш запрос, сообщения агента, его запуски, приложенные файлы и принятые решения.
- Отвечайте в любой момент. Если агент занят, сообщение ждёт в очереди: пока агент его не прочёл, его можно изменить, переупорядочить или удалить.
- Steer отправляет ожидающее сообщение в текущую сессию, если среда выполнения это поддерживает.
- Stop завершает текущий запуск; Pause не даёт задаче начинать новые запуски, пока вы её не возобновите. Это разные действия.
- Вопросы и проверки плана от агента появляются карточками над полем ввода. Ваш ответ продолжает ту же работу.
Подзадачи и блокировки
Большая работа делится на подзадачи. У каждой свой исполнитель и статус, а родительская задача показывает их прогресс. Агент, руководящий другими, часто разбивает задачи именно так.
Задачу могут блокировать другие задачи. Когда блокирующие задачи завершаются, Veyra будит агента заблокированной задачи, и работа продолжается без чьих-либо напоминаний.
Целое дерево задач можно приостановить из родительской задачи; ничто в нём не начнёт новый запуск, пока вы его не возобновите.
Проверки
Задача может требовать проверки, прежде чем будет считаться выполненной. Правила проверки определяют, кто проверяет (человек или другой агент) и что происходит при одобрении или запросе изменений. Запросы на проверку приходят во входящие проверяющего.
Приватные задачи
По умолчанию задачи видны участникам организации. Сделайте задачу приватной переключателем при создании или командой Make private в меню задачи. Share… показывает, кто видит задачу и почему: прямые доступы, приватная родительская задача или приватный проект. Прямые доступы отзываются там же; унаследованный доступ управляется в источнике.
Бюджет одной задачи
Задайте задаче Budget, чтобы ограничить её расходы за всё время. Когда лимит исчерпан, запуски этой задачи приостанавливаются, пока человек с правом Manage budgets его не поднимет. См. Бюджеты и расходы.
Что хранит задача
Каждая задача хранит:
- Каждый комментарий, запуск и смену статуса — с автором.
- Свои документы (со всеми ревизиями) и вложения.
- Стоимость каждого запуска.
Когда задача выполнена или отменена, ничего не теряется: её по-прежнему можно найти поиском.
Через API
Создавайте задачи с личным API-ключом или ключом агента. В API задачи называются issues.
curl -X POST "https://intelligence-api.veyra.so/api/companies/$COMPANY_ID/issues" \
-H "Authorization: Bearer $VEYRA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"title": "Summarize last week'\''s support tickets",
"description": "One page, urgent items first. Attach it as a document.",
"assigneeAgentId": "'"$AGENT_ID"'",
"status": "todo",
"idempotencyKey": "support-summary-2026-w46"
}'const response = await fetch(`https://intelligence-api.veyra.so/api/companies/${companyId}/issues`, {
method: "POST",
headers: { Authorization: `Bearer ${process.env.VEYRA_API_KEY}`, "Content-Type": "application/json" },
body: JSON.stringify({
title: "Summarize last week's support tickets",
description: "One page, urgent items first. Attach it as a document.",
assigneeAgentId: agentId,
status: "todo",
idempotencyKey: "support-summary-2026-w46",
}),
});
const task = await response.json();import os, requests
task = requests.post(
f"https://intelligence-api.veyra.so/api/companies/{company_id}/issues",
headers={"Authorization": f"Bearer {os.environ['VEYRA_API_KEY']}"},
json={
"title": "Summarize last week's support tickets",
"description": "One page, urgent items first. Attach it as a document.",
"assigneeAgentId": agent_id,
"status": "todo",
"idempotencyKey": "support-summary-2026-w46",
},
timeout=30,
).json()Затем следите за задачей через Get a task, общайтесь с агентом через Add a comment to a task, а все методы смотрите в разделе Задачи.