运行时配置
运行时配置用于管理当前智能体执行任务时的基础运行参数、运行增强开关、报告模板、上下文压缩和工具结果压缩策略。
功能入口
自主规划式智能体->设置页,打开运行时配置页签。
基础运行
基础运行用于控制智能体单次任务的基本执行行为,以及与报告、地图等能力相关的运行时开关。
| 配置项 | 说明 |
|---|---|
| 对话语言 | 设置当前智能体运行时使用的对话语言,支持中文和英文。语言会影响智能体输出内容、运行时卡片和相关工作区模板的语言表现。 |
| 最大迭代次数 | 限制单次任务最多执行多少轮思考、工具调用和结果整理。达到上限后,智能体会停止继续迭代,适合用于控制复杂任务的执行时长和资源消耗。 |
| Shell 命令超时 | 限制单条 Shell 命令的最长等待时间,单位为秒。命令超过该时间仍未结束时,本次命令会被中止并返回失败。 |
| 允许自动接受规划 | 开启后,长规划模式下可自动接受并执行计划,无需用户手动确认。 |
| 地图可视化 | 开启后,当前智能体可在运行过程中使用地图可视化能力,支持基础地图、单值专题图、分段专题图、热力图、聚合图、统计图表、OD 图、3D 柱状图和 3D 热力图。使用 -1000 自定义坐标系的数据会按约定范围归一化为示意图展示,不表示真实地理位置。 |
| 报告生成 | 开启后,智能体完成任务时可自动生成业务分析报告。开启该开关后,页面会展开报告模板编辑区域。报告生成开启后,页面会显示报告模板区域。模板支持预览和编辑两种模式,可通过“重置”恢复内置模板,并通过“保存”写入当前智能体工作区。模板内容支持 Markdown 格式,并可使用 {{ current_time }} 和 {{ locale }} 变量注入当前时间和语言环境。 |
上下文压缩
上下文压缩用于控制长任务运行过程中对历史上下文的整理策略。开启后,系统会以模型管理中配置的最大上下文长度作为容量基准;当上下文达到设定比例时,系统会自动压缩较早内容,尽量保留当前任务继续执行所需的信息。
- 启用上下文压缩:开启后,运行时会在上下文接近上限时自动执行压缩。
- 压缩阈值比例:达到模型上下文容量的指定比例时触发压缩,取值范围为 0.1 至 0.9。例如 0.8 表示上下文使用到约 80% 时开始压缩。
- 保留阈值比例:压缩后为后续对话和工具结果预留的上下文比例,取值范围为 0 至 0.3。值越大,后续任务继续运行的余量越多。
- 压缩时包含思考块:开启后,压缩摘要会参考智能体思考过程;关闭后,仅压缩对话、工具和结果内容。
工具结果压缩
工具结果压缩用于控制工具调用结果在上下文中的保留和裁剪策略,避免长输出持续占用上下文,影响后续推理和对话。
- 启用工具结果压缩:开启后,运行时会对历史工具结果进行裁剪或压缩。
- 最新工具结果保留范围:设置最近多少条工具结果保持原样,取值范围为 1 至 10,便于当前步骤继续引用完整输出。
- 工具调用文件保留天数:工具结果被转存为文件后的保留天数,取值范围为 1 至 10。过期文件可由运行环境清理。
- 早期消息压缩阈值:超过该字节数的早期工具结果会被压缩。值越小,历史结果越容易被裁剪。
- 最新消息压缩阈值:超过该字节数的最新工具结果也会被压缩,用于限制超大工具输出。
使用建议
- 处理长规划、数据分析或报告生成任务时,可适当提高最大迭代次数;若希望严格控制执行时间和成本,则应设置较小的迭代上限。
- Shell 命令超时不宜设置过长,避免异常命令长时间占用执行资源;涉及大文件处理或外部服务调用时,可按任务需要适当放宽。
- 长会话、长规划任务和大量工具调用场景建议在模型管理中确认最大上下文长度,并开启上下文压缩和工具结果压缩,以减少上下文溢出风险。
- 启用自动接受规划前,应确认当前智能体任务范围、工具权限和安全策略已经配置妥当,避免长规划任务在无人确认的情况下执行高风险步骤。
- 运行时配置按当前智能体隔离保存。切换智能体后,请重新检查页面展示的配置是否符合该智能体的业务场景。