OpenAI GPT Actions 示例库

用途

对 API 开发者而言，配置 GPT Actions 通常比从零开发一套调用相同 API 的完整应用省事得多，但要让 Actions 真正运行起来，仍需完成一些设置。GPT Actions 示例库为常见应用的 Actions 集成提供指导。

入门

如果此前没有构建过 Action，请先阅读入门指南，了解其工作方式。

本指南主要面向熟悉 API 调用的开发者。需要调试帮助时，可以向 ChatGPT 说明问题，并附上截图。

如何查找示例

OpenAI Cookbook 的相关目录收录了第三方应用和中间件应用的示例。

直接集成第三方服务的 Actions 示例

GPT Actions 可以直接集成 HTTP 服务。直接使用 SaaS API 的 Action 会直接向 SaaS 提供商进行认证并请求资源，例如 Google Drive 或 Snowflake。

使用中间件的 Actions 示例

中间件可以为 GPT Actions 提供预处理、数据格式转换、数据过滤，以及连接未通过 HTTP 暴露的端点（例如数据库）等能力。示例库提供了多条实现路径，包括 Azure、GCP 和 AWS。

提供反馈

如果希望优先支持某种集成，或发现现有集成存在错误，可到对应 Cookbook 页面的 GitHub 仓库提交 PR 或 Issue，供维护者查看。

向示例库贡献内容

希望贡献示例时，请按以下指南编写，再在 GitHub 提交 PR 供审核。整体结构可参考这个 GPT Action 示例。

应包括以下部分：

• 应用信息：介绍第三方应用，提供官网及 API 文档链接。
• 自定义 GPT 指令：给出需要放入自定义 GPT 的完整指令。
• OpenAPI Schema：给出需要放入 GPT Action 的完整 OpenAPI 描述。
• 认证说明：OAuth 集成应列出准确的授权 URL、令牌 URL、作用域等配置项；说明如何在应用中登记回调 URL，以及其他必要步骤。
• 常见问题与排错：说明常见陷阱及应对方法。

使用边界

示例库用于指导你与第三方服务交互，OpenAI 无法控制这些服务。第三方可能调整 API 设置或配置，因此 OpenAI 无法保证这些 Action 永久可用。请将示例作为起点。

本指南面向熟悉编写 API 调用的开发者；没有相关技术基础的用户可能会觉得这些步骤较难。