OpenAI文档翻译——插件模式是怎么个事

概述

OpenAI插件可将ChatGPT连接到第三方应用程序。这些插件让ChatGPT能够与开发人员定义的API进行交互，进一步提升了ChatGPT的功能，使其能够执行更广泛的操作。插件的作用是让ChatGPT能够完成以下操作：

1. 检索实时信息;例如，体育比赛比分、股票价格、最新消息等
2. 检索知识库信息;例如，公司文件、个人笔记等
3. 协助用户进行操作;例如，订机票，点餐等

插件目前还处于开发阶段所以你可能还访问不到，如果您想获得开发人员访问权限，请加入等候名单。在测试期间，我们将与用户和开发人员密切合作，不断迭代插件系统，这可能会导致重大变化。若你希望在阅读文档的同时，能够运行实例并深入了解插件相关知识，我们推荐你从插件快速入门库入手。

插件开发人员通过公开一个或多个API端点，并附带一个符合OpenAPI标准的清单文件。这些定义了插件的功能，允许ChatGPT使用这些文件并调用开发人员定义的api。AI模型作为智能API调用者，根据API规范和自然语言描述来主动调用API执行操作。例如，当用户询问“在巴黎住几晚最好呢？”时，模型可能会调用酒店预订插件API，获取API响应，并结合API数据和自然语言功能生成用户友好的答案。随着时间的推移我们相应模型将会能够适应更多的场景，实现更好的推荐。

插件开发流程

理解端到端的流程对于构建插件是重要的：

（1）创建一个清单文件，并将其托管在 yourdomain.com/.well-known/ai-plugin.json

• • 该文件包含插件元数据（如名称、logo等）、身份验证详细信息（如auth类型、OAuth url等）以及您想公开的端点的OpenAPI规范
  • 该模型将看到OpenAPI描述字段，该字段可用于为不同的字段提供自然语言描述
  • 我们建议在开头只暴露1-2个端点，并使用最少数量的参数来最小化文本的长度。插件描述、API请求和API响应都被插入到与ChatGPT的对话中。这增加了上下文会话的令牌数量，违反了模型的上下文限制

（2）在GPT官网登记你的插件

• • 从顶部的下拉菜单中选择插件模型，然后选择“Plugins”，“plugin Store”，最后选择“开发自己的插件”
  • 如果需要身份验证，则提供OAuth 2 client_id和client_secret或API密钥

（3）激活插件

• • 用户必须在ChatGPT用户界面中手动激活插件。(ChatGPT默认不会使用你的插件)
  • 您将能够与15个其他用户共享您的插件(只有其他开发人员可以安装未经验证的插件)
  • 如果需要OAuth，用户将通过OAuth重定向到您的插件登录

(4)开始使用插件的会话

• • OpenAI将在ChatGPT的消息中嵌入插件的简洁描述，用户不会看到任何额外的解释。这些描述将包括插件的功能、端点和示例
  • 当用户提出相关问题时，模型可能会从你的插件调用API，以满足用户需求,对于POST请求，我们要求开发人员构建用户确认流程，以避免误操作(这里的意思应该是对于那种会引擎数据改动的接口需要用户确认，现在流行的REST编程风格中POST请求将被看做是对数据库的insert操作)
  • 模型会把API调用结果合并到对用户的响应中
  • 模型可能在其响应中包含从API调用返回的链接，这些信息将被用来展示给用户(使用OpenGraph协议，会提取site_name, title, description, image和url字段)
  • 模型还可以将从你API获取的数据转换为markdown形式的,从而获取一个更好的展现效果

目前，我们将在Plugin对话头中发送用户的国家和地区信息(例如，如果你在加利福尼亚，它就会是{"openai-subdivision-1-iso-code": "US-CA"})。这对购物、餐馆、天气等都很有用,您可以在我们的开发人员使用条款中阅读更多内容