环境上下文感知
Environment Context Awareness
自动检测运行环境信息并注入 Agent 系统提示
子问题
1.运行环境自动检测脚本
2.上下文注入系统提示
3.摘要后自动刷新
4.跨后端兼容执行
5.检测脚本的可组合与可测试性设计
6.防重试循环的失败状态记录
7.私有状态隔离防止子代理污染
各项目的解法1 solutions
Signals
横向对比
| 维度 | DeepAgents |
|---|---|
| 检测方式 | 9 段可组合 bash section 函数拼接为完整检测脚本 |
| 检测内容 | CWD/语言/monorepo/包管理器/运行时版本/git/测试命令/文件列表/tree/Makefile |
| 注入机制 | AgentMiddleware.wrap_model_call 拦截每次 LLM 调用追加到 system_prompt |
| 刷新策略 | 监听 SummarizationEvent.cutoff_index 变化触发重新检测 |
| 跨后端兼容 | runtime_checkable Protocol 抽象，本地 shell 和远程沙箱统一 execute() 接口 |
| 防御性设计 | command -v 检查工具存在性，失败静默跳过；刷新失败记录 cutoff 防重试循环 |
最佳实践
1.通过 backend.execute() 在目标环境内执行检测
2.摘要事件后自动刷新避免上下文过期
3.用 runtime_checkable Protocol 实现后端无关的检测执行
4.每个检测 section 独立为纯函数便于单元测试
5.刷新失败时记录 cutoff 而非清空已有上下文