Quickstart
Tres pasos para tu primera agent run. Enviarás un task y leerás el resultado en streaming — la plataforma se encarga de todo lo demás.
1. Obtén una API key
En la app, abre Settings → API keys y crea una clave. Las claves están vinculadas al workspace (sk-ws-…). También puedes crear una por la API:
POST/v1/workspaces/{workspace_id}/api-keys — crea una nueva API key vinculada a este workspace.
export NEXEVO_API_KEY="sk-ws-..."
export NEXEVO_WORKSPACE="00000000-0000-0000-0000-000000000000"2. Envía un task
Eso es toda la integración. Un único campo — task. La plataforma elige el modelo, llama a las herramientas que la tarea necesite y transmite el resultado.
curl https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs \
-H "Authorization: Bearer $NEXEVO_API_KEY" \
-H "Content-Type: application/json" \
-d '{"task": "Find the 3 largest cross-border payment providers in SE Asia and summarize each in one line."}'
# -> {"run_id": "…", "trace_id": "…"}Devuelve {run_id, trace_id}. La run ya se está ejecutando — no necesitas mantener la conexión.
3. Lee el resultado
curl -N https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs/$RUN_ID/attach \
-H "Authorization: Bearer $NEXEVO_API_KEY"Cada línea data: es un evento — step_start, tool_call, tool_result, llm_delta (texto en streaming) y, por último, run_end (con final_text). El stream termina tras el frame terminal.
Eso es todo — has completado una integración completa. La plataforma gestionó automáticamente la selección del modelo, la búsqueda web y la síntesis del resultado. No configuraste nada más allá del propio task. Para más escenarios (OpenAI SDK, Q&A sobre knowledge base, informes programados), consulta el Cookbook.
Próximos pasos
Cómo funciona — entiende el auto-routing + las built-in tools
Agent runs — la superficie completa de la API
Cookbook — recetas para copiar y pegar