Quickstart

Três passos para sua primeira agent run. Você vai enviar um task e ler o resultado em streaming — a plataforma cuida de todo o resto.

1. Obtenha uma API key

No app, abra Settings → API keys e crie uma chave. As chaves são vinculadas ao workspace (sk-ws-…). Você também pode criar uma pela API:

POST/v1/workspaces/{workspace_id}/api-keys —

cria uma nova API key vinculada a este workspace.

bash

export NEXEVO_API_KEY="sk-ws-..."
export NEXEVO_WORKSPACE="00000000-0000-0000-0000-000000000000"

2. Envie um task

Essa é a integração inteira. Um único campo — task. A plataforma escolhe o modelo, chama as ferramentas que a tarefa precisar e transmite o 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": "…"}

Retorna {run_id, trace_id}. A run já está em execução — você não precisa manter a conexão.

3. Leia o resultado

bash

curl -N https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs/$RUN_ID/attach \
  -H "Authorization: Bearer $NEXEVO_API_KEY"

Cada linha data: é um evento — step_start, tool_call, tool_result, llm_delta (texto em streaming) e, por fim, run_end (com final_text). O stream termina após o frame terminal.

É isso — você concluiu uma integração completa. A plataforma tratou automaticamente a seleção do modelo, a busca na web e a síntese do resultado. Você não configurou nada além do próprio task. Para mais cenários (OpenAI SDK, Q&A em knowledge base, relatórios agendados), veja o Cookbook.

Próximos passos

Como funciona — entenda auto-routing + built-in tools
Agent runs — a superfície completa da API
Cookbook — receitas para copiar e colar