Guía rápida
Construí, probá y publicá un agente de IA, y después llamalo desde tu código.
1. Creá una cuenta
Registrate con Continuar con Google, o con email y contraseña — en ese caso verificá tu email cuando llegue el mensaje. Si te registrás con Google no hace falta verificar, porque Google ya confirmó la dirección. Las cuentas nuevas reciben 100 créditos gratis, suficiente para unas cuantas ejecuciones cortas.
:::tip ¿Ya tenés una cuenta con contraseña? Si entrás con Google usando el mismo email, las dos quedan vinculadas — siempre que esa dirección esté verificada en tu cuenta de Google. Después podés entrar con cualquiera de los dos métodos y sigue siendo una sola cuenta: tus agentes, ejecuciones y créditos quedan intactos. :::
:::warning Los créditos gratis vencen El bono de registro vence a los 90 días. Los créditos que comprás no vencen — solo el bono inicial. :::
2. Agregá una clave de proveedor LLM
Las ejecuciones usan tus claves, no las nuestras. Antes de la primera ejecución, andá a Dashboard → Settings → LLM Keys y agregá una clave de al menos un proveedor (OpenAI, Anthropic o Gemini).
Las claves se cifran con AES-256-GCM en reposo y se descifran únicamente dentro del worker que ejecuta tu agente. Nunca se registran en logs ni vuelven al navegador después de guardarlas.
3. Creá un agente
- Andá a Dashboard → Agents → New Agent.
- Elegí un patrón — ReAct, cadena de pensamiento, autorreflexión y otros vienen pre-armados — o arrancá con un canvas vacío.
- Ponele nombre y hacé clic en Create.
Caés en el editor de canvas.
4. Armá el flujo
El canvas tiene tres zonas: la paleta de nodos a la izquierda, el grafo en el medio y el panel de configuración a la derecha.
- Arrastrá nodos desde la paleta al canvas.
- Conectalos arrastrando desde el conector de un nodo al de otro.
- Hacé clic en cualquier nodo para configurarlo en el panel derecho.
- Tocá Review en la barra para ver qué falta — cada ítem te lleva directo al nodo que necesita atención.
Un agente mínimo es Input → Agent → Output. Mirá la
referencia de nodos para ver qué hace cada tipo.
Guardá con ⌘S o el botón Save changes.
5. Probalo
Hacé clic en Test. El runner transmite el progreso en vivo por cada nodo — estado, tokens, latencia y la salida de cada paso — así ves dónde falló la ejecución en vez de adivinar desde un error final.
Como traés tus propias claves, los tokens LLM no se cobran en créditos — le pagás directo a tu proveedor. Los créditos se cobran solo por llamadas a herramientas, así que un agente que únicamente llama al LLM cuesta 0 créditos. Mirá Facturación para las tarifas exactas.
6. Publicá
Abrí Settings en la barra del agente y hacé clic en Publish. Esto pasa el agente de borrador a publicado y habilita el acceso por API.
Los agentes en borrador solo se pueden probar desde el dashboard. Tenés que publicar antes de poder crear una API key o llamar al agente desde tu código.
7. Llamalo desde tu código
En esa misma página de Settings, creá una API key para el agente. Copiala en el momento — se muestra una sola vez.
curl -X POST https://tu-dominio.com/api/v1/agents/$AGENT_SLUG/run \
-H "Authorization: Bearer $API_KEY" \
-H "Content-Type: application/json" \
-d '{"input": {"topic": "Últimos papers de IA"}}'
La llamada devuelve 202 Accepted al instante — la ejecución es asincrónica:
{
"runId": "0fb7…",
"status": "pending",
"eventsUrl": "/api/events/runs/0fb7…",
"pollUrl": "/api/v1/runs/0fb7…"
}
Suscribite a eventsUrl para recibir el stream SSE en vivo, o consultá
pollUrl para el resultado final. Todos los detalles en
Ejecutar un agente por API.
Próximos pasos
- Conceptos — cómo se relacionan agentes, ejecuciones y créditos
- El canvas — el editor en profundidad
- Facturación — cuánto cuesta realmente una ejecución