ARTICLE DETAIL

资讯详情

深耕编程入门与网站建设的一线实战洞察。

Function Calling、MCP、Skills 到底怎么选?Agent 模型通道改走 TaoToken 再跑流程验证

Function Calling、MCP、Skills 到底怎么选?Agent 模型通道改走 TaoToken 再跑流程验证 Function Calling、MCP、Skills 到底怎么选Agent 模型通道改走 TaoToken 再跑流程验证在把 MCP Server 接到 Claude Code或者写 SKILL.md 让模型按固定流程执行时很多人先怀疑协议、schema 或权限却忽略了模型通道本身是否可用。TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 提供模型通道的 Key 和 Base URL但它不替代 Function Calling、MCP 或 Skills 的工作。请求如果打到错误 Base URL、Key 没生效Function Calling 不会返回 tool_callsSkills 的 load_skill 也不会被触发。先把 TaoToken 的 Key 和 Base URL 配好再去区分 Function Calling、MCP、Skills 的选型会少走很多弯路。API 地址填 https://taotoken.net/api注意不带 /v1也不加 UTM。接下来用天气查询 tool_calls 和 SKILL.md 加载流程做验证看请求能否通、tool_calls 能否正常返回。一、原问题与场景Function Calling、MCP、Skills 不是同一层SKILL.md 跑不通先查模型通道Function Calling、MCP、Skills 经常被放在一起讨论但它们并不是互相替代的三个工具。更准确地说Function Calling 是模型侧的原子能力模型把用户的自然语言意图转换成结构化的函数调用典型表现就是返回带 tool_calls 的 JSON。MCP 解决的是异构系统接驳问题它提供一套标准化协议让 LLM 或 Agent 客户端能以统一方式连接外部数据源和已有系统。Skills 更偏流程编排用文字、Markdown、脚本和资源文件定义任务流程再通过 Function Calling 去加载 SKILL.md让模型按文档里的步骤执行。这三者的选型并不复杂。简单 API 调用优先用 Function Calling比如查天气、算汇率、查订单状态。需要接已有系统时用 MCP比如接公司知识库、Jira、数据库、GitHub、Slack 这类已经存在的服务。面对强流程任务时用 Skills比如发版、合规检查、代码审查、数据分析 SOP。真正容易踩坑的地方在于无论你选哪一种只要涉及模型决策就会产生模型请求而模型请求本身要消耗 Token。原文讲了概念和选型但没有给模型通道的准备步骤。接 MCP Server 或写 SKILL.md 跑流程时如果模型通道没配好就会出现请求超时、401、404、tool_calls 不返回、SKILL.md 不加载等现象。如果你用 Claude Code 或 Codex 做 MCP、Skill 实验需要把模型通道单独配好。Claude Code 关注 settings.json 里的 ANTHROPIC_* 变量Codex 关注 config.toml 里的 model_provider 和 base_url。以 TaoToken 为例Base URL 填 https://taotoken.net/apiKey 用刚创建的 YOUR_API_KEY。TaoToken 只提供模型通道的 Key 和 Base URL不替代 Function Calling、MCP 或 Skills 本身。MCP Server 仍然要你自己接SKILL.md 仍然要你自己写tools schema 仍然要你自己定义。把模型通道准备好之后再跑原文里的天气查询 tool_calls JSON 或 SKILL.md 加载流程验证请求能通、tool_calls 能正常返回。二、TaoToken 前置只提供模型通道的 Key 与 Base URLTaoToken 在这类实验里的角色很明确提供模型请求所需的 Key 和 Base URL。它不是 MCP Server也不是 Skills 运行时更不是 Function Calling 的实现方。你需要先到官网注册并创建 Key官网注册入口https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content创建 Key 后在支持 Function Calling 的客户端里填入Base URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEY模型 ID按你在 TaoToken 控制台实际可用的模型填写本文用 MODEL_ID 代指注意两个细节。第一Base URL 不要写成 https://taotoken.net/api/v1很多 OpenAI 兼容客户端会自动拼接 /v1/chat/completions你多写一层会导致路径重复出现 404。第二Base URL 不要带 UTM 参数UTM 用于网页跳转统计不适合作为 API 基础地址。Key 则使用你在控制台新建的那一个不要继续用示例里的 YOUR_API_KEY。如果你只是验证 Function Calling可以在通用 OpenAI 兼容客户端里设置环境变量。如果你用 Claude Code 做 MCP、Skill 实验就改 settings.json 中的 ANTHROPIC_* 配置。如果你用 Codex就改 config.toml。Cline、CC Switch 或其他支持自定义 Base URL 的客户端逻辑相同找到模型提供商设置把 Base URL 指向 https://taotoken.net/api把 API Key 换成刚创建的 Key。TaoToken 不替代编辑器也不替代 Agent 框架它只负责让模型请求有可用的通道。三、可复制配置settings.json、config.toml 与 SKILL.md 示例先给通用环境变量配置。很多支持 Function Calling 的 SDK 和 CLI 都会读取 OPENAI_BASE_URL 与 OPENAI_API_KEYexport OPENAI_BASE_URLhttps://taotoken.net/api export OPENAI_API_KEYYOUR_API_KEY请求时用${OPENAI_BASE_URL}/v1/chat/completions也就是 https://taotoken.net/api/v1/chat/completions。Base URL 本身仍然保持不带 /v1。如果你用 Claude Code 做 MCP 和 Skill 实验可参考~/.claude/settings.json{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: MODEL_ID } }如果当前 Claude Code 版本读取的是ANTHROPIC_API_KEY就把变量名替换成对应名称值仍然是刚创建的 Key。JSON 文件不要写注释变量名大小写也不要改错。改完后重启 Claude Code避免旧环境变量被缓存。如果你用 Codex可参考~/.codex/config.tomlmodel MODEL_ID model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY然后设置环境变量export TAOTOKEN_API_KEYYOUR_API_KEY这里base_url同样不带 /v1不加 UTM。model_provider和[model_providers.taotoken]的名称要一致否则 Codex 可能找不到供应商配置。Skills 实验需要准备一个 SKILL.md。它的 front matter 里name和description很关键因为模型会依据这些元数据判断是否加载。下面是一个天气报告 Skill 示例--- name: weather-report description: 当用户询问某个城市某天天气时按固定流程调用 get_weather 并生成简短报告 --- # weather-report 执行流程 1. 从用户问题中提取城市和日期。 2. 调用 get_weather参数为 city 和 date。 3. 如果缺少城市或日期先向用户追问。 4. 拿到工具结果后输出城市、日期、温度、天气和一条出行建议。当用户问“杭州明天天气怎么样”时支持 Skills 的客户端会把 Skill 元数据放进上下文。模型判断需要该 Skill 后会通过 Function Calling 调用类似load_skill(skill_name)的函数把 SKILL.md 内容加载进当前上下文。之后模型再按文档步骤调用get_weather。整个过程依赖 Function Calling而 Function Calling 的模型请求走的就是你刚配好的 TaoToken 通道。MCP 实验同理。MCP Server 的注册方式取决于客户端比如在 Claude Code 的 MCP 配置里声明 server 命令、参数和环境变量。但 MCP 只负责客户端与外部系统之间的 JSON-RPC 接驳模型侧仍然要能返回 tool_calls。如果模型通道不通MCP Server 即使启动成功Agent 也无法完成工具调用。四、验证请求天气 tool_calls JSON 与 SKILL.md 加载结果先验证 Function Calling。用 cURL 发一个带 tools 的请求curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer $OPENAI_API_KEY \ -H Content-Type: application/json \ -d { model: MODEL_ID, messages: [ {role: user, content: 帮我查一下杭州明天的天气} ], tools: [ { type: function, function: { name: get_weather, description: 查询指定城市指定日期的天气, parameters: { type: object, properties: { city: {type: string, description: 城市名}, date: {type: string, description: 日期如 tomorrow 或 2025-01-01} }, required: [city, date] } } } ], tool_choice: auto }如果模型通道正常并且模型支持 Function Calling响应里应该出现tool_calls而不是一段纯自然语言。期望结果类似{ choices: [ { message: { role: assistant, content: null, tool_calls: [ { id: call_weather_001, type: function, function: { name: get_weather, arguments: {\city\:\杭州\,\date\:\tomorrow\} } } ] }, finish_reason: tool_calls } ] }看到finish_reason为tool_callsfunction.name为get_weather就说明模型已经正确输出结构化调用。接下来你的应用要解析function.arguments执行真实天气查询再把结果以role: tool和对应tool_call_id回填给模型。模型收到工具结果后才会生成最终回答。再验证 SKILL.md 加载流程。你可以把 tools 里加入load_skill{ type: function, function: { name: load_skill, description: 按名称加载 SKILL.md用于执行固定流程, parameters: { type: object, properties: { skill_name: {type: string} }, required: [skill_name] } } }当用户请求匹配weather-report的 description 时期望模型返回{ tool_calls: [ { id: call_skill_001, type: function, function: { name: load_skill, arguments: {\skill_name\:\weather-report\} } } ], finish_reason: tool_calls }客户端解析后读取 SKILL.md把内容注入上下文。如果 SKILL.md 里定义了get_weather调用步骤后续模型还会继续输出天气查询的 tool_calls。成功标志是请求能通、tool_calls 正常返回、SKILL.md 能被加载、后续工具调用能按流程继续。选型仍然照原文简单 API 用 Function Calling接既有系统用 MCP强流程任务用 Skills。五、本篇常见错排查Base URL、tool_calls、skills 加载失败第一Base URL 多写 /v1。配置里应填 https://taotoken.net/api请求路径由客户端拼接。如果填成 https://taotoken.net/api/v1再拼一次 /v1/chat/completions就会出现重复路径和 404。第二Key 没有替换。YOUR_API_KEY只是占位符必须换成 TaoToken 控制台新建的 Key。401 或 invalid api key 通常先查这里。第三Claude Code settings.json 语法错误。JSON 不支持注释和尾逗号ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN等变量名要按客户端版本文档写。改完要重启客户端。第四Codex config.toml 中 provider 名称不一致。model_provider taotoken必须对应[model_providers.taotoken]。env_key指定的环境变量也要提前 export。第五模型通道没带 tools。Function Calling 需要请求体里有 tools 定义。没有 tools 时模型可能只返回自然语言不会出现 tool_calls。第六工具结果回填错误。执行完函数后回填消息要用role: tool并带上原来的tool_call_id。如果当成普通 user 消息回填模型可能无法继续流程。第七SKILL.md 的 description 太模糊。描述里要写清触发条件例如“当用户询问某城市某天天气时”。如果描述太泛模型可能不触发load_skill。第八MCP Server 启动成功但模型通道不通。MCP 只解决客户端到外部系统的接驳模型请求仍要经过 TaoToken 或其他模型通道。MCP Server 日志正常不代表 tool_calls 会正常返回。第九Base URL 带 UTM。API 基础地址不要带utm_source、utm_content等参数网页官网链接可以带API 地址保持干净。第十客户端缓存旧配置。环境变量、settings.json、config.toml 改完后最好重启 Claude Code、Codex、Cline 或 CC Switch再发一次天气 tool_calls 验证请求。六、CTA按排障、验证模型与长期 Agent 分流如果你的问题集中在 settings.json、config.toml、CC Switch、Cline 或 MCP/Skills 接入排障先检查 API Key 和接入文档。API Keys 页面https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入文档入口https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite如果你只是先验证模型能否正常返回 tool_calls、SKILL.md 能否触发加载去模型对话里发一条带工具的测试请求https://taotoken.net/console/chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite如果你准备把 MCP、Skills 放进长期编码或 Agent 工作流关注 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite还没有 Key 的话从官网注册并创建https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content拿到 Key 后把 Base URL 填成 https://taotoken.net/apiKey 填 YOUR_API_KEY 对应的实际值再跑一遍天气查询 tool_calls JSON 或 SKILL.md 加载流程。选型不变简单 API 用 Function Calling接既有系统用 MCP强流程任务用 Skills。TaoToken 只负责模型通道Function Calling、MCP、Skills 的实验和流程仍然由你的客户端、MCP Server 与 SKILL.md 共同完成。
返回列表