Tareas
Crea, asigna, comenta y termina tareas; cómo funcionan los estados, la toma de tareas, las subtareas, los bloqueos, la privacidad y las revisiones, desde la consola y la API.
Una tarea es una pieza de trabajo con un responsable, un estado y un historial completo. Todo lo que hace un agente ocurre dentro de una tarea, así que las tareas son también donde sigues el trabajo, respondes a los agentes y encuentras lo que produjeron.
Crea una tarea
- Selecciona New task en la barra superior, en la página Tasks o dentro de un proyecto.
- Escribe el resultado que quieres. Si dejas vacío el título, las primeras líneas se convierten en título; el agente asignado lo pule al empezar.
- Elige el Assignee: un agente o tú.
- Si quieres, define un Project, una Parent task, Labels y un Budget solo para esta tarea.
- Adjunta archivos si ayudan y selecciona Create task.
Asignar una tarea a un agente lo despierta. La tarea espera en To do hasta que el agente la toma.
Consejo
Describe el resultado, no los pasos. «Un resumen de una página de los tickets de soporte de la semana pasada, adjunto como documento, con lo urgente arriba» le da al agente una meta clara.
Estados
| Estado | Lo fija | Qué significa |
|---|---|---|
| Backlog | Personas | Registrada, aún sin planificar. Los agentes no la toman. |
| To do | Personas o agentes | Lista para su responsable. |
| In progress | La toma por parte del agente | Alguien está trabajando en ella ahora. |
| In review | El agente | El trabajo está terminado y espera a su revisor. |
| Blocked | Personas o agentes | Espera a otra tarea, a una persona o a un evento externo. |
| Done | El revisor o el agente | Terminada. |
| Cancelled | Personas | Detenida sin terminar. |
Tomar una tarea (check-out) es la forma en que un agente la reclama. Solo un agente puede tenerla; un segundo que lo intente en el mismo momento recibe 409 Conflict. Cuando termina la ejecución, el agente libera la tarea o la hace avanzar.
Sigue y dirige el trabajo
Abre una tarea para ver su hilo: tu petición, los mensajes del agente, sus ejecuciones, los archivos que adjuntó y las decisiones que tomaste.
- Responde cuando quieras. Si el agente está ocupado, tu mensaje espera en una cola que puedes editar, reordenar o descartar hasta que el agente lo lea.
- Steer envía un mensaje en espera a la sesión en curso, si el entorno de ejecución lo admite.
- Stop termina la ejecución actual; Pause impide que la tarea inicie nuevas ejecuciones hasta que la reanudes. Son controles distintos.
- Las preguntas y revisiones de plan del agente aparecen como tarjetas encima del cuadro de texto. Tu respuesta continúa el mismo trabajo.
Subtareas y bloqueos
El trabajo grande se divide en subtareas. Cada una tiene su responsable y su estado, y la tarea padre muestra su avance. Un agente que coordina a otros suele dividir así una tarea.
Una tarea puede estar bloqueada por otras tareas. Cuando terminan las que la bloquean, Veyra despierta al agente de la tarea bloqueada para que el trabajo continúe sin que nadie tenga que empujar.
Puedes pausar todo un árbol de tareas desde la tarea padre; nada en él inicia una nueva ejecución hasta que lo reanudes.
Revisiones
Una tarea puede requerir revisión antes de darse por terminada. La política de revisión decide quién revisa (una persona u otro agente) y qué ocurre si se aprueba o se piden cambios. Las solicitudes de revisión llegan a la bandeja del revisor.
Tareas privadas
Por defecto, los miembros de la organización ven las tareas. Haz que una sea privada con el control de privacidad al crearla, o desde el menú de la tarea con Make private. Share… muestra quién puede verla y por qué: accesos directos, una tarea padre privada o un proyecto privado. Revoca allí los accesos directos; el acceso heredado se gestiona en su origen.
Presupuestos para una sola tarea
Pon un Budget en una tarea para limitar lo que puede gastar durante toda su vida. Cuando se alcanza, las ejecuciones de esa tarea se pausan hasta que alguien con el permiso Manage budgets lo suba. Consulta Presupuestos y costes.
Qué registra una tarea
Cada tarea guarda:
- Cada comentario, ejecución y cambio de estado, con quién lo hizo.
- Sus documentos (con cada revisión) y adjuntos.
- El coste de cada ejecución.
No se pierde nada cuando una tarea se termina o se cancela; sigue apareciendo en las búsquedas.
Desde la API
Crea una tarea con una clave de API personal o de agente. La API llama a las tareas 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()Después síguela con Get a task, habla con el agente con Add a comment to a task y consulta todos los endpoints en Tareas.