在 GPTs 里怎么通过 Actions 添加第三方模型服务商接口,让自定义 GPT 真正调通外部模型?
GPTs 不能在模型下拉框里替换底层模型,只能通过 Actions 把第三方服务商的 HTTPS 接口挂成一个工具,由 GPT 判断何时调用;如果要求整段对话由第三方模型生成,这条路不成立,需要改用自建应用或支持自定义 Base URL 的客户端直连接口。
GPTs 不能在模型选择里替换底层模型,能做的只有通过 Actions 把第三方模型服务商的 HTTPS 接口挂成一个工具,由 GPT 判断何时调用;如果目标是让整段对话由第三方模型生成,这条路径不成立,应改用自建应用或支持自定义 Base URL 的客户端直接调用接口。
先要分清两条完全不同的路径。一条是工具调用,第三方模型以外部服务的形式存在,GPT 仍是对话主体,只负责决定什么时候把问题转出去、拿到结果后再组织成回答;另一条是替换主模型,GPTs 的模型选项只覆盖平台自有模型,没有填第三方 Base URL 的入口。搞混这两件事,会在配置页里反复找并不存在的设置项。
能用 Action 接入的前提,是第三方接口满足三个硬条件。第一,必须是公网可达的 HTTPS 地址,证书有效,自签证书和仅内网可访问的地址都不行;第二,请求体和响应体是结构化 JSON,能用 OpenAPI 3.1 描述清楚;第三,接口不需要调用方固定 IP 或额外客户端证书。如果服务商只给内网地址或要求 IP 白名单,就要在中间加一层自己控制的网关做转发,否则 Action 连握手都完成不了。
OpenAPI schema 的第一个关键点是 servers 里的 url 要写完整的 Base URL 域名部分,不要把路径也塞进去。paths 里再写具体的接口路径,operationId 用英文动词短语,方便模型在多个操作之间做选择。requestBody 里必须把 model、messages 这类字段显式列出并标注类型,不能只写一个 object 让模型自己猜。description 要写清楚“什么情况下应该调用这个接口”,这句话直接决定模型会不会在正确时机触发。
schema 结构要尽量扁平。oneOf、anyOf、多层嵌套的对象会让模型在生成参数时出错,表现为参数缺失或类型不对。稳妥做法是把参数收敛成几个平铺的字符串和数字字段,复杂结构放在服务端做二次组装。返回体也一样,只声明模型真正需要的字段,多余字段会让上下文变长、解析变慢。
鉴权方式要选对。GPTs 的 Actions 支持 API Key 放在 Header、Bearer 或 Query 里,也支持 OAuth。密钥保存在平台侧,不会以明文写进 schema,但仍建议用专门签发的子 Key,只开必要权限、设额度上限、可以随时吊销。不要拿主账号的根密钥直接填进去,一旦泄露影响面是整个账户。
响应形态是配置失败最常见的原因。Actions 面向的是一次性请求响应,不支持流式输出,服务商默认返回 SSE 流时会被当成一段不完整的文本,模型拿不到结构化结果。做法是在服务端封装一层,显式关闭 stream,把返回体裁剪成只含必要字段的 JSON。同时要注意响应超时由平台设定上限,具体数值以官方文档为准,第三方首字延迟高、推理时间长都会直接触发失败,长任务应改成异步加轮询,而不是死等一个响应。
模型标识不要交给用户输入。model 字段应当写死在 schema 的固定值里,或者干脆由服务端按场景映射,前端只传业务参数。让模型或用户自己填模型名,拼错一个字符就是 404 或参数错误,而且很难从报错信息里看出来。温度、最大输出长度这类参数给默认值并设上限,避免单次调用产生不可预期的消耗。
成本结构要按两次调用算。一次问答里,GPT 侧要做一次编排判断,第三方侧再做一次实际生成,两边都按 token 计费,延迟也是叠加的。这决定了它适合低频、需要外部特定模型能力的任务,比如翻译校验、行业术语解释、结构化抽取;不适合高频对话主链路,因为每次都要多绕一跳。
安全边界要提前想清楚。第三方接口返回的内容会作为工具结果进入上下文,等同于不可信输入,如果返回文本里带指令性语句,可能影响后续回答。服务端应只回传必要字段,避免把原始日志、错误堆栈整段返回。需要留存的是请求时间、模型名、token 数、请求 ID,用于对账和排查。同时数据会经过第三方服务商,涉及敏感信息时要先确认对方的数据处理条款。
调试顺序建议固定下来。先用命令行或接口工具把第三方接口单独打通,确认地址、密钥、请求体三件事都对;再在 Action 的预览面板里发一次请求,看实际发出去的 Header 和 Body 是否符合预期;最后才回到对话里测模型会不会在正确时机选中这个 operation。典型报错对应关系是,401 或 403 指向密钥与鉴权位置,404 指向路径拼接,415 指向 Content-Type,解析失败则多半是返回体不是纯 JSON。
如果最终诉求是完整体验第三方模型,而不是给 GPT 加一个外部能力,正确做法是绕开 GPTs。用自建页面或支持自定义接口地址的客户端,把 Base URL、模型 ID、密钥三项填进去直连,少一层编排,延迟和成本都更低,也不会受工具调用时机判断的影响。GPTs 的 Actions 解决的是“让自定义 GPT 借用外部能力”,不是“换一个脑子”。