Contratando socios de diseño para nuevos sectores — abre un nuevo sector y obtén la plataforma a mitad de precio

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.

bash
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.

bash
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

bash
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