在这个教程中,我们将引导你完成为 ChatGPT创建自定义插件的过程。 在本教程结束时,你将熟悉构建、记录插件并将其与 ChatGPT 集成的必要步骤,从而增强 AI 平台的功能并为用户提供其他功能。
推荐:用 NSDT场景设计器 快速搭建3D场景。
为 ChatGPT 创建插件包含如下内容:
设计API即应用程序接口按OpenAPI 规范编写API文档创建manifest清单文件测试和优化插件部署和维护插件通过遵循这些步骤并遵循最佳实践,可以创建一个有价值且高效的插件,为用户增强 ChatGPT 的功能。这里是OpenAI官方提供的插件示例。
1、构建 API
首先创建你的插件将使用的后端 API。 这可以是新的 API 或现有的 API。 确保你的 API 遵循 RESTful 约定并以 JSON 格式返回数据。
在这个例子中,我们将使用一个基本的 Python Flask 应用程序来创建一个简单的天气 API。 此 API 将有一个端点 /weather,它将城市名称作为参数并返回当前天气。
from flask import Flask, jsonify import requests app = Flask(__name__) @app.route(/weather, methods=[GET]) def get_weather(city): api_key = your_openweathermap_api_key url = fhttp://api.openweathermap.org/data/2.5/weather?q={city}&appid={api_key} response = requests.get(url) data = response.json() return jsonify(data) if __name__ == __main__: app.run()3、创建 OpenAPI 规范文档
OpenAPI 规范 (OAS) 是描述 API 的标准格式。 ChatGPT利用这个文档来了解可用端点、请求参数和预期响应。
你可以使用 YAML 或 JSON 文件创建 OpenAPI 规范。
确保包含有关 API 端点、参数和响应的描述性信息。 你可以使用 Swagger Editor 或 Postman 等工具来帮助生成和验证规范。
openapi: 3.0.0 info: title: Weather Plugin API version: 1.0.0 paths: /weather: get: summary: Get weather information for a given city parameters: - in: query name: city schema: type: string description: Name of the city required: true responses: 200: description: Current weather data content: application/json: schema: type: object3、创建插件manifest
插件清单是一个 JSON 文件,其中包含有关你的插件的基本元数据。
它包括插件的名称、描述、身份验证方法、API 规范 URL、徽标、联系信息等信息。
按照 ChatGPT 提供的清单模式,创建一个 ai-plugin.json 文件并将其托管在 API 的域中。
{ "name": "Weather Plugin", "description": "A plugin that provides weather information for a given city.", "api_spec_url": "https://yourdomain.com/openapi.yaml", "logo_url": "https://yourdomain.com/logo.png", "homepage": "https://yourdomain.com", "authentication": { "type": "none" } }4、测试和调试你的插件
要在本地测试你的插件,请在本地服务器上运行你的 API 并使用 ChatGPT 的界面安装插件。
使用“安装未经验证的插件”选项并将其指向你的本地 ai-plugin.json 文件。 对于远程测试,将你的 API 和清单文件部署到服务器,然后使用相同的方法安装插件。
要调试你的插件,可以使用 ChatGPT 界面中的“调试”面板。 此窗格显示对话的原始文本表示,包括插件调用和响应。
你可以识别模型与插件之间交互的任何问题,并对 API、OpenAPI 规范或清单文件进行必要的调整。
5、完善你的插件
通过改进 OpenAPI 规范和清单文件中的描述来迭代你的插件,以确保 ChatGPT 可以更有效地与你的插件交互。
测试不同的描述和说明,以找到模型理解和使用您的插件的最有效方式。
这里有一些性能优化的技巧,要优化插件的性能,请考虑以下技术:
减少响应负载大小——减少 API 响应的大小,只包含最相关和必要的信息。 这将帮助你的插件在 ChatGPT 的上下文限制内工作并提供更快的响应。缓存 API 响应:实施缓存机制以存储经常访问的 API 响应。 这可以减少 API 的负载并缩短用户的响应时间。优化 API 查询参数:在你的 API 中使用最有效的查询参数来减少正在处理和返回的数据量。 这有助于提高插件的性能并降低达到外部 API 强加的速率限制的可能性。6、部署你的插件
测试和改进插件后,将 API、OpenAPI 规范和清单文件的最终版本部署到可公开访问的服务器。 确保 ai-plugin.json 文件托管在服务器上的 /.well-known/ 路径。
7、分享你的插件
现在你的插件已部署,可以通过向其他人提供你的插件清单文件的 URL 来与他们共享它。 然后,他们可以使用 ChatGPT 界面安装你的插件并使用其应用程序。
8、维护你的插件
定期监控插件的性能和用户反馈,以确定任何问题或需要改进的地方。
使你的 API、OpenAPI 规范和清单文件与你对插件所做的任何更改或增强保持同步。 这可确保插件与 ChatGPT 保持兼容并继续为用户提供价值。
9、与时俱进
随时了解 ChatGPT 平台的任何更新或更改,因为它们可能会影响你的插件的功能。
请务必关注 ChatGPT 开发人员提供的新功能、改进和最佳实践,并相应地调整你的插件。
原文链接:
http://www.bimant.com/blog/chatgpt-plugin-dev-crash-course/
0 留言