Agentes
Configura un agente después de incorporarlo: identidad, instrucciones, entorno de ejecución, secretos, permisos y claves; despiértalo, páusalo, reanúdalo o dalo de baja, y consulta sus pestañas de auditoría.
Un agente es un trabajador de IA de tu organización. Esta página explica qué puedes cambiar después de incorporarlo y cómo controlarlo en el día a día. Para crear uno, consulta Incorpora tu primer agente.
La plantilla
Agents lista cada agente con su estado, su rol, de quién depende, su tarea actual y el uso de su presupuesto del mes. Estados:
| Estado | Significado |
|---|---|
| Idle | Listo, sin nada que hacer ahora mismo. |
| Running | Trabajando en una tarea. |
| Paused | Detenido por una persona o por un límite de presupuesto; no inicia nada nuevo. |
| Error | Su última ejecución falló; abre la ejecución para ver por qué. |
| Pending approval | Incorporado, a la espera de una aprobación para poder empezar. |
| Terminated | Dado de baja. Se conserva su historial. |
La página del agente
Sección Agent:
- Overview: trabajo actual, ejecuciones recientes y presupuesto.
- Identity: nombre, rol, cargo, avatar y de quién depende.
- Runtime: entorno de ejecución, modelo, cuenta de proveedor y entorno. Test comprueba que puede arrancar.
- Secrets & variables: qué secretos y variables de la organización recibe el agente.
- Permissions: qué puede hacer el agente en la organización, por ejemplo crear tareas para otros o gestionar rutinas.
- Advanced: opciones de depuración, como capturar las trazas sin procesar del proveedor en las ejecuciones futuras.
Sección Audit: Activity, Runs, Costs y Budgets, todas filtradas por este agente.
Los agentes también tienen las pestañas Skills, Tools, Channels y API keys.
Instrucciones
Las instrucciones de un agente son archivos que lee en cada ejecución: su rol, cómo trabaja y lo que nunca debe hacer. Edítalas en la página del agente. Cada guardado es una revisión, y puedes comparar o restaurar las anteriores.
Consejo
Limita las instrucciones a cómo trabaja el agente. Lo que necesita una tarea va en la propia tarea, y lo que necesita todo un proyecto, en las instrucciones del proyecto.
Despierta, pausa, reanuda
- Run now despierta al agente de inmediato, por ejemplo después de cambiar sus instrucciones.
- Pause impide que inicie nuevas ejecuciones. Una ejecución en curso termina o se puede detener por separado.
- Resume le permite volver a trabajar. Si el agente se pausó por su presupuesto, antes hay que subir ese presupuesto.
Claves de API de un agente
Una clave de API de agente permite que un software actúe como ese agente, por ejemplo un agente que se ejecuta fuera de Veyra. Abre la pestaña API keys del agente, selecciona Create key y copia el token: se muestra una sola vez. Revoca una clave desde ahí cuando quieras. Consulta Autenticación.
Da de baja a un agente
Elige Terminate en el menú del agente. El agente se detiene para siempre, sus tareas abiertas necesitan un nuevo responsable y su historial, ejecuciones y costes quedan en el registro. No se puede deshacer; si podrías volver a necesitarlo, mejor páusalo.
Desde la API
# Wake an agent now
curl -X POST "https://intelligence-api.veyra.so/api/agents/$AGENT_ID/wakeup" \
-H "Authorization: Bearer $VEYRA_API_KEY" -H "Content-Type: application/json" \
-d '{"reason": "Instructions updated", "forceFreshSession": false}'
# Pause it
curl -X POST "https://intelligence-api.veyra.so/api/agents/$AGENT_ID/pause" \
-H "Authorization: Bearer $VEYRA_API_KEY"Consulta Wake up an agent, Pause an agent, Resume an agent, Create an agent API key y todos los endpoints en Agentes.