实用提示：您的AI智能体在第12步遇到障碍。LangChain的深度智能体

本指南将逐步构建从原材料到可运行系统的完整流程，适用于“你的AI智能体在第12步遇到瓶颈”以及“LangChain的深度智能体解析原因”这两种场景。重点在于可操作的步骤、明确的检查点，以及无需猜测意图即可直接放入代码仓库的代码。 在概览阶段，应在修改代码之前明确输入参数、各步骤的负责人以及终止标准。操作人员应能够从已知的检查点重新运行相应步骤，而无需猜测隐藏状态。 可将此阶段视为输入与经过验证的输出之间的契约。为相关成果命名，定义成功标准，杜绝无声的半完成状态。

浅层智能体问题

在处理“浅层智能体问题”阶段时，首先写下相关契约：所需的输入参数、成功信号以及部分失败时的处理方式。这样的清单能确保后续的代码修改保持一致性。 在功能结果旁记录执行时间以及令牌或查询成本。提前明确成本信息，可避免在从演示环境过渡到共享环境时出现意外费用。 在耗时较高的步骤之后设置检查点。当操作员重新尝试后续节点时，恢复流程不应再次收取相同的LLM调用费用。

简明的四大支柱

在处理“四个核心阶段”时，首先写下相关契约：所需的输入参数、成功标志，以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改保持一致性。 将配置信息与应用程序代码分开存放。环境文件、密钥存储以及功能开关应集中于一个位置，这样操作人员无需查看整个系统结构即可进行审计。 在耗时较高的步骤之后设置检查点。当操作人员重新执行后续节点时，恢复流程不应再次调用相同的大型语言模型。

核心原则1：将计划写在模型能够看到的地方

在处理第一支柱的“编写阶段”时，首先要明确契约内容：所需的输入参数、成功信号以及部分失败时的处理方式。这份清单能确保后续的代码修改保持一致性。 同时记录正常流程和异常恢复路径。重试机制、人工审核环节以及死信处理都是产品功能的一部分，而非后续需要补充的内容。 缓存系统中稳定的指令和工具结构。重复发送相同的报文是导致资源浪费的常见原因。 在处理第一支柱的“编写阶段”时，首先要明确契约内容：所需的输入参数、成功信号以及部分失败时的处理方式。这份清单能确保后续的代码修改保持一致性。 将这一阶段视为输入与验证后输出之间的契约。为相关产物命名，定义成功判定标准，杜绝无声的半完成状态。

第二支柱：代理程序可用作内存的文件系统

将第二支柱的文件系统阶段视为可度量的对象来使用效果最佳。在扩大范围之前，先记录一份理想的运行日志、一个故障案例以及回滚说明。在功能结果旁同时记录执行时间以及令牌或查询成本。提前了解成本情况，就能避免在从演示环境过渡到共享环境时出现意外费用。要保持图结构的状态简洁且具有类型约束，否则嵌套的数据块会掩盖哪个节点修改了哪个字段的信息，且在中断后还会导致流程无法继续。

第三支柱：用于上下文隔离的子代理

在阶段性工作中，将第三支柱的子代理视为可度量的对象使用效果最佳。在扩大范围之前，先记录一份成功的案例、一个失败案例以及回滚说明。 将配置置于应用程序代码之外。环境文件、密钥存储和功能标志应集中存放于一个位置，这样操作人员无需查看整个结构即可进行审计。 保持图结构的扁平化与类型化。嵌套的数据块会掩盖哪个节点修改了哪个字段的信息，且在中断后会导致无法继续处理。

第四支柱：代理按需加载的技能

Pillar 4 Skills阶段在被视为可度量的对象时表现最佳。在扩大范围之前，需记录一份理想状态下的流程记录、一个故障案例以及回滚说明。 同时记录正常流程与恢复流程。重试机制、人工审核环节以及错误处理都是产品本身的组成部分，而非后续需要补充的内容。 保持图表状态简洁且具有类型定义。嵌套的数据结构会掩盖哪个节点修改了哪个字段的信息，还会在流程中断后导致无法继续执行。 Pillar 4 Skills阶段在被视为可度量的对象时表现最佳。在扩大范围之前，需记录一份理想状态下的流程记录、一个故障案例以及回滚说明。 应将此阶段视为输入与经过验证的输出之间的契约。为相关工件命名，明确成功标准，绝不允许出现无声无息的半完成状态。

- research: Conducts multi-source web research with citation
- writer: Drafts long-form content matching house style
- sql_query: Runs read-only queries against the analytics warehouse

这四个核心原则其实都是同一套方法的重复应用

这四个核心要素是在修改代码之前确定阶段、输入内容、该步骤的负责人以及退出标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。应在功能结果旁记录执行时间以及令牌或查询成本。提前了解成本情况，可避免在从演示环境过渡到共享环境时出现意外费用。对于会耗费资金或修改生产数据的操作，必须经过人工审批。仅靠编译时的配置并不足以确保业务的完整性。

如何实际尝试

