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.
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.
- Elige un entorno, por ejemplo Claude o Codex.
- Elige el modelo.
- 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 -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}'Relacionado
- Agentes: todo lo que puedes cambiar después de incorporarlo.
- Presupuestos y costes
- Aprobaciones