ambleloft授权轮次读取 API
按 conversationId、turnId、version 读取项目授权范围内的冻结轮次文本。
API 参考
按章节查看契约、签名、字段与示例；未注明的默认值不作推断。
本页内容
01引用与返回值
预览能力 · SDK 0.1.0-alpha.9
通过 getAutomation(context).conversations 或 context.conversations 调用。需要 project scope 的 conversations.read。
代码示例
interface TurnReference { conversationId: string; turnId: string; version: number }
interface TurnSnapshot extends TurnReference {
projectId: string; status: string;
messages: { id: string; role: string; text: string }[];
}
conversations.getTurn(reference: TurnReference): Promise<TurnSnapshot>;02版本与授权
使用完成事件中的原始引用。首版 version 1 是不可变终态；读取失败不能回退到最新内容。项目迁移、删除会话、指定版本不存在或授权撤销均需处理明确错误。
03数据范围
返回消息 id、role、text，不返回附件二进制、工具参数、模型密钥或独立项目路径字段；正文中出现的路径仍属于文本。没有历史轮次列表、实时流或任意版本编辑。快照保留 7 天，不能作为永久历史存储。 getTurn 在读取时检查快照 JSON 的 256 KiB 门禁；后台作业另有聚合冻结文本 48,000 字节限制。