Evose

API · Agent

列表 · 调用对话 · 流式 · 历史

Agent API

调用 Agent 与管理对话。

列出 Agent

GET /v1/agents?workspace_id=ws-001
{
  "data": [
    {
      "id": "agent-12345",
      "name": "客服 Pro",
      "type": "chatflow",
      "model": "claude-sonnet-4-6",
      "workspace_id": "ws-001",
      "status": "active",
      "version": 7,
      "created_at": "..."
    }
  ]
}

调用对话(同步)

POST /v1/agents/{id}/chat
{
  "message": "我的订单 ABC12345 怎么样了?",
  "user_id": "u-internal-001",
  "conversation_id": "conv-xxx",
  "stream": false
}
字段说明
message用户消息(必填)
user_id最终用户 ID(必填,用于审计)
conversation_id选填,延续历史会话;不填则新建
stream选填,默认 false
inputs选填,Chatflow 开始节点参数

响应:

{
  "request_id": "req-xxx",
  "agent_id": "agent-12345",
  "conversation_id": "conv-xxx",
  "message": {
    "role": "assistant",
    "content": "您的订单 ABC12345 已发货,预计 5 月 10 日送达。"
  },
  "tool_calls": [
    {
      "tool": "订单系统.queryOrder",
      "input": { "orderId": "ABC12345" },
      "duration_ms": 234
    }
  ],
  "usage": {
    "tokens_in": 145,
    "tokens_out": 67,
    "credits": 0.008
  }
}

流式调用

POST /v1/agents/{id}/chat
Accept: text/event-stream
{ "message": "...", "user_id": "...", "stream": true }

事件流:

event: message
data: {"delta": "您的订单"}

event: message
data: {"delta": " ABC12345 已发货"}

event: tool_call
data: {"tool": "订单系统.queryOrder", "input": {...}}

event: tool_result
data: {"output": {...}, "duration_ms": 234}

event: usage
data: {"tokens_in": 145, "tokens_out": 67, "credits": 0.008}

event: done
data: {"finish_reason": "stop"}

列出对话

GET /v1/agents/{id}/conversations?user_id=u-001

获取对话历史

GET /v1/conversations/{conversation_id}

删除对话

DELETE /v1/conversations/{conversation_id}

接下来

页面导航