Deep Agents 源码拆解:create_agent、create_deep_agent 这几个核心函数到底怎么用,TaoToken 配置骨架一并给出

发布时间:2026/11/18 23:34:02

Deep Agents 源码拆解:create_agent、create_deep_agent 这几个核心函数到底怎么用,TaoToken 配置骨架一并给出 1. 从一次“工具明明注册了却调不到”说起如果你正在用 Deep Agents 搭一个能自己拆任务、调工具、写文件的智能体大概率会在某个时刻卡在同一个地方create_agent和create_deep_agent这两个函数名字太像参数表又都挺长复制示例跑起来之后工具到底有没有被真正注入、子代理有没有被触发心里没底。更麻烦的是当你把MultiServerMCPClient.get_tools拉回来的工具列表直接塞进create_deep_agent有时候能跑有时候静默失败日志里只留下一句“no tool calls”排查起来非常费劲。这篇就按源码调用链把这几件事串起来MultiServerMCPClient.get_tools负责把外部 MCP 服务器的工具“借”进来create_agent是轻量构造器create_deep_agent是带规划、文件系统、子代理的重型构造器。三者不是替代关系而是流水线上的不同工位。同时我会给出一套可以直接复制的config.toml/settings.json骨架以及用 TaoToken 统一 Key 接入的步骤最后给一个验证函数调用是否真正生效的检查动作。适合已经能跑通基础 Agent、但想搞清楚参数差异和 MCP 注入细节的开发者。2. TaoToken 前置把模型入口统一成一个 Key在拆函数之前先把模型入口固定下来。Deep Agents 本身不绑定某一家模型但你在create_deep_agent里写modelclaude-sonnet-4-5-20250929或者modelopenai:gpt-4o的时候底层还是要走一个兼容 OpenAI 协议的端点。TaoToken 在这里的角色就是统一入口一个 Key、一个 Base URL模型名按需切换省得在多个平台之间来回改环境变量。接入动作分三步。第一步去控制台创建一个 API Key地址是https://taotoken.net/api-keys注意这个 deep link 已经带了utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite打开就是 Key 管理页。第二步把 Key 写进环境变量不要硬编码在代码里。第三步把 Base URL 指向https://taotoken.net/api这个地址不加 UTM直接作为base_url使用。export TAOTOKEN_API_KEYsk-你的key export OPENAI_BASE_URLhttps://taotoken.net/api export OPENAI_API_KEY$TAOTOKEN_API_KEY这样设置之后LangChain 的ChatOpenAI和 Deep Agents 内部走的 OpenAI 兼容客户端都会自动读取这两个变量。如果你用的是 Claude 系列模型同样通过这个端点转发模型名写对即可。需要确认模型列表或者临时对话测试可以打开模型对话页https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite先手动发一条消息确认 Key 有效再回到代码里跑 Agent。注意环境变量名用OPENAI_API_KEY是为了兼容 LangChain 默认读取逻辑实际值填 TaoToken 的 Key。不要同时保留其他平台的同名变量否则会互相覆盖。3. 可复制配置config.toml 与 settings.json 骨架Deep Agents 项目里通常会有两层配置一层是项目级的config.toml用来声明 MCP 服务器和默认模型另一层是编辑器或运行时的settings.json用来固定环境变量和启动参数。下面这两份骨架可以直接改路径使用。config.toml负责描述 MCP 服务器连接方式。stdio适合本地起的 Python 脚本服务streamable_http或sse适合远程服务。注意command和args要写绝对路径相对路径在不同工作目录下会找不到文件。[model] default claude-sonnet-4-5-20250929 base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY [mcp.servers.math] transport stdio command python args [/abs/path/to/math_server.py] [mcp.servers.search] transport streamable_http url http://localhost:8000/mcp [agent] system_prompt 你是项目经理把复杂任务拆给子代理执行 max_iterations 25settings.json负责把环境变量和运行参数固定下来避免每次开终端都要重新 export。如果你用 VS Code 或类似编辑器可以放在.vscode/settings.json如果是独立运行时放在项目根目录由启动脚本读取。{ env: { TAOTOKEN_API_KEY: sk-你的key, OPENAI_BASE_URL: https://taotoken.net/api, OPENAI_API_KEY: ${TAOTOKEN_API_KEY} }, deepagents: { checkpoint_backend: memory, interrupt_on: { delete_file: { allowed_decisions: [approve, reject] } } } }这两份配置合起来解决一个问题模型入口、MCP 服务器、中断审批策略都不散落在代码里。后面无论你调create_agent还是create_deep_agent都从配置读取改一处即可全局生效。4. 调用链拆解get_tools、create_agent、create_deep_agent 的参数差异4.1 MultiServerMCPClient.get_tools 返回的到底是什么MultiServerMCPClient初始化时接收一个字典key 是服务器别名value 是连接参数。调用get_tools()之后返回的是一个BaseTool列表LangChain 和 Deep Agents 都能直接消费。关键点在于这个列表是异步拉取的如果你在同步函数里直接调用会报错必须放在async def里await。import asyncio from langchain_mcp_adapters.client import MultiServerMCPClient async def load_tools(): client MultiServerMCPClient({ math: { command: python, args: [/abs/path/to/math_server.py], transport: stdio, }, search: { url: http://localhost:8000/mcp, transport: streamable_http, }, }) all_tools await client.get_tools() print([t.name for t in all_tools]) return all_tools tools asyncio.run(load_tools())如果你只想拿某个服务器的工具传server_namemath即可。性能敏感场景可以用client.session(math)手动管理会话生命周期避免每次调用重建连接。这一步的输出是后续两个构造函数的共同输入。4.2 create_agent 的参数面create_agent是轻量构造器核心参数就三个llm、tools、prompt。它适合任务边界清晰、工具调用轮次少的场景。所有工具调用的中间结果都会堆进上下文任务一长 token 消耗会明显上升。from langchain.agents import create_react_agent, AgentExecutor from langchain_openai import ChatOpenAI model ChatOpenAI(modelclaude-sonnet-4-5-20250929) agent create_react_agent(llmmodel, toolstools, promptprompt) executor AgentExecutor(agentagent, toolstools, verboseTrue) executor.invoke({input: 算一下 23 乘以 47})注意create_react_agent和create_openai_tools_agent是两种不同范式前者用 ReAct 提示词模板后者依赖模型的 function calling 能力。选哪个取决于你的模型是否稳定支持工具调用。4.3 create_deep_agent 的参数面与增量能力create_deep_agent在tools之外多了几个关键参数subagents用来挂载子代理interrupt_on用来定义需要人工审批的工具checkpointer用来支持中断恢复。它的内部机制是把大模型当调度器文件系统当工作内存子代理当隔离进程。from deepagents import create_deep_agent from langgraph.checkpoint.memory import MemorySaver research_subagent { name: research-agent, description: 专门负责深度研究的子代理, prompt: 你是个专业研究员会进行深入资料搜集, tools: [internet_search], model: openai:gpt-4o, } agent create_deep_agent( modelclaude-sonnet-4-5-20250929, toolstools, subagents[research_subagent], system_prompt你是项目经理把复杂任务拆给子代理做, interrupt_on{delete_file: {allowed_decisions: [approve, reject]}}, checkpointerMemorySaver(), )参数差异的本质是create_agent只解决“模型 工具”的绑定create_deep_agent额外解决“任务规划 上下文隔离 人工介入”。当你把MultiServerMCPClient.get_tools的结果传给create_deep_agent的tools参数时MCP 工具和本地工具在框架眼里没有区别都是BaseTool所以可以混用。5. 验证请求确认函数调用真的生效写完代码最怕的是“看起来跑了其实工具没被调用”。下面这个检查动作分三层从工具列表到实际调用链都能覆盖。第一层打印工具名和描述确认 MCP 工具已经注入。for t in tools: print(t.name, |, t.description[:60])第二层用astream观察事件流看是否有tool_calls字段出现。如果模型只是普通回复而没有工具调用说明提示词或工具描述不够明确。async for chunk in agent.astream({ messages: [{role: user, content: 帮我查一下 MCP 协议的最新进展}] }): if chunk.get(messages): msg chunk[messages][-1] if getattr(msg, tool_calls, None): print(触发工具调用:, [c[name] for c in msg.tool_calls]) msg.pretty_print()第三层在 MCP 服务器端加一行日志确认请求真的到达了服务。本地stdio服务可以直接在工具函数里print远程服务看访问日志。三层都通过说明从get_tools到create_deep_agent再到实际执行的链路是通的。如果你在验证过程中需要临时切换模型对比效果可以打开模型对话页https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite手动测一条确认模型本身对工具调用的支持程度再回到代码里排查。6. 本篇常见错排查报错一TypeError: object list cant be used in await expression原因是在同步上下文里调用了get_tools()。解决方式是把它包进async def用asyncio.run()或await执行。如果你在 Jupyter 里直接用await client.get_tools()即可。报错二工具列表为空get_tools()返回[]先检查 MCP 服务器的command和args路径是否为绝对路径再确认transport类型和服务器实际协议一致。stdio服务如果启动失败get_tools不会抛异常只会返回空列表。可以在终端手动执行python /abs/path/to/math_server.py看是否正常启动。报错三create_deep_agent报checkpointer is required when interrupt_on is setinterrupt_on依赖检查点来保存中断状态必须同时传checkpointer。用MemorySaver()做本地测试即可生产环境换成持久化后端。报错四子代理没有被触发检查subagents里每个字典是否包含name、description、prompt、tools四个字段。description是主代理决定是否委派任务的依据写得太模糊会导致主代理自己干活而不调用子代理。报错五模型返回 401 或invalid api key确认OPENAI_API_KEY和OPENAI_BASE_URL同时设置且没有其他平台的同名变量覆盖。TaoToken 的 Key 在控制台https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite创建后立即生效如果仍然报错检查是否有多余空格或换行。报错六长任务跑到一半上下文爆炸这是create_agent的固有限制。把构造器换成create_deep_agent让文件系统和子代理分担上下文压力。如果任务涉及多轮工具调用优先用重型构造器。7. 接入文档与 Coding Plan把骨架落到项目里配置骨架和验证动作都跑通之后下一步是把它固化到项目结构里。建议把 MCP 服务器定义、模型入口、中断策略分别放在独立配置文件代码里只做读取和组装。这样换模型或加工具时不需要改业务逻辑。如果你打算长期用 Deep Agents 做编码类或 Agent 类任务可以看一下 Coding Plan 页面https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite里面有针对长周期任务的额度方案。接入细节和参数说明在文档页https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite遇到get_tools或create_deep_agent的参数疑问可以先查那里。控制台入口在https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteKey 管理和用量查看都在里面。最后留一个实操建议每次改完config.toml里的 MCP 服务器配置先单独跑一遍get_tools打印工具名确认注入成功再启动 Agent。这个习惯能省掉大量“Agent 不调工具”的排查时间。
延伸阅读

