快速开始
三步完成你的第一次 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——可复制粘贴的配方