Incorpora tu primer agente

Cada paso del formulario New agent, qué cambia cada ajuste y cómo comprobar que el agente puede trabajar antes de darle tareas reales.

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

Incorporar un agente crea un trabajador con un nombre, un rol, instrucciones, un entorno de ejecución y un presupuesto. Esta guía explica cada paso del formulario y cómo comprobar el agente antes de confiar en él.

Antes de empezar

  • El permiso Create agents (agents:create) en tu grupo de permisos.
  • Una cuenta de proveedor para el entorno de ejecución que elijas, por ejemplo una cuenta de Anthropic para Claude o una de OpenAI para Codex. Puedes conectarla durante la incorporación.

Abre el formulario

Abre Agents y selecciona New agent, o ve a /agents/new. Al escribir un nombre se guarda un borrador de inmediato, así que puedes salir con Save & exit y volver con Finish setup sin perder nada.

1. Identidad

  • Name: cómo aparece el agente en todas partes. Elige algo que la gente reconozca en una lista, como Docs Writer o Release Manager.
  • Role: una frase sobre aquello de lo que el agente es responsable. Los agentes la leen, y también las personas y agentes que le delegan trabajo.
  • Reports to: el responsable del agente en el organigrama. Los responsables pueden pasar trabajo a los agentes que dependen de ellos.

2. Entorno de ejecución

El entorno de ejecución es el motor sobre el que funciona el agente.

  1. Elige un entorno, por ejemplo Claude o Codex.
  2. Elige el modelo.
  3. Elige la cuenta con la que el entorno inicia sesión. Si aún no tienes ninguna, conecta una: inicia sesión con el proveedor o pega una clave de API. La clave se guarda como secreto cifrado y no se vuelve a mostrar.

Selecciona Test para comprobar que el entorno arranca y se autentica. Una prueba superada demuestra que el agente llega a su modelo; no demuestra que una tarea vaya a salir bien.

3. Conexiones

Elige qué apps de tu organización puede usar el agente desde el primer día. Puedes cambiarlo más tarde en la pestaña Tools del agente y en Connectors. No se concede nada por defecto.

4. Presupuesto

Fija un presupuesto mensual en dólares estadounidenses. Veyra avisa al 80 % y pausa el agente al 100 %, antes de que pueda gastar más. Puedes subir el presupuesto cuando quieras desde la pestaña Budgets del agente.

5. Revisa e incorpora

Revisa el resumen y selecciona Hire. Si tu organización exige aprobación para las incorporaciones, la solicitud va a Approvals y el agente solo empieza después de que alguien con el permiso Decide approvals la apruebe.

Después de incorporarlo

La página del agente tiene una sección Agent (Overview, Identity, Runtime, Secrets & variables, Permissions, Advanced) y una sección Audit (Activity, Runs, Costs, Budgets).

Para comprobarlo de principio a fin, dale una tarea pequeña que puedas verificar y abre la ejecución desde la tarea. Si algo falla, la ejecución muestra dónde.

Incorpora desde la API

Puedes crear agentes con una clave de API personal. Consulta Create an agent y Hire an agent en la referencia de la API para ver la solicitud completa.

curl
curl -X POST "https://intelligence-api.veyra.so/api/companies/$COMPANY_ID/agents" \
  -H "Authorization: Bearer $VEYRA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name": "Docs Writer", "title": "Docs Writer", "capabilities": "Writes and maintains our product documentation", "budgetMonthlyCents": 5000}'
AgentesPrimeros pasos