📖 接口文档
端点
| 方法 / 路径 | 说明 | 鉴权 |
|---|
POST /api/graph/run | 运行图，返回执行报告 | 免登录（POST 放行） |
GET /api/graph/health | 健康检查，返回 {"status":"ok"} | 免登录 |
GET /health | 平台统一健康检查（graph-service 独立端口） | 免登录 |
请求体字段（顶层）
| 字段 | 类型 | 说明 |
|---|
graph | object | 图定义；也兼容直接用 nodes / state_graph 顶替 |
initial_state | object | 节点共享的初始状态 |
approver | string | auto / reject / http，默认 auto |
approver_url | string | approver=http 时的回调地址 |
approver_timeout | number | 审批回调超时秒数，默认 30 |
fail_fast | bool | 节点失败时是否立即中断，默认 true |
llm | object | 真实 LLM 配置（内联 LLM 节点用），如 {"provider":"openai","model":"gpt-4o","api_key":"..."} |
支持的节点类型（node_type）
Sequential 顺序执行工具/内联 agent
Conditional 按 condition 表达式决定是否执行（读 state）
Loop 循环直到 condition 成立或达 max_iterations
RequiresApproval 需审批；approver=reject 时返回 rejected
Verification 校验 verify_command（读 state），可配 fail_fast
节点通用字段
| 字段 | 说明 |
|---|
id | 节点唯一 ID |
node_type | 上列类型之一，默认 Sequential |
tool | {"tool_name":"...","arguments":{...}}，tool_name 为已注册工具（如 uppercase / echo / compute / rag_search / llm_summarize） |
reads / writes | 从/向共享状态读写的键 |
system_prompt / prompt_template | 内联 LLM 节点用，prompt_template 支持 {key} 取 state |
condition / max_iterations / approval_prompt / verify_command | 对应类型专用字段 |
响应结构（执行报告）
{
"graph_name": "demo",
"order": ["x"],
"levels": {...},
"results": {
"x": {
"status": "done", // done | rejected | error | skipped
"output": "...", // 节点输出
"error": null,
"iterations": 1,
"started_at": "...",
"ended_at": "..."
}
},
"final_state": {...},
"elapsed": 0.12,
"aborted": false,
"abort_reason": null
}