Quickstart
Tiga langkah ke agent run pertama anda. Anda akan menghantar satu task dan membaca hasil yang menstrim — platform mengendalikan segala-galanya yang lain.
1. Dapatkan API key
Dalam aplikasi, buka Settings → API keys dan cipta satu kunci. Kunci terikat-workspace (sk-ws-…). Anda juga boleh mencipta satu melalui API:
POST/v1/workspaces/{workspace_id}/api-keys — cipta API key baharu yang terikat dengan workspace ini.
export NEXEVO_API_KEY="sk-ws-..."
export NEXEVO_WORKSPACE="00000000-0000-0000-0000-000000000000"2. Hantar satu task
Itulah keseluruhan integrasi. Satu medan — task. Platform memilih model, memanggil apa jua alat yang diperlukan tugasan, dan menstrimkan hasil.
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": "…"}Memulangkan {run_id, trace_id}. Run kini sedang dilaksanakan — anda tidak perlu kekal bersambung.
3. Baca hasilnya
curl -N https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs/$RUN_ID/attach \
-H "Authorization: Bearer $NEXEVO_API_KEY"Setiap baris data: ialah satu acara — step_start, tool_call, tool_result, llm_delta (teks yang menstrim), dan akhirnya run_end (mengandungi final_text). Strim berakhir selepas bingkai terminal.
Itu sahaja — anda telah melengkapkan integrasi penuh. Platform mengendalikan pemilihan model, gelintar web, dan sintesis hasil secara automatik. Anda tidak mengkonfigurasi apa-apa selain task itu sendiri. Untuk lebih senario (OpenAI SDK, Q&A pangkalan pengetahuan, laporan berjadual), lihat Cookbook.
Langkah seterusnya
Cara ia berfungsi — fahami auto-routing + built-in tools
Agent runs — permukaan API yang penuh
Cookbook — resipi salin-tampal