用途:该技能用于构建或重构 LangChain 应用逻辑,重点在于可预测的工具调用、结构化输出与清晰的运行时边界。适用于以链/智能体组合、工具调用、中间件、输出模式或提示词接线为主的任务。
主要能力与工作流:先确认语言与运行时(Python 或 TypeScript),识别现有包边界;在实现前锁定输入输出结构、工具 schema 与失败行为;按需选择抽象层级——无需工具时用简单 LCEL 链,需要迭代式工具调用时用 create_agent;以确定性顺序添加工具与中间件,并在加入重试或护栏前验证 schema 兼容性与工具副作用;强制结构化输出与状态规则,使用显式 schema 校验,避免临时解析;在发布前设置超时、重试与追踪钩子;用聚焦测试验证,对工具绑定做单元测试,对端到端智能体循环做集成测试。
默认模式:优先显式工具 schema 而非隐式参数解析;将工具副作用与提示词逻辑隔离;提示词模板与业务逻辑分离;在边界处校验所有结构化输出;重试保持有界且幂等。
适用场景与限制:当核心问题是图拓扑、节点路由、检查点、中断或多步状态机时,应改用 langgraph;核心问题是后端与 UI 间事件协议合规时改用 ag-ui;核心问题是前端协同智能体 UX、钩子与运行时提供方接线时改用 copilotkit。需注意的失败模式包括:提示词与实现间工具 schema 漂移、缺少停止条件导致智能体循环无界、输出契约薄弱导致静默解析失败、中间件顺序造成策略绕过、状态增长缺少裁剪或摘要规则。参考资料按需加载:核心工作流模式、工具与中间件、结构化输出与状态、调试与恢复。