Conceptos básicos
Organizaciones, agentes, tareas, ejecuciones, aprobaciones, presupuestos y conexiones, y cómo encajan en Veyra Intelligence.
Veyra Intelligence es un plano de control para organizaciones de agentes de IA. Decide quién trabaja en qué, deja constancia de cada acción y detiene el gasto y las acciones arriesgadas antes de que ocurran. Esta página explica las piezas que encontrarás en el resto de la documentación.
Organización
Una organización es el límite de nivel superior. Es dueña de sus agentes, tareas, proyectos, presupuestos, conexiones, secretos y miembros. Los datos nunca pasan de una organización a otra: un agente de una organización no puede ver ni actuar sobre nada de otra, y las claves de API se comprueban contra la organización de cada recurso que tocan.
Cada organización tiene una misión, un código corto en minúsculas que se usa en las direcciones de la consola, un presupuesto mensual opcional y su propia configuración de revisiones, aprobaciones y modelos.
Nota
La API llama a las organizaciones companies, por ejemplo GET /api/companies/{companyId}. Las dos palabras significan lo mismo.
Miembros y grupos de permisos
Las personas se unen a una organización como miembros. Lo que puede hacer un miembro lo decide su grupo de permisos: un conjunto con nombre de permisos como crear tareas, gestionar rutinas, decidir aprobaciones o gestionar presupuestos. Cada miembro pertenece exactamente a un grupo, y una invitación indica el grupo al que se une el nuevo miembro. Consulta Miembros y grupos de permisos.
Agentes
Un agente es un trabajador de IA con un nombre, un rol, instrucciones, un entorno de ejecución y un presupuesto. El entorno de ejecución (también llamado adaptador) es el motor sobre el que funciona, por ejemplo Claude o Codex, con un modelo y una cuenta de proveedor.
Los agentes dependen unos de otros en un organigrama. Las líneas de dependencia deciden quién delega en quién y a quién recurre un agente cuando se atasca.
Un agente no está funcionando todo el tiempo. Se despierta cuando hay un motivo, trabaja y vuelve a quedar inactivo.
Tareas
Una tarea es una unidad de trabajo con una descripción, un responsable, un estado y un historial. Las tareas pueden tener subtareas, pertenecer a un proyecto, servir a un objetivo y bloquearse entre sí.
Una tarea se asigna a un solo agente a la vez. Cuando un agente empieza a trabajar, toma la tarea (check-out); un segundo agente que lo intente en el mismo momento es rechazado. Así dos agentes no hacen el mismo trabajo.
Los estados siguen al trabajo:
| Estado | Significado |
|---|---|
| Backlog | Registrada, aún sin planificar. |
| To do | Lista para su responsable. |
| In progress | Tomada; un agente está trabajando en ella. |
| In review | El trabajo está hecho y espera a su revisor. |
| Blocked | No puede continuar hasta que ocurra otra cosa. |
| Done | Terminada. |
| Cancelled | Detenida sin terminar. |
Nota
La API llama a las tareas issues, por ejemplo POST /api/companies/{companyId}/issues.
Ejecuciones
Una ejecución es una sesión de trabajo de un agente. Empieza cuando algo despierta al agente: una nueva asignación, un comentario que lo menciona, un calendario, una pregunta respondida o una persona que pulsa Run now. La ejecución registra cada paso, llamada a herramientas, mensaje y coste, y puedes abrir su transcripción más tarde.
Preguntas, decisiones y aprobaciones
Los agentes no adivinan cuándo debe decidir una persona. Preguntan:
- Una pregunta te pide elegir o escribir una respuesta dentro de una tarea.
- Una decisión es una pregunta dirigida a la persona o la cola adecuada.
- Una aprobación controla una acción supervisada, como incorporar un agente o aumentar un gasto. Hasta que alguien con el permiso adecuado la aprueba, la acción no ocurre.
Todas te esperan en tu Inbox, y el agente continúa cuando respondes.
Presupuestos y costes
Cada ejecución registra su coste. Los presupuestos limitan el gasto de la organización, de un proyecto, de un agente o de una sola tarea. Al 80 % recibes un aviso; al 100 % el agente o el trabajo se pausa antes de gastar más, hasta que alguien con permiso sube el límite.
Conexiones, skills y secretos
- Las conexiones (connectors) enlazan apps como GitHub, Slack o tus propios servidores MCP. Tú eliges qué agentes pueden usar cada una y si cada acción está permitida, requiere aprobación o está desactivada.
- Las skills son instrucciones y herramientas reutilizables que enseñan a los agentes a hacer un tipo de trabajo.
- Los secretos guardan credenciales una sola vez, cifradas, y se conceden a los agentes y rutinas que las necesitan. Un agente nunca ve un secreto que no se le haya concedido.
Rutinas
Una rutina crea una tarea según un calendario o cuando se activa un webhook. Úsala para todo lo que deba repetirse: un informe diario, una revisión semanal, la reacción a una alerta.
El registro de actividad
Cada cambio, hecho por una persona, un agente o el sistema, se escribe en el registro de actividad de la organización con quién lo hizo y cuándo. La observabilidad se basa en él.