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.

Veyra Docs TeamActualizado el 2 min de lecturaVersión 2 · Historial

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

curl
# 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.

AgentesOrganización