Skip to content

v1.0.1

Choose a tag to compare

@sinabs sinabs released this 04 Nov 09:54
9af73c2

Yoke 1.0.1

流式接口改用 AG-UI 标准协议:SSE 只做传输,事件契约交给官方 agentscope-extensions-agui(只引库,不引 starter)。

不兼容变更

  • POST /api/chat/stream 的请求体改为标准 AG-UI RunAgentInput(threadId 即会话 ID,runId 必填),必须是 application/json;旧的 {"sessionId", "message"} 请求体和私有事件(textDelta、toolCall、toolResult、hint、done、error)已移除,没有并存。
  • 响应事件换成 AG-UI 事件:RUN_STARTED、TEXT_MESSAGE_*、TOOL_CALL_*、CUSTOM(token_usage、hint)、RUN_FINISHED 或 RUN_ERROR。没有 done 事件,完整回复由客户端拼接 TEXT_MESSAGE_CONTENT。
  • POST /api/chat 的 sessionId 改用与 threadId 相同的规则校验(字母、数字、_.-,1~64 位,不能全是点),如 user:42 这类值现在返回 400;空白仍视同未传。

新功能

  • AguiStreamCodec 解析并校验请求体,只采用最后一条 user 消息,丢弃客户端的 tools 等字段,适配器上设 AGENT_ONLY,客户端不能给 Agent 加工具或改写历史。
  • HintEventConverter 把框架提示转成 CUSTOM name=hint,用量走 CUSTOM name=token_usage。
  • 错误通过 RUN_ERROR 体现,HTTP 状态码仍是 200,Agent 创建失败时也会先补 RUN_STARTED。

其他

  • 版本号 1.0.0 → 1.0.1。
  • 删除 ChatEvent、EventCodec;ArchUnit 规则放行 codec 与 config 中的 AG-UI 类型。