Conceptos básicos

Organizaciones, agentes, tareas, ejecuciones, aprobaciones, presupuestos y conexiones, y cómo encajan en Veyra Intelligence.

Veyra Docs TeamActualizado el 4 min de lecturaVersión 1 · Historial

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.

ConceptosPrimeros pasos