企业官网建设流程全解析

1. 刚跑通四阶段的 Agent，卡在了模型通道这一环

你按教程把 Agent 从零搭起来了：阶段一能发单次请求，阶段二 history 数组能维护多轮对话，阶段三 functionCall 能返回结构化调用，阶段四 ReAct 循环也能转起来。逻辑全对，但一跑就报错——要么连接超时，要么 401，要么返回一堆看不懂的网关错误。问题不在你的循环代码，而在apiEndpoint这个变量指向的模型通道。

Agent 的四个阶段，本质上都依赖同一个东西：一个稳定、可替换的模型通道。阶段一的fetch(apiEndpoint, ...)是整条链路的第一个发起点，后面多轮对话、工具调用、Agent Loop 全都复用这个通道。通道不通，后面写得再漂亮也白搭。

这篇就干一件事：把apiEndpoint换成https://taotoken.net/api，apiKey去 TaoToken 控制台创建，然后验证阶段一到阶段四能不能照常跑通。TaoToken 在这里的角色是模型通道，不碰你的 Agent 循环逻辑——你的 history 数组、functionCall 解析、ReAct 循环一行都不用改。

适合谁看：已经写完 Agent 骨架、但模型请求发不出去的开发者；或者想把模型通道统一管理、不想在每个阶段重复配 key 的人。下面按“改配置 → 验证四阶段 → 排错”的顺序走，每一步都能直接复制。

2. 把模型通道抽出来：TaoToken 的接入位置

先说清楚 TaoToken 在架构里的位置。你的 Agent 长这样：

你的 Agent 代码 ├─ 阶段一：fetch(apiEndpoint, ...) ← 第一个发起点 ├─ 阶段二：history 数组 + sendMessage ├─ 阶段三：toolRegistry + functionCall └─ 阶段四：Agent Loop（ReAct） ↓ 全部走同一个通道 apiEndpoint = https://taotoken.net/api ↓ TaoToken（模型通道） ↓ 实际模型

关键点：TaoToken 只负责“请求转发 + 鉴权 + 模型路由”，它不参与你的循环决策。你的MAX_ROUNDS、工具白名单、system prompt 全都留在自己代码里。

为什么值得把通道单独抽出来？我试过在四个阶段各写一份请求配置，结果改一次 key 要动四个文件，还容易漏。抽成一个client之后，阶段二到阶段四全部复用同一个实例，改配置只改一处。

接入前你需要两样东西：

创建 key 的入口在控制台的 API Keys 页面，直接访问 https://taotoken.net/api-keys 也行。创建后复制那串 key，只显示一次，记得存好。

注意：apiKey 不要硬编码进提交到 Git 的代码里。用环境变量或.env文件，后面配置示例会写。

3. 可复制配置：从阶段一到阶段四的完整改造

3.1 环境变量与基础 client

先建一个.env：

TAOTOKEN_API_KEY=你的key TAOTOKEN_BASE_URL=https://taotoken.net/api

然后写一个最小的请求封装，四个阶段共用：

// client.ts const API_KEY = process.env.TAOTOKEN_API_KEY!; const BASE_URL = process.env.TAOTOKEN_BASE_URL ?? "https://taotoken.net/api"; export interface Message { role: "system" | "user" | "assistant" | "tool"; content: string; } export async function sendMessage( messages: Message[], tools?: unknown[] ): Promise<any> { const res = await fetch(`${BASE_URL}/v1/chat/completions`, { method: "POST", headers: { "Content-Type": "application/json", Authorization: `Bearer ${API_KEY}`, }, body: JSON.stringify({ model: "gpt-4o-mini", // 按你实际可用的模型填 messages, tools, }), }); if (!res.ok) { const err = await res.text(); throw new Error(`模型通道返回 ${res.status}: ${err}`); } return res.json(); }

这里BASE_URL就是https://taotoken.net/api，路径拼/v1/chat/completions。如果你的原代码用的是别的路径格式，以接入文档为准：https://taotoken.net/doc 。

3.2 阶段一：单次对话改造

原来的阶段一代码：

const res = await fetch(apiEndpoint, { method: "POST", headers: { "Content-Type": "application/json", Authorization: `Bearer ${apiKey}`, }, body: JSON.stringify(body), });

改造后，apiEndpoint换成 TaoToken 地址，其余不动：

import { sendMessage } from "./client"; const body = { messages: [ { role: "system", content: "你是一个有帮助的助手。" }, { role: "user", content: "你好" }, ], }; const data = await sendMessage(body.messages); console.log(data.choices[0].message.content);

跑通标志：终端打印出模型回复。如果这里就报 401，先检查 key 和环境变量有没有加载。

3.3 阶段二：多轮对话的 history 数组

阶段二的核心是客户端维护 history。改造点只有一个：sendMessage内部走 TaoToken，history 逻辑完全不动。

class Chat { private history: Message[] = []; async send(text: string): Promise<string> { this.history.push({ role: "user", content: text }); const data = await sendMessage(this.history); const reply = data.choices[0].message.content; this.history.push({ role: "assistant", content: reply }); return reply; } }

验证方法：连续发三句话，看模型能不能记住第一句。比如先问“我叫小明”，再问“我叫什么”，能答出“小明”就说明 history 数组正常随请求发出去了。

3.4 阶段三：functionCall 工具调用

阶段三给请求加上tools参数。TaoToken 通道会把工具定义一起转发，返回的functionCall结构和你原来一致。

const tools = [ { type: "function", function: { name: "run_shell_command", description: "Run a shell command on the user's machine", parameters: { type: "object", properties: { command: { type: "string", description: "The shell command" }, }, required: ["command"], }, }, }, ]; const data = await sendMessage( [{ role: "user", content: "看看当前目录有什么文件" }], tools ); const msg = data.choices[0].message; if (msg.tool_calls) { const call = msg.tool_calls[0].function; console.log("模型想调用:", call.name, call.arguments); }

跑通标志：模型返回的不再是纯文本，而是带tool_calls的结构化请求。注意，模型只是“下达指令”，真正执行ls -la的还是你的代码。

3.5 阶段四：Agent Loop 照常转

阶段四的 ReAct 循环，改造点同样只在sendMessage内部。循环骨架一行不改：

async send(text: string): Promise<string> { this.history.push({ role: "user", content: text }); for (let i = 0; i < MAX_ROUNDS; i++) { const data = await sendMessage(this.history, tools); const msg = data.choices[0].message; this.history.push({ role: "assistant", content: msg.content ?? "" }); if (!msg.tool_calls) { return msg.content ?? ""; } for (const call of msg.tool_calls) { const result = await this.toolRegistry.execute( call.function.name, JSON.parse(call.function.arguments) ); this.history.push({ role: "tool", content: JSON.stringify({ name: call.function.name, result }), }); } } throw new Error("Max tool call rounds exceeded"); }

实测下来，只要阶段三的tool_calls能正常返回，阶段四的循环就能一圈圈转下去。MAX_ROUNDS这个安全阀记得留着，防止模型在某个工具上反复横跳。

4. 验证请求：四阶段逐个跑通

配置改完，按顺序验证。别跳步，阶段一不通就别急着跑阶段四。

第一步，验证通道连通性。用 curl 直接打一发：

curl -X POST https://taotoken.net/api/v1/chat/completions \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $TAOTOKEN_API_KEY" \ -d '{ "model": "gpt-4o-mini", "messages": [{"role": "user", "content": "ping"}] }'

返回里有choices[0].message.content就说明通道通了。

第二步，跑阶段一脚本，看单次问答。

第三步，跑阶段二，连续三轮对话，确认 history 生效。

第四步，跑阶段三，确认返回tool_calls。

第五步，跑阶段四，给一个需要多步的任务，比如“看看当前目录有什么文件，然后统计代码行数”，观察循环是否按“思考 → 行动 → 观察”转了三圈后返回总结。

成功结果长这样：

第 1 圈：模型 → run_shell_command(ls -la) → 代码返回文件列表 第 2 圈：模型 → run_shell_command(wc -l src/*.ts) → 代码返回行数 第 3 圈：模型 → 返回文本总结 → 循环结束

四阶段全绿，说明模型通道替换完成，你的 Agent 循环逻辑毫发无损。

5. 本篇常见错排查

5.1 401 Unauthorized

最常见。原因通常是 key 没加载或拼错。检查.env有没有被读取，Authorization头是不是Bearer加空格再加 key。key 前后有空格也会挂。

5.2 404 Not Found

路径拼错。BASE_URL是https://taotoken.net/api，后面接/v1/chat/completions。别把/api和/v1的顺序搞反，也别重复拼/api。

5.3 阶段三返回纯文本，没有 tool_calls

两个可能：一是tools参数没传进去，检查sendMessage的第二个参数；二是模型本身不支持工具调用，换一个支持 function calling 的模型名。

5.4 阶段四循环停不下来

MAX_ROUNDS没设或设太大。另外检查工具执行结果有没有正确 push 回 history，如果role: "tool"的消息没进数组，模型会以为工具没执行，反复调用。

5.5 连接超时

先确认网络能访问https://taotoken.net/api。如果 curl 能通但代码不通，检查是不是代码里还残留着旧的apiEndpoint变量没替换干净。

排障时优先看 HTTP 状态码和返回体，TaoToken 的错误信息一般会说明是鉴权问题还是参数问题。接入细节可对照 https://taotoken.net/doc 。

6. 通道配好之后，下一步做什么

模型通道替换这件事，做完就一劳永逸。你的 Agent 四阶段逻辑不用再动，后面加工具、加 Sub-Agent、加 Skill，全都复用同一个sendMessage。

如果你还没创建 key，去 https://taotoken.net/api-keys 建一个，把.env填上就能跑。想先看看模型对话效果，可以直接在 https://taotoken.net/chat 里试几轮，确认通道正常再回代码里调。

长期跑编码类 Agent、需要稳定高频调用的，可以了解下 Coding Plan：https://taotoken.net/coding-plan ，按用量规划比每次临时配更省心。接入过程中卡在某个阶段，对照接入文档 https://taotoken.net/doc 逐项核对参数，基本都能定位到问题。