Search

Jump to a page or agent

Primeros pasos

Tu primer agente

De crear el agente a verlo responder, en cinco minutos.

El camino más corto de cero a un agente que responde. Al final vas a tener un agente configurado, probado desde la consola, y sabrás dónde seguir para publicarlo.

Crear el agente

En Agents, el botón New agent abre el flujo de creación a pantalla completa y te pregunta de dónde parte el agente. Hay dos caminos y ninguno te pide más de lo necesario:

  • Desde una plantilla. La galería trae dieciocho configuraciones de partida —soporte, reservas, recepción, estado de pedidos— cada una con su prompt, su mensaje de apertura y su workflow ya dibujado. Eliges una, revisas el nombre y el objetivo principal, y creas. Lo que veas en la vista previa es lo que va a llevar el agente. Está contado en Plantillas.
  • En blanco. Pide una sola cosa: el nombre. No es un formulario incompleto — todo lo demás está a un campo de distancia en la pantalla de configuración a la que te deja, y pedirlo antes solo te haría decidir cosas sin contexto.

Por cualquiera de los dos aterrizas en el agente, con su configuración abierta. Si quieres salir a medias, hay una X, Escape cierra, y el Atrás del navegador funciona: esto es una ruta, no un modal.

Al crearlo, la plataforma le asigna automáticamente un entorno por defecto. Puedes cambiarlo después; no hace falta crear uno a mano para empezar.

Configurar qué dice

Agents → <tu agente> → Configure es el editor. Está en dos columnas y el reparto tiene una lógica:

  • La izquierda es lo que el agente DICE y PUEDE HACER: el system prompt, la línea de apertura, las skills, las herramientas.
  • La derecha es QUÉ AGENTE ES: el nombre, el modelo, y los vaults de credenciales que heredan sus sesiones.

Lo mínimo para que responda es el system prompt y el modelo. Escribe el prompt como le hablarías a alguien que empieza el primer día: qué hace, para quién, y qué no debe hacer.

Nota

El botón con la varita junto a «System prompt» genera un prompt con IA, y solo aplica el prompt. El endpoint devuelve una configuración completa —nombre, modelo, herramientas— y todo eso se descarta a propósito: un control que dice «System prompt» y de paso te cambia el modelo sería una mentira.

Elegir modelo

El selector agrupa por familia, no por proveedor, porque lo que comparten los modelos de una familia es la credencial y las particularidades del protocolo. Cada opción dice qué acepta: imágenes, PDF. Eso importa porque es lo que se pierde en silencio al cambiar de familia — los PDF, por ejemplo, solo funcionan en Anthropic.

Puedes cambiar el modelo cuando quieras, incluso a otro proveedor. Las sesiones ya abiertas siguen con el que tenían.

Probarlo

El panel de vista previa del agente monta el widget real —el mismo que va a usar un cliente— contra una clave de consumo. No es una simulación: si funciona ahí, funciona embebido.

Escríbele algo que obligue a usar una herramienta, no solo a conversar. Es la diferencia entre saber que el modelo responde y saber que el agente funciona.

Ver qué hizo

En Sessions está la conversación completa. La pestaña Transcript muestra lo que pasó en orden —lo que dijiste, lo que pensó, qué herramientas llamó— y Debug muestra los tokens y el costo de cada petición al modelo.

Si algo falló, el error crudo está ahí, tal cual lo devolvió el proveedor.

Publicarlo

Ya tienes un agente que responde. Para que lo alcancen desde fuera:

Y antes de exponerlo a gente real, vale la pena leer Guardrails: sin reglas de herramientas, un agente con entorno puede llegar a internet aunque tenga la búsqueda web desmarcada.