外部 API：先验证一条最小请求
作者：Wattter ·
以最小可用请求验证接口、字段和权限，再把它放进 WorkBuddy 工作流。
API 文档看起来字段很多，第一次调用却只需要验证一件事，请求有没有按预期回来。别在第一步就把整条业务链绑上去。
先做最小请求，再扩展流程。接口不是魔法按钮，输入、输出、权限、异常，四样都要写清。
这一节做完，手里会有一份最小请求规格 + 一次成功与失败记录
先把这件事想明白
API 扩展的是可用模型或服务，不会自动补齐任务设计。密钥、网络、成本，也得写进任务约束。
把外部接口当成有边界的数据源，不是无限制的代理
- 接外部模型前先确认接口格式、计费方式、数据处理规则和调用限额
- 本地模型（如 Ollama，默认 11434 端口、OpenAI 兼容）能让数据不出本机、可离线、零 Token，但仍要评估机器扛不扛得住、结果好不好
- 密钥只存在受控设置里，绝不写进任务文本、截图或公开文件
现在跟着做
开始前，先准备这几样东西。
- 看服务的公开说明
- 备好最小测试数据
- 确认调用权限
材料就位后，按这个顺序走。
- 定义一个最小输入和期待的一个输出字段
- 先在低风险环境发一次请求
- 记下成功、空结果、失败三种返回
- 把重试次数、停止条件、人工接手方式写进流程
做到这儿，就可以先停
- 最小请求能拿到至少一条真实结果
- 失败返回能定位到参数或权限问题
- 密钥不进任务、截图、公开文件
换一件小事，再走一遍
给摘要任务，接一个自己的模型
第一次接外部模型，不用急着把真实资料接进去。拿一段不含敏感信息的短文，先测能不能调通、输出稳不稳、成本受不受得了。接本地模型时，资料可以不出本机。但能在本机跑，不等于结果已经能进正式流程。同一段材料比一次，差别会很清楚。
- 在设置里配一个受控的模型入口，别在任务里粘密钥
- 用同一段测试材料，比默认模型和新模型的摘要质量
- 记下输出格式、响应时间、失败信息
- 只有结果符合任务要求，才把这个模型加进特定任务模板
把这段话改成你自己的任务
先放进练习工作区。方括号里的内容，换成你手上那件小事。
输入：【最小字段】\n期待输出：【哪个字段】\n成功后：【下一步】\n失败后：【提示 / 停止 / 人工处理】\n密钥位置：【受控设置，不进正文】
卡住时，先看这里
- 认证失败还在跑。任务一直重试，没有清晰错误 通常是因为缺失败停止条件。 加「连续 N 次失败就停 + 告警」。
- 密钥意外外发。密钥出现在任务正文或日志里 通常是因为密钥被粘进了任务。 撤销密钥，在受控设置里重新注入。
还容易犯这几种错
- 没验证就批量调用
- 把密钥写进公开文本
- 把接口返回直接当事实
先停一下密钥不写进任务文本或截图；外部服务的数据留存按合规要求处理；不允许从外部接口直接写进内部关键系统。
留十分钟，做成自己的
写一份含输入、输出和失败处理的最小请求规格，跑通一次。
能力配齐了，下一步把稳定、低风险的任务转成自动化。
还有几个常见问题
这一页最先要准备什么？先看服务的公开说明。先做最小请求，再扩展流程。接口不是魔法按钮，输入、输出、权限、异常，四样都要写清。
做这一步时心里应该记住什么？接外部模型前先确认接口格式、计费方式、数据处理规则和调用限额
最容易卡在哪里？没验证就批量调用
完成这一页后，下一步怎么接？能力配齐了，下一步把稳定、低风险的任务转成自动化。