在“如何实际尝试”阶段，应在修改代码之前明确输入参数、该步骤的负责人以及终止标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 配置信息应置于应用程序代码之外。环境文件、密钥存储以及功能标志应集中存放于一个位置，以便操作人员无需查看整个流程即可进行审核。 对于涉及资金支出或修改生产数据的节点，需设置人工审批环节。编译时的连接方式并不等同于业务流程的完整性。

pip install deepagents

import os
from pathlib import Path
from deepagents import create_deep_agent
from deepagents.backends import FilesystemBackend
from tavily import TavilyClient

tavily = TavilyClient(api_key=os.environ["TAVILY_API_KEY"])def web_search(query: str, max_results: int = 5):
    return tavily.search(query, max_results=max_results)workspace = Path("./workspace").resolve()  # root_dir must be absolute
workspace.mkdir(exist_ok=True)agent = create_deep_agent(
    model="anthropic:claude-3-5-sonnet-latest",
    system_prompt="You are a senior analyst. Use web search to find sources, save the raw results to disk, then synthesize.",
    tools=[web_search],
    backend=FilesystemBackend(root_dir=str(workspace), virtual_mode=True),
)result = agent.invoke({"messages": [{"role": "user", "content": "Brief me on the current state of LLM agent frameworks"}]})print(result["messages"][-1].content)

接下来需要添加什么

在“需要添加什么”的第二阶段中，应在修改代码之前明确输入参数、该步骤的负责人以及终止标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 需同时记录正常流程和异常恢复流程。重试机制、人工审核环节以及错误处理都是产品不可或缺的部分，而非后续才需要完善的内容。 对于任何会耗费资金或修改生产数据的操作，都必须经过人工审批。仅靠编译时的配置并不足以保证业务的完整性。 在“需要添加什么”的第二阶段中，应在修改代码之前明确输入参数、该步骤的负责人以及终止标准。操作人员应能够从已知的检查点重新运行该步骤，而无需猜测隐藏状态。 应将这一阶段视为输入与经过验证的输出之间的契约。为相关成果命名，明确成功判定标准，绝不允许出现无声无息的半完成状态。

为何 Deep Agents 不是合适工具

在处理“Where Deep Agents 是”阶段时，首先需写下相关契约：所需输入、成功标志以及部分失败时的处理方式。这样的清单能确保后续的代码修改保持一致性。 在功能结果旁记录执行时间以及令牌或查询成本。提前了解成本情况，可避免从演示环境过渡到共享环境时出现意外费用。 为每次调用记录工具名称、参数哈希值、延迟时间以及最终结果。没有这些记录，调试智能体循环将会耗费大量时间。

即便从不使用该库也能用到的要点

在处理“可分阶段执行的任务”时，首先应写下相关契约：所需的输入参数、成功标志以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改保持一致性。 配置信息应与应用程序代码分开存放。环境文件、密钥存储以及功能开关都应集中管理，这样操作人员无需查看整个系统结构即可进行审计。 在成本较高的步骤之后设置检查点。当操作人员重新尝试后续节点时，恢复流程不应再次调用相同的大型语言模型。

操作检查清单

若将操作检查清单视为可度量的指标，其效果会更好。在扩大范围之前，先记录一份标准操作示例、一个失败案例以及回滚说明。 相比复杂的脚本，更应采用小型且可测试的单元。当某个步骤失败时，故障原因应能明确指向某个具体功能模块，而非整个复杂的流程。

保持图结构的状态扁平且具有类型约束。嵌套的数据块会隐藏是哪个节点修改了哪个字段，还会在中断后导致流程无法继续。

只要预算允许，就在持续集成过程中使用测试用例而非真实的付费 API 来执行关键路径的冒烟测试。

将此阶段视为输入与经过验证的输出之间的契约。为相关产物命名，明确成功标准，绝不允许出现无声的半完成状态。

保持图结构的状态扁平且具有类型约束。嵌套的数据块会隐藏是哪个节点修改了哪个字段，还会在中断后导致流程无法继续。

在升级技术栈之前，先冻结版本，为关键路径生成标准化的操作记录，并确认回滚步骤。共享环境需要设置速率限制、进行租户身份验证，同时要明确负责密钥轮换的人员。与其追求华丽的临时演示，不如注重扎实的可靠性。

关于8916e9958e68的批量处理说明：不要将提供者密钥放入代码仓库，为每个会话设置令牌使用上限，并将转录内容存储在评估测试文件旁，以便后续更换模型时仍能保持可比性。

在处理强化安全措施的第0阶段时，首先明确需求规范：所需输入、成功信号以及部分失败时的处理方式。这样的检查清单能确保后续的代码修改始终符合要求。优先选择小型、可测试的单元，而非冗长的脚本；当某个步骤失败时，故障应能指向单一责任点，而非复杂的流程问题。

强化安全措施细节0/751：需记录该步骤的运行时间、错误类型以及令牌消耗情况，然后根据固定的评估标准而非主观判断来决定是否保留该更改。