智能体集成是多种不同能力的组合，旨在使构建长期运行的智能体变得更容易 除了这些能力，深度智能体还使用技能和记忆来获取额外的上下文和指令。文档索引
在以下地址获取完整的文档索引：https://docs.langchain.org.cn/llms.txt
在进一步探索之前，请使用此文件发现所有可用页面。
规划能力
该集成提供了一个 `write_todos` 工具，智能体可以使用它来维护结构化的任务列表。 功能：- 跟踪具有状态（`'pending'`、`'in_progress'`、`'completed'`）的多个任务
- 持久化在智能体状态中
- 帮助智能体组织复杂的複数步工作
- 适用于长期运行的任务和规划
虚拟文件系统访问
该集成提供了一个可配置的虚拟文件系统，它可以由不同的可插拔后端支持。这些后端支持以下文件系统操作：| 工具 | 描述 |
|---|---|
ls | 列出目录中的文件及其元数据（大小、修改时间） |
read_file | 读取带行号的文件内容，支持大型文件的偏移量/限制。还支持返回非文本文件（图像、视频、音频和文档）的多模态内容块。请参阅下面支持的扩展名。 |
write_file | 创建新文件 |
edit_file | 在文件中执行精确字符串替换（带全局替换模式） |
glob | 查找匹配模式的文件（例如，`**/*.py`） |
grep | 以多种输出模式搜索文件内容（仅文件、带上下文的内容或计数） |
execute | 在环境中运行 shell 命令（仅适用于沙盒后端） |
支持的多模态文件扩展名
支持的多模态文件扩展名
文件系统权限
该集成支持声明式权限规则，用于控制智能体可以读取或写入哪些文件和目录。权限适用于上述内置文件系统工具，并按照声明顺序进行评估，遵循首次匹配胜出原则。 工作原理：- 在创建智能体时，将规则列表传递给 `permissions=` 参数
- 每条规则指定 `operations`（`"read"`、`"write"`）、`paths`（glob 模式）和 `mode`（`"allow"` 或 `"deny"`）
- 第一条匹配的规则胜出。如果没有规则匹配，则允许该操作。
- 将智能体限制在特定目录（例如，`/workspace/`）
- 保护敏感文件（例如，`.env`、凭据）
- 赋予子智能体比父智能体更窄的访问权限
任务委托（子智能体）
该集成允许主智能体创建临时的“子智能体”以执行独立的複数步任务。 为什么它有用：- 上下文隔离 - 子智能体的工作不会干扰主智能体的上下文
- 并行执行 - 多个子智能体可以并行运行
- 专业化 - 子智能体可以拥有不同的工具/配置
- Token 效率 - 大型子任务上下文被压缩成单个结果
- 主智能体拥有 `task` 工具
- 调用时，它会创建一个具有自己上下文的全新智能体实例
- 子智能体自主执行直到完成
- 向主智能体返回单个最终报告
- 子智能体是无状态的（不能发送多条消息）
- “通用”子智能体自动可用
- 默认拥有文件系统工具
- 可以通过附加工具/中间件进行自定义
- 定义具有特定工具的专业子智能体
- 示例：代码审查员、网络研究员、测试运行器
- 通过 `subagents` 参数进行配置
在没有子智能体的情况下运行（无 `task` 工具）
在没有子智能体的情况下运行（无 `task` 工具）
要在没有 `task` 工具的情况下运行智能体，请参阅在没有子智能体的情况下运行。请勿尝试通过 `excluded_middleware` 移除 `SubAgentMiddleware`——这是故意拒绝的。相反，请通过集成配置文件禁用自动添加的子智能体，并且不要通过 `subagents=` 传递任何同步子智能体。异步子智能体不受影响。
上下文管理
该集成管理上下文，因此深度智能体可以在 token 限制内处理长期运行的任务，同时保留所需的信息。 工作原理：- 输入上下文 — 系统提示、记忆、技能和工具提示共同塑造智能体启动时所了解的信息
- 压缩 — 内置的卸载和摘要功能在任务进行过程中将上下文保持在窗口限制内
- 隔离 — 子智能体隔离繁重的工作并仅返回结果（请参阅任务委托）
- 长期记忆 — 通过虚拟文件系统实现跨线程的持久存储
- 支持超出单个上下文窗口的複数步任务
- 无需手动裁剪即可将最相关的信息保持在范围内
- 通过自动摘要和卸载减少 token 使用
代码执行
当您使用沙盒后端时，该集成会暴露一个 `execute` 工具，允许智能体在隔离环境中运行 shell 命令。这使得智能体能够安装依赖项、运行脚本并执行代码作为其任务的一部分。 工作原理：- 沙盒后端实现了 `SandboxBackendProtocolV2` — 当检测到时，该集成会将 `execute` 工具添加到智能体的可用工具中
- 如果没有沙盒后端，智能体将只拥有文件系统工具（`read_file`、`write_file` 等），无法运行命令
- `execute` 工具返回合并的 stdout/stderr、退出码，并截断大型输出（保存到文件以便智能体增量读取）
- 安全性 — 代码在隔离环境中运行，保护您的主机系统免受智能体操作的影响
- 干净环境 — 无需本地设置即可使用特定依赖项或操作系统配置
- 可复现性 — 跨团队的一致执行环境
人工干预
该集成可以在指定的工具调用处暂停智能体执行，以允许人工批准或修改。此功能通过 `interrupt_on` 参数进行选择性启用。 配置：- 将 `interrupt_on` 传递给 `create_deep_agent`，其中包含工具名称到中断配置的映射
- 示例：`interrupt_on={"edit_file": True}` 会在每次编辑前暂停
- 在提示时，您可以提供批准消息或修改工具输入
- 破坏性操作的安全门
- 在昂贵的 API 调用前进行用户验证
- 交互式调试和指导
技能
该集成支持为您的深度智能体提供专业工作流和领域知识的技能。 工作原理：- 技能遵循智能体技能标准
- 每个技能是一个包含 `SKILL.md` 文件的目录，其中包含说明和元数据
- 技能可以包含附加脚本、参考文档、模板和其他资源
- 技能采用渐进式披露——它们只在智能体判断其对当前任务有用时才加载
- 智能体在启动时读取每个 `SKILL.md` 文件的前言，然后在需要时查阅完整的技能内容
- 仅在需要时加载相关技能，从而减少 token 使用
- 将能力与附加上下文捆绑成更大的操作
- 提供专业知识，而不会使系统提示混乱
- 实现模块化、可重用的智能体能力
内存
该集成支持持久记忆文件，这些文件可在不同对话中为您的深度智能体提供额外上下文。这些文件通常包含通用编码风格、偏好、约定和指南，帮助智能体理解如何与您的代码库协作并遵循您的偏好。 工作原理：- 使用`AGENTS.md` 文件提供持久上下文
- 记忆文件总是加载的（与使用渐进式披露的技能不同）
- 在创建智能体时，将一个或多个文件路径传递给 `memory` 参数
- 文件存储在智能体的后端（StateBackend、StoreBackend 或 FilesystemBackend）
- 智能体可以根据您的交互、反馈和识别的模式更新记忆
- 提供持久上下文，无需在每次对话中重新指定
- 适用于存储用户偏好、项目指南或领域知识
- 始终可供智能体使用，确保行为一致
能力框架配置文件
每当选择给定提供商或模型时，该集成都可以应用声明式配置包（`HarnessProfile`）。配置文件在模型构建后调整运行时行为，无需每个智能体的设置代码。 工作原理：- 在提供商名称（`"openai"`）或 `provider:model` 键（`"openai:gpt-5.4"`）下注册配置文件
- `create_deep_agent` 在解析模型时查找并应用配置文件
- 提供商级别和模型级别的配置文件在解析时合并
- 将每个提供商或每个模型的默认设置（系统提示调整、工具覆盖、中间件）打包在一个地方
- 切换模型时保持 `create_deep_agent` 调用位置不变
- 通过入口点以插件形式分发可重用配置文件
将这些文档连接到 Claude、VSCode 等，以获得实时答案。