1. 从一条会议任务说起八个词到底在哪儿登场刚接触 Agent 开发的工程师几乎都会经历同一个阶段Prompt 还没写利索Context、RAG、Memory 就冒出来了等你想让模型真正干点活Tool、MCP、Skills、Agent、Harness 又排着队出现。每个词单独查都能看懂凑在一起就分不清谁管谁。我习惯用一条真实任务把它们串起来“整理本周会议生成待办经我确认后发给相关同事。”这句话只交代了目标但要真正做完系统得先找到本周会议记录RAG读懂项目背景和你的偏好Memory认出谁负责、哪天截止Prompt 里的规则再调用任务系统和消息系统Tool中间还得处理缺失信息、等待你点头Harness 的审批与权限。所以这八个词不是八个并列的技术而是同一套 AI 系统里的不同分工。本文用一份可复制的config.toml/settings.json骨架当线索把每个概念在配置里的落点讲清楚最后用 TaoToken 统一 Key 把整条链路跑通。适合刚入门 Agent、想建立完整认知地图的工程师读完你能拿到一份能直接改的配置骨架以及逐项验证的动作。2. 概念落点八个词在配置骨架里各占哪一行在动手写配置前先把职责分四组心里有个底。准备信息的Prompt、Context、RAG、Memory接工具和做法的Tool、MCP、Skills推进任务的Workflow、Agent控制运行的Harness。真实产品里这些活经常交叉一个组件身兼数职也正常。先掰开三个最容易混的说法。模型只负责接收输入、生成文本或候选动作AI 系统把模型、上下文、数据、工具、状态和控制机制组合起来AI 产品在系统之上再加界面、账号、协作和计费。同一个模型装进不同系统表现能差出一大截换一套资料、换一批工具、换一种重试方式它能做的事和容易犯的错都会变。落到配置上每个概念都有明确的归属概念配置落点一句话职责Prompt[prompt]段这一轮的任务说明Context运行时拼装模型这次能看到的全部信息RAG[rag]段这次去哪检索资料Memory[memory]段跨会话记住什么Tool[tools]数组能调用的具体动作MCP[mcp.servers]统一的连接方式Skills[skills]段可复用的做事方法Agent / Harness[agent]/[harness]推进任务与运行控制注意Context 不是一个配置段它是运行时把 Prompt、RAG 结果、Memory 召回、工具说明拼装出来的产物。你在配置里写的是“原料”Context 是“上桌的那盘菜”。3. TaoToken 前置统一 Key 与接入地址八个概念要跑起来绕不开模型调用这一层。与其给每个组件单独配一套 Key不如用 TaoToken 做统一入口一个 Key 覆盖对话、编码、Agent 场景配置里只维护一处凭证换模型时改一行就行。先拿到凭证。打开控制台创建 API Key控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite接入地址统一用https://taotoken.net/api这个地址不加 UTM 参数直接写进配置。如果你要对照参数含义接入文档在这里https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite长期做编码或跑 Agent 循环的话Coding Plan 更划算额度模型和按量调用不一样可以先看https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite拿 Key 的步骤不复杂登录控制台 → 进入 API Keys → 新建 → 复制保存。这个 Key 只显示一次务必先存到本地环境变量或密钥管理里别直接写进会提交到 Git 的配置文件。下面骨架里我用${TAOTOKEN_API_KEY}占位运行时从环境变量注入。4. 可复制配置config.toml 与 settings.json 骨架下面这份config.toml把八个概念的落点全部标出来了。你可以直接复制按注释替换成自己的值。我刻意把每个段落和概念一一对应方便你对照理解。# 模型与统一接入 [provider] name taotoken base_url https://taotoken.net/api api_key ${TAOTOKEN_API_KEY} # 从环境变量注入勿硬编码 default_model claude-sonnet # 按需替换为控制台可用模型 # Prompt这一轮的任务说明 [prompt] system 你是会议助理。整理本周会议提取待办、负责人、截止时间。 先生成草稿用户确认后再创建任务并发送消息。 output_format markdown # RAG这次去哪检索资料 [rag] enabled true retriever hybrid # 关键词 向量混合检索 top_k 8 rerank true sources [meeting_notes, project_docs] # Memory跨会话记住什么 [memory] short_term session # 当前会话与任务状态 long_term persistent # 跨会话偏好与项目事实 recall_top_k 5 # Tool能调用的具体动作 [[tools]] name create_task description 在任务系统中创建待办 requires_approval false [[tools]] name send_message description 向相关同事发送消息 requires_approval true # 外发动作需人工确认 # MCP统一的连接方式 [mcp.servers.calendar] transport stdio command mcp-calendar [mcp.servers.taskboard] transport http url https://internal.example.com/mcp # Skills可复用的做事方法 [skills] dir ./skills auto_load [meeting-to-todo] # 只加载名称与描述按需展开 # Agent推进任务 [agent] mode agent # agent | workflow max_turns 12 stop_on_approval true # Harness运行与控制 [harness] timeout_seconds 120 max_retries 2 sandbox true trace true eval true如果你用的是 JSON 风格的工具比如某些编辑器或 Agent 客户端等价骨架如下{ provider: { name: taotoken, baseUrl: https://taotoken.net/api, apiKey: ${TAOTOKEN_API_KEY}, defaultModel: claude-sonnet }, rag: { enabled: true, retriever: hybrid, topK: 8 }, memory: { shortTerm: session, longTerm: persistent }, tools: [ { name: create_task, requiresApproval: false }, { name: send_message, requiresApproval: true } ], mcp: { servers: { calendar: { transport: stdio, command: mcp-calendar } } }, agent: { mode: agent, maxTurns: 12 }, harness: { timeoutSeconds: 120, sandbox: true, trace: true } }几个关键点值得单独说。requires_approval是 Harness 权限控制的落点外发消息这类高影响动作必须走审批而创建草稿任务可以放行。mcp.servers里每个 Server 由 Host 建独立 Client 连接Server 能提供 Resources、Prompts、Tools 三类能力配置里只声明连接方式具体能力由 Server 自己协商。skills.auto_load只加载名称和描述完整说明和脚本等真正用到再读这样技能攒多了也不会把 Context 挤爆。5. 验证请求逐项跑通并确认结果配置写完不算完得逐项验证。先设好环境变量再发一个最小请求确认 Key 和地址通了export TAOTOKEN_API_KEY你的Key curl https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer ${TAOTOKEN_API_KEY} \ -H Content-Type: application/json \ -d { model: claude-sonnet, messages: [ {role: system, content: 你是会议助理}, {role: user, content: 整理本周会议生成待办草稿} ] }返回里能看到choices[0].message.content就说明统一 Key 生效了。想先在网页里直观试模型效果可以用模型对话https://taotoken.net/model-chat?utm_sourcetaotoken_aicg_blog_endutm_contentmodel-chatutm_campaignrewrite接着逐项验证八个概念是否真的接上了验证 RAG问一个只有会议记录里才有的问题比如“上周三评审会定了哪个截止日期”。如果回答引用了具体来源说明检索链路通了如果答得含糊检查top_k和rerank是否生效。验证 Memory先告诉它“待办必须有负责人和截止时间”开新会话再问“帮我建待办”看它是否自动带上这两个字段。没带上就检查long_term是否真的持久化。验证 Tool让它“创建一个测试待办”观察是否生成结构化调用请求。注意模型自己从头到尾没碰过工具它只提要求真正执行的是应用。验证 MCP让它“查一下我明天的日程”看是否通过calendarServer 拿到数据。连不上先查 transport 和 command 路径。验证 Skills触发“会议转待办”看它是否按 SKILL.md 里定义的字段和歧义处理规则执行。验证 Harness让它“把待办发给张三”确认它在发送前停下来等你确认。没停就说明requires_approval没被强制执行。跑完这一轮你会对每个概念的边界有实感Context Window 管一次能装多少RAG 管这次去哪找Memory 管以后记住什么Cache 管哪些算过的能复用各管各的。6. 常见错排查配置跑不通时先看这几处报 401 或鉴权失败九成是 Key 没注入成功。先echo $TAOTOKEN_API_KEY确认环境变量非空再检查配置里是不是误把占位符当成了真实值。别把 Key 硬编码进会提交的文件。RAG 检索不到内容先确认sources指向的索引是最新的。资料源和索引不更新答案照样过时。检索回来的片段只是候选资料不等于证据来源靠不靠谱、能不能撑住结论都得核对。Memory 不生效短期记忆和长期记忆是两回事。当前会话状态丢了检查 session 是否被正确传递跨会话偏好丢了检查持久化存储是否真的写入。记住这些内容是应用替模型写入、更新、取回、删除的模型自己不会永久记住。MCP 连接超时stdio 类型检查 command 是否在 PATH 里http 类型检查 url 可达性和鉴权。MCP 只管双方怎么连接、怎么说话业务权限和审批沙箱得靠协议外面的系统负责。Agent 循环停不下来检查max_turns和停止条件。Agent 一圈一圈循环直到任务完成、触发停止条件或者需要人来拿主意。没有明确停止条件就会一直转。外发动作没等确认就执行这是最危险的。确认requires_approval在 Harness 层被强制执行而不是只写在工具描述里。权限要由 Host、操作系统或外部服务强制执行审批不能替代底层权限与沙箱。Prompt Injection 风险网页、邮件、会议文档、工具结果都可能夹带诱导指令。把外部内容当低信任数据处理配上内容隔离、最小权限、审批和输出验证。风险最高的路径通常同时满足三个条件能读私有数据、会接触不可信内容、还能往外发消息。三样凑齐就危险办法是把权限拆开外发或写入步骤加人工确认。7. 下一步把骨架接进你的项目这份骨架的价值在于它把八个抽象概念变成了八行能改的配置。你可以先只填provider和prompt跑通最小闭环再逐段打开 RAG、Memory、Tool最后接 MCP 和 Skills。每打开一段就做一次上面的验证动作别一次性全开出问题不好定位。统一 Key 的好处在这里体现得最明显无论你后面接的是对话、编码还是 Agent 循环凭证和地址都只维护一处。需要对照完整参数时翻接入文档想先试模型效果就去模型对话长期跑编码和 Agent 任务就上 Coding Plan。把配置骨架存好下次开新项目直接复制改几行就能跑。