更多相关文章

2026/11/16 23:32:17

流量套餐网站被黑挂马?3步自查法,选对服务商哪家好

流量套餐网站被黑挂马?3步自查法,选对服务商哪家好 网站突然打不开,或者浏览器弹出满屏的赌博、色情广告,后台登录密码改了也没用。这种网站被黑挂马不知道怎么办,是无数运营人员深夜崩溃的瞬间。很多老板第一反应是找原来的建站公司,结果对方推诿扯皮…

2026/11/18 23:29:39

考电工证多久能查 电工证是上岗必备的硬门槛怎么破?

考电工证多久能查 电工证是上岗必备的硬门槛怎么破? 你是不是也担心学历不高怕报不上名?电工证是很多岗位的 上岗必备 ,但很多人不知道的是,它其实并不难考,关键是你得选对路。今天我就从一个漯河应届工程类毕业生的角度,带你看清考电工证的流程、难…

2026/11/18 23:29:39

襄垣高压电工证怎么考才不白交钱?电子证书怎么拿

襄垣高压电工证怎么考才不白交钱?电子证书怎么拿 怕考不过白交培训费?你不是一个人。很多学员在报名襄垣高压电工证时,就担心花了钱,最后考试没通过,培训费打水漂。但其实只要选对培训机构、掌握备考重点,拿到电子证书不是难事。接下来我来详细讲讲怎么…

