Python SDK 奇偶校验: 显示用户消息归因和已排队转接字段
TypeScript Agent SDK 会暴露一些字段,允许主机将提交的用户消息与 SDK 的回转/结果进行关联: - user_message_uuid - user_message_uuids - queued_turn_count 相关的 TypeScript 版本: - v0.3.216: 向成功的结果中添加了 user_message_uuid。 - v0.3.243: 向结果中添加了 queued_turn_count。 - v0.3.246: 向错误结果和第一个回复帧中添加了 user_message_uuid。 - v0.3.259: 向包含每个由合并回转所回答的提交消息的 user_message_uuids 中添加了这些字段。 Python SDK 目前没有在其消息数据类中暴露这些字段,也没有在 _internal/message_parser.py 中保留它们,尽管其捆绑的 Claude CLI 与 TypeScript 版本中使用的 CLI 版本处于同一水平。 请求的同步性: 1. 在等效的 Python 首次回复和结果消息类型上暴露 user_message_uuid 和 user_message_uuids。 2. 在 ResultMessage 上暴露 queued_turn_count。 3. 在 message_parser.py 中保留这些字段。 4. 确保/文档说明结构化的 Python 用户消息输入可以携带来自调用方的 uuid,与 TypeScript SDK 一致。 5. 保持所有新字段为可选,以兼容较旧的 CLI 版本。 这对于在一个回转运行期间提交多个消息时很有用。 Claude 代码可以将这些输入合并为一个回转并发出一个 ResultMessage; user_message_uuids 允许主机确定该结果所回答的哪些输入。 queued_turn_count 向主机表明是否预期还有其他已排队的回转/结果。 此请求仅用于与 TypeScript SDK 中已有的行为保持一致。
内容来源: anthropics/claude-agent-sdk-python