探索ChatGPT,学习开发一款插件,成为先锋者,一同成长。加入「阿杰与AI」公众号,关注AI发展趋势,等待AI机会出现。
- 1.如何访问插件?
- 2.开发ChatGPT插件-介绍
- 3.开发ChatGPT插件-入门
- 4.开发ChatGPT插件-认证
- 5.开发ChatGPT插件-示例插件
- 6.开发ChatGPT插件-审核
- 7.开发ChatGPT插件-线上插件及常见问题
线上插件
速率限制
考虑对您公开的 API 端点实施速率限制。虽然目前规模有限,但 ChatGPT 被广泛使用,您应该会收到大量请求。您可以监控请求的数量并相应地设置限制。
超时
在插件体验期间进行 API 调用时,如果超过以下阈值,则会发生超时:
- 15 秒往返获取
ai-plugn.json
/openapi.yaml
- API 调用往返 45 秒
随着OpenAI将插件体验扩展到更多人,OpenAI预计超时阈值会降低。
更新你的插件
每次更改文件时,必须通过插件商店中的“开发您自己的插件”流程手动更新清单文件ai-plugin.json
。每次发出请求时,ChatGPT 都会自动获取最新的 OpenAPI 规范,因此所做的更改会立即传播给最终用户。
插件条款
要注册插件,您必须同意插件条款。
域验证和安全
为确保插件只能对它们控制的资源执行操作,OpenAI 对插件的清单和 API 规范强制执行要求。
定义插件的根域
清单文件定义了向用户显示的信息(如徽标和联系信息)以及托管插件的 OpenAPI 规范的 URL。获取清单时,将按照以下规则建立插件的根域:
- 如果该域有一个子域,那么根域将从托管清单的域中
www.
剥离出来。www.
- 否则,根域与托管清单的域相同。
关于重定向的注意事项:如果在解析清单时有任何重定向,则只允许子域重定向。唯一的例外是从 www 子域重定向到没有 www 的子域。
根域的示例:
-
✅
https://example.com/.well-known/ai-plugin.json
- 根域:
example.com
- 根域:
-
✅
h``ttps://www.example.com/.well-known/ai-plugin.json
- 根域:
example.com
- 根域:
-
✅
https://www.example.com/.well-known/ai-plugin.json
→ 重定向到https://example.com/.well-known/ai-plugin.json
- 根域:
example.com
- 根域:
-
✅
https://foo.example.com/.well-known/ai-plugin.js``on
→ 重定向到https://bar.foo.example.com/.well-known/ai-p``lugin.json
- 根域:
bar.foo.example.com
- 根域:
-
✅
https://foo.example.com/.well-known/ai-plugin.json
→ 重定向到https://bar.foo.example.com/baz/ai-plugin.json
- 根域:
bar.foo.example.com
- 根域:
-
❌
https://foo.example.com/.well-known/ai-plugin.json
→ 重定向到https://example.com/.well-known/ai-plugin.json
- 不允许重定向到父级域
-
❌
https://foo.example.com/.well-known/ai-plugin.json
→ 重定向到https://bar.example.com/.well-known/ai-plugin.json
- 不允许重定向到同一级别的子域
-
❌
https://example.com/.well-known/ai-plugin.json
-> 重定向到https://example2.com/.well-known/ai-plugin.json
- 不允许重定向到另一个域
清单验证
清单本身中的特定字段必须满足以下要求:
api.url
- 提供给 OpenAPI 规范的 URL 必须托管在同一级别或根域的子域中。legal_info
-提供的URL的二级域名必须与根域名的二级域名相同。contact_info
- 邮件地址的二级域名应与根域的二级域名相同。
解析 API 规范
清单中的字段api.url
提供了指向 OpenAPI 规范的链接,该规范定义了插件可以调用的 API。OpenAPI 允许指定多个服务器基础 URL。以下逻辑用于选择服务器 URL:
- 遍历服务器 URL 列表
- 使用与根域完全匹配或根域的子域的第一个服务器 URL
- 如果以上两种情况都不适用,则默认为托管 API 规范的域。例如,如果规范托管在 上
api.example.com
,则将api.example.com
用作 OpenAPI 规范中路由的基本 URL。
注意:请避免使用重定向来托管 API 规范和任何 API 端点,因为不能保证始终遵循重定向。
使用 TLS 和 HTTPS
插件的所有流量(例如,获取ai-plugin.json
文件、OpenAPI 规范、API 调用)必须在具有有效公共证书的端口 443 上使用 TLS 1.2 或更高版本。
IP 出口范围
ChatGPT 将从CIDR 块 中的 IP 地址调用您的插件23.102.140.112/28
。您可能希望将这些 IP 地址明确列入白名单。
另外,OpenAI 的网络浏览插件从不同的 IP 地址块访问网站23.98.142.176/28
: .
常问问题
如何使用插件数据?
插件将 ChatGPT 连接到外部应用程序。如果用户启用插件,ChatGPT 可能会将他们的部分对话和他们的国家或州发送到您的插件。
如果对我的 API 的请求失败会怎样?
如果 API 请求失败,模型可能会重试请求多达 10 次,然后才会让用户知道它无法从该插件获得响应。
我可以邀请人们试用我的插件吗?
是的,所有未经验证的插件都可以由最多 15 位具有插件访问权限的其他开发人员安装。
我可以为我的插件向人们收费吗?
是的,OpenAI鼓励您考虑有限数量的免费 API 调用,但要了解它需要资源来运行您的插件。
希望通过公众号「阿杰与AI」,能够帮助你了解AI产品,并可以解决一些生活和工作中问题。
我将分享有关AI的知识和实用建议,希望能够为你带来有价值的认知,一起探索发现AI的机会。