2026/11/18 23:29:39

依安县电工证报考条件全流程办理指南,全国通用

依安县电工证报考条件全流程办理指南,全国通用 实操考试心里没底怕挂科?别慌,依安县电工证报考条件其实不难搞懂,关键是你得知道流程和细节。特别是现在电工证全国通用,无论你去哪上班,这张证都管用,但前提是得拿到手。今天就带你从头到尾搞清楚电工证…

2026/11/18 21:12:58

电工证考试口诉怎么准备值不值得考

电工证考试口诉怎么准备值不值得考 实操考试心里没底怕挂科,这是大多数准备考电工证的人心里最真实的感受。尤其是面对【电工证考试口诉】环节,很多人不知道该怎么准备,甚至担心自己说不好就被淘汰。其实,只要掌握方法, 值不值得考…

2026/11/18 21:55:23

桑植县考电工证千万别踩坑!报名全流程教你避坑

桑植县考电工证千万别踩坑!报名全流程教你避坑 你是不是也遇到过这种情况:想考个电工证,但不知道从哪儿下手,怕被中介坑,怕花冤枉钱,更怕考了证还不能用?别急,这正是你该看这篇文章的原因。在桑植县考电工证,确实有很多人被坑过,但只要你知道流程、…

2026/11/18 0:00:18

小型汽车电工证怎么考通过率揭秘

小型汽车电工证怎么考通过率揭秘 你是不是也担心,花了几千块培训费,最后考不过,钱就白花了?别急,今天我就从安阳在职建筑工人的角度,给你讲讲【小型汽车电工证怎么考】的真相,特别是【通过率揭秘】,帮你避坑、避雷、少走弯路。…

2026/11/18 0:00:18

青浦区电工证在哪考内部消息曝光了,学历不高也能考!

青浦区电工证在哪考内部消息曝光了,学历不高也能考! 你是不是也担心自己学历不高,报不了电工证?别急, 青浦区电工证在哪考 其实有“内部消息”能让你轻松搞定,而且门槛并不高。今天我就从一个过来人的角度,给你讲清楚电工证报考的真相,以及你真正需…

2026/11/18 0:00:18

你别再被中介坑了!登高证和电工证相片保姆级教程来了

你别再被中介坑了!登高证和电工证相片保姆级教程来了 你是不是正为 登高证和电工证相片 的事情发愁?不知道去哪儿报名,怕被中介忽悠,花了不少冤枉钱却还没拿到证?其实,这事儿你不是一个人在战斗,很多人都在为这事头疼。别急,今天这波 保姆级教程…

2026/11/18 12:37:05

面向复杂光照与角度的宠物面部识别鲁棒性增强策略

在智慧养宠时代,基于视觉的宠物身份识别技术正逐步从实验室走向家庭应用。然而,与配合度高的人类不同,宠物是典型的“非合作生物识别对象”——它们不会主动配合摄像头调整姿态,更无法控制光照环境。实际应用中,我们常…

2026/11/18 1:15:04

SSM电子书店源码全解析:结构、原理、部署与排错实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