快速開始
三步完成你的第一次 agent 運行。你只需發送一個 task 並讀取串流結果——其餘一切都由平台處理。
1. 取得 API 金鑰
在應用中開啟 Settings → API keys 並建立一把金鑰。金鑰綁定到工作區(sk-ws-…)。也可以透過 API 建立:
POST/v1/workspaces/{workspace_id}/api-keys — 建立一把綁定到該工作區的新 API 金鑰。
bash
export NEXEVO_API_KEY="sk-ws-..."
export NEXEVO_WORKSPACE="00000000-0000-0000-0000-000000000000"2. 發送一個 task
這就是全部的接入工作。一個欄位——task。平台會自行挑選模型、呼叫任務所需的任何工具,並串流回傳結果。
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": "…"}回傳 {run_id, trace_id}。運行此刻已在執行——你無需保持連線。
3. 讀取結果
bash
curl -N https://nexevo.ai/v1/workspaces/$NEXEVO_WORKSPACE/agent/runs/$RUN_ID/attach \
-H "Authorization: Bearer $NEXEVO_API_KEY"每一行 data: 都是一個事件——step_start、tool_call、tool_result、llm_delta(串流文字),最後是 run_end(帶 final_text)。串流在終結幀之後結束。
就這樣——你已經完成了一次完整的接入。平台自動處理了模型選擇、網路搜尋和結果綜合。除了 task 本身,你什麼都沒有設定。更多情境(OpenAI SDK、知識庫問答、定時報告),見 Cookbook。
下一步
運作原理——理解自動路由 + 內建工具
Agent runs——完整的 API 能力面
Cookbook——可複製貼上的配方