1. 物业工单小程序接 AI卡在哪一步物业工单系统做小程序最容易被低估的不是页面而是「AI 能力怎么接进去」。报修描述是一段口语化的业主原话派单要判断紧急程度和工种工单完成后还要生成摘要回写。这三件事都适合交给模型但真正落地时独立开发者和物业 IT 往往卡在同一个地方配置文件写不对请求发不出去报错看不懂。我见过太多项目把 Key 硬编码在云函数里换一次环境就要重新发版也见过模型名写错一个字符前端一直转圈后端日志里只有一行 401。问题不在模型本身而在于缺少一个稳定的配置骨架。这篇就围绕config.toml这个骨架把物业工单小程序接入 AI 的配置落地讲清楚字段填在哪、每个字段什么意思、401/超时/模型名错误分别怎么定位。适合两类人看一是独立开发者想用小程序快速搭一套能跑的工单系统二是物业 IT手里有现成工单流程想把摘要和派单自动化。目标很明确一次性跑通「工单摘要 自动派单」的调用链而不是停留在能对话的 Demo。TaoToken 在这里的角色是统一 Key 和 API 通道。你不需要为每个模型单独维护一套鉴权逻辑配置集中在一个文件里小程序端、云函数端、本地调试端共用同一份骨架。下面从配置开始一步步走到验证和排障。2. TaoToken 前置Key、通道与 config.toml 的关系在写配置之前先把三个概念理清楚不然后面字段填错都不知道错在哪。Key 是身份凭证所有请求都要带上它。TaoToken 的 Key 在控制台的 API Keys 页面生成生成后只显示一次复制下来存好。通道指的是请求发往哪个地址TaoToken 的 API 入口是https://taotoken.net/api所有模型调用都走这个基地址具体模型通过请求体里的模型名区分。config.toml 则是把这些信息集中管理的地方小程序端不直接读它而是由云函数或本地服务读取后组装请求。为什么用 TOML 而不是 JSON 或环境变量TOML 可读性好支持注释适合多人协作时标注每个字段的用途。物业 IT 交接项目时打开配置文件就能看懂哪一行是 Key、哪一行是模型名不用翻代码。你需要先拿到 Key入口在这里API Keys 页面在控制台里生成后建议按环境命名比如wuye-dev、wuye-prod避免开发和线上混用。接入文档里有完整的字段说明和请求示例配置前扫一遍能省很多排障时间。注意Key 不要提交到代码仓库。config.toml 里可以写占位符真实 Key 通过环境变量注入或者放在.gitignore覆盖的本地文件里。配置骨架的核心就三块鉴权信息、API 基地址、模型参数。下面直接给可复制的片段。3. 可复制配置config.toml 骨架与字段含义先给一份完整的config.toml物业工单场景直接改模型名和 Key 就能用。# 物业工单系统 AI 配置骨架 # 环境dev / prod通过环境变量 TAOTOKEN_ENV 切换 [api] # TaoToken API 基地址所有请求拼接此地址 base_url https://taotoken.net/api # 请求超时单位秒。工单摘要建议 30派单判断建议 15 timeout 30 # 失败重试次数网络抖动时有用 max_retries 2 [auth] # 从环境变量读取不要硬编码 api_key ${TAOTOKEN_API_KEY} # 鉴权头格式TaoToken 使用 Bearer auth_header Authorization auth_prefix Bearer [model] # 工单摘要用的模型长文本理解能力强 summary_model claude-sonnet-4-20250514 # 自动派单用的模型响应快、成本低 dispatch_model claude-haiku-4-20250514 # 温度摘要用 0.3 稳定派单用 0.1 更确定 temperature 0.3 # 最大输出 token摘要 800 够用派单 200 够用 max_tokens 800 [prompt] # 工单摘要模板 summary_template 请将以下物业报修内容总结为 50 字以内的摘要保留楼栋、房号、故障类型 {content} # 自动派单模板 dispatch_template 根据以下报修内容判断紧急程度高/中/低和负责工种水电/保洁/安保/电梯 {content} 只返回 JSON格式{priority: , trade: } [logging] # 日志级别debug / info / warn / error level info # 是否记录请求耗时排障时打开 log_latency true字段逐个说清楚。base_url是固定的不要改成别的地址否则请求发不出去。timeout和max_retries是排障时最常调的两个值超时问题基本靠它们定位。api_key用${}占位运行时从环境变量替换这样配置文件可以进仓库Key 不会泄露。summary_model和dispatch_model分开配置是因为两个任务的诉求不同。摘要要理解长文本用能力强的模型派单要快、要便宜用轻量模型。模型名必须和 TaoToken 支持的名称完全一致写错就是 404 或模型名错误。temperature和max_tokens影响输出质量。摘要温度太高会编内容派单温度太高会乱分类所以都调低。max_tokens设太小会被截断设太大浪费成本按任务给。prompt段把模板抽出来改话术不用动代码。logging段在排障时把level改成debug能看到完整的请求和响应。小程序端怎么用这份配置云函数里读取 TOML替换环境变量组装请求。下面给一个 Node.js 的读取示例。// 云函数中读取 config.toml const fs require(fs); const toml require(iarna/toml); function loadConfig() { const raw fs.readFileSync(./config.toml, utf-8); const config toml.parse(raw); // 替换环境变量占位符 config.auth.api_key config.auth.api_key.replace( ${TAOTOKEN_API_KEY}, process.env.TAOTOKEN_API_KEY ); return config; } module.exports { loadConfig };读取后组装请求核心是拼接base_url和鉴权头。async function callModel(config, model, prompt) { const url ${config.api.base_url}/v1/messages; const res await fetch(url, { method: POST, headers: { Content-Type: application/json, [config.auth.auth_header]: config.auth.auth_prefix config.auth.api_key, }, body: JSON.stringify({ model: model, max_tokens: config.model.max_tokens, temperature: config.model.temperature, messages: [{ role: user, content: prompt }], }), }); if (!res.ok) { const err await res.text(); throw new Error(请求失败 ${res.status}: ${err}); } return res.json(); }到这里配置骨架就完整了。接下来是验证三步动作本地请求、日志核对、工单回写。4. 三步验证本地请求、日志核对、工单回写配置写完不验证等于没写。按这三步走每一步都有明确的成功标志。第一步本地请求。在项目根目录建一个test.js直接调用上面的callModel用一段真实的报修内容测试摘要。const { loadConfig } require(./config-loader); const { callModel } require(./model-client); (async () { const config loadConfig(); const content 3栋2单元501厨房水管漏水已经渗到楼下业主很着急; const prompt config.prompt.summary_template.replace({content}, content); const result await callModel(config, config.model.summary_model, prompt); console.log(摘要结果, result.content[0].text); })();运行node test.js成功标志是控制台打印出 50 字以内的摘要包含楼栋、房号、故障类型。如果报错先看错误码401 是 Key 问题超时是网络或timeout设置问题模型名错误是summary_model写错了。第二步日志核对。把config.logging.level改成debug重新运行观察请求耗时和响应状态。成功标志是日志里能看到POST https://taotoken.net/api/v1/messages返回 200耗时在timeout以内。如果耗时接近timeout说明网络慢或模型响应慢可以调大timeout或换轻量模型。第三步工单回写。把摘要结果写回工单表验证整条链路。假设工单表有summary字段云函数里这样写。async function handleTicket(ticketId, content) { const config loadConfig(); const prompt config.prompt.summary_template.replace({content}, content); const result await callModel(config, config.model.summary_model, prompt); const summary result.content[0].text.trim(); // 回写数据库 await db.collection(tickets).doc(ticketId).update({ data: { summary: summary, updated_at: new Date() }, }); return summary; }成功标志是小程序端刷新工单详情能看到 AI 生成的摘要。自动派单同理用dispatch_model和dispatch_template把返回的 JSON 解析后写入priority和trade字段。三步都通过说明配置和调用链跑通了。接下来是排障把最常见的三个错误定位路径讲清楚。5. 本篇常见错排查401、超时、模型名错误排障的核心是「先看错误码再看日志最后改配置」。三个高频错误逐个拆。401 未授权。表现是请求返回 401日志里提示鉴权失败。定位路径先确认api_key是否替换成功打印config.auth.api_key的前几位看是不是${TAOTOKEN_API_KEY}原样输出如果是说明环境变量没读到。再确认auth_prefix是不是Bearer注意末尾有空格少了空格也会 401。最后确认 Key 有没有过期或被删除去控制台 API Keys 页面核对。超时。表现是请求长时间无响应最后抛超时错误。定位路径先看timeout设置工单摘要建议 30 秒派单 15 秒设太小会误报。再看网络本地请求能通但云函数超时通常是云函数出口网络问题检查云函数所在区域的网络策略。最后看模型长文本用轻量模型会慢换summary_model试试。max_retries设 2 能在网络抖动时自动重试减少误报。模型名错误。表现是返回 404 或提示模型不存在。定位路径核对summary_model和dispatch_model的值必须和 TaoToken 支持的名称完全一致大小写、日期后缀都不能错。常见错误是把claude-sonnet-4-20250514写成claude-sonnet-4少了日期后缀。去接入文档里复制模型名不要手打。还有一个隐蔽的坑base_url末尾多了斜杠拼接后变成https://taotoken.net/api//v1/messages部分服务会返回 404。配置里保持base_url不带末尾斜杠拼接时自己加。提示排障时把logging.level改成debug能看到完整的请求 URL、请求头和响应体比猜快得多。定位到问题后改回info避免日志过多。如果 401 和超时都排除了但摘要质量差那是 prompt 问题不是配置问题。调整summary_template把要求写具体比如「保留楼栋、房号、故障类型不超过 50 字」。6. 跑通之后把配置骨架用起来配置骨架跑通一次后面就是复制和微调。物业工单系统的 AI 能力不止摘要和派单还可以做业主情绪识别、工单分类、知识库问答都是同一套配置换 prompt 和模型。长期做编码和 Agent 的话Coding Plan 里有更完整的工程化配置示例适合把多个 AI 能力串成工作流。验证模型效果时模型对话页面可以直接试 prompt不用每次改代码。接入过程中遇到鉴权或字段问题接入文档和 API Keys 页面是首选。回到开头那句话小程序没那么难难的是配置落地。config.toml这个骨架把 Key、通道、模型、prompt、日志集中管理排障时有据可查交接时一目了然。三步验证动作走完工单摘要和自动派单的调用链就通了。剩下的就是把它接到你现有的工单流程里。