Files
Agent-Workbench/docs/CONTEXT-PLANS.md
T

34 lines
4.0 KiB
Markdown

# 有界模型请求计划
1.5.0实现目标:长Task通过同一目标、追加要求、已保存结果和工件继续工程任务。完整providerMessages保持不变,请求只选择完整协议组;不改写工具参数、不截断工具结果或把省略记录表示成一次成功执行。
## 请求与预算
每次Chat Completions请求先构造完整JSON正文,包含model、系统/项目/Task状态、所选历史、工具定义、tool_choice、max_tokens和stream。UTF-8字节数、正文SHA256和估算方法随Step/Run持久保存;Authorization不属于正文,也不进入计划工件。
输入估算采用UTF-8字节数除以3,外加消息/工具协议余量;这是兼容服务没有公开分词器时的本地估算,不保证等于服务实际tokens。上下文窗口扣除配置的输出预留与安全余量,再与Run/Task剩余预算比较;工作上下文目标最多16000估算输入tokens。服务返回的实际用量另行记录,不能把字节减少直接换算成费用收益。
当前Task目标、全部追加要求/约束/验收要求、项目/会话身份和最后一条用户消息必须完整保留。如果这些必需内容已不能容纳,暂停并明确context_limit或对应累计预算;不截掉用户要求,也不自动新建任务。可保留最新完整工具组到硬预算,以免因工作目标较小就省略正在处理的结果。
## 完整工具组与封存
一个assistant的全部tool_calls及对应tool结果是不可分割组,按原顺序、原字节字符串选择。孤立/重复/缺少结果的协议在联网前拒绝;已知中断由既有恢复账本核对,不假造结果。过大的整组只能整体封存,模型通过实际工件分段读取。
省略组写入SHA256工件;超过单工件上限时按合法Unicode边界分片,清单保存原组SHA256、分片顺序及完整范围。每次请求的历史索引保存所有省略组身份、工具调用/结果引用与所选范围,正文只携带有界索引和最近省略组的精确状态/身份。模型可用read_artifact读取原结果或完整消息组,不重新执行旧工具。
工件先fsync、SQLite归属和request-plan记录保存成功,才发出模型请求。重启只将未完成计划标成interrupted,不发送请求、不重放工具。重用封存工件必须通过SHA256和归属核对;缺失或损坏时停止该投影,保留原记录。
## 验收
覆盖单user回合的长Task、近期大小混合结果、Unicode、完整多工具配对、原参数和历史不变、目标和追加要求完整、固定开销/输出余量/Run和Task剩余预算、工件缺失/外部篡改、显式续接及实际进程重启。API/桌面/390px应能读取请求估算与实际用量、历史索引和工件;真实同题样本单独报告用量和人工介入。
本文件描述当前开发契约;实际完成/部署以VALIDATION.md为准。
## 1.5.1:读取预算与重复进展
1.5.0真实样本暴露较大工件页被整体封存的循环,失败记录保留。1.5.1的read_artifact按下一请求中工具消息的双层JSON字节预算生成实际读取页;默认2000字符,requested_limit与实际范围分别返回,next_offset指向下一段。UTF-16坐标按合法Unicode边界处理;分页不改写历史工具参数,原工件与SHA256保持。
请求计划优先选择近期直接代码/原结果组,并提供有界working_evidence定位。目标、追加要求和完整协议仍按原契约保留;不能容纳的原大结果仍整体封存,不宣称所有任意大小工具组都能进入模型窗口。
Task保存有界工件覆盖区间、重复次数和最近读取身份。连续3次读取已完整覆盖区间或连续追逐6个更新历史索引时,以no_progress暂停,所有已执行结果先保存并完成工具配对。读取新区间或取得直接证据会结束重复序列;显式续接清除暂停序列,保留已读证据与同Task身份。此检测针对工件读取,尚不是通用任务调度/语义无进展判断。