如何使用第三方API构建一个OpenAI自定义GPT

教程

随着大型语言模型（LLM）的出现，对话式用户界面变得非常受欢迎。你只需询问你所寻求的内容，ChatGPT就会产生一个输出。此外，该模型可以响应你的命令或问题执行动作，并呈现给你结果。这开启了一个巨大的机会，构建一种新的界面，唯一输入就是用户的文字——无论是书写还是口头。

这真是太棒了，因为你可以想象到无限的可能性。我们需要的是让LLM尽可能多地访问复杂、现实世界的动作，然后它们可以适当地调用这些动作。这就是第三方API进入视野的地方。

平台API

选择任何受欢迎的互联网服务，想象一个可以调用该服务通常执行的任务的API。每个服务通常都提供了一个很好的图形用户界面（GUI）——要么作为Web应用要么作为移动应用——用户登录使用。但相反，如果用户只需要通过文本或音频命令向一个单一实体——LLM的命令接口——询问呢？你就不再需要其他的界面了。

这很有趣，因为你现在可以构建一个定制版的GPT，它知道如何非常好地执行某些动作，通过了解这些动作的存在而成为专家。它将用户的意图与期望的动作联系起来，并分享执行动作的结果（输出）。

OpenAPI YAML规范

在自定义 GPT 的场景中，这是通过使用他们的 OpenAPI 规范来注册任何第三方 API 实现的。例如，以下是一个 AI 室内设计平台的 OpenAPI 规范。该 API 允许您仅通过房间的照片创建新的室内设计。尽管该平台提供自己的网络应用程序，用户可以在其中上传房间照片并选择室内设计风格以生成新的室内设计，但您可以将此功能带到您的平台，通过将其作为自定义 GPT 部署。

让我们以这个 API 为例构建一个自定义 GPT。您可以使用 OpenAPI 规范登錄任何第三方 API。还有一些工具可以帮助您为您的平台 API 构建 OpenAPI 规范。我相信这是将您的 API 分发到更广泛平台的一个很好的方法。

获取平台 API

大多数 SaaS 平台都提供它们的 API，以便开发者可以构建他们的应用程序。它们还发布 OpenAPI 规范。下载规范。这是一个 YAML 文件，看起来像：

YAML

openapi: 3.1.0
info:
  title: Decor8AI Virtual Staging & Interior Design API
  version: "1.0"
  description: >
    Decor8 AI is a state-of-the-art virtual staging solution designed for realtors and real estate app developers. It provides a suite of customization options to create and visualize appealing interiors from empty spaces. With its focus on enhancing marketability, it's an essential tool for showcasing property potential in a compelling way.
    Please reach out to [Decor8 AI Team](mailto:[email protected]) with questions or suggestions.

    Additional license information can be found [here](https://github.com/immex-tech/decor8ai-sdk/blob/main/API_LICENSE_NOTICE).

    ### 入门

    - **Authentication**: Each API request requires two headers:
      - `Content-Type: application/json`
      - `Authorization: Bearer `

    - **API Key**: Get your `` from your account at [prod-app.decor8.ai](https://prod-app.decor8.ai).
  
    ### 登录到 [Decor8 AI](https://prod-app.decor8.ai) 并从左侧菜单中点击 API

    ![](https://github.com/immex-tech/decor8ai-sdk/blob/main/media/step_1.jpg?raw=true)

    ### 点击生成 API 密钥
    ![](https://github.com/immex-tech/decor8ai-sdk/blob/main/media/step_2.jpg?raw=true)

    ### 测试 AI 密钥 
    Once you have the key, run simple curl command to test the key.

    ```
    curl -X GET "https://api.decor8.ai/speak_friend_and_enter" -H "Authorization: Bearer "
    ``` 

  license:
    name: Decor8AI SDK License
    url: https://github.com/immex-tech/decor8ai-sdk/blob/main/LICENSE
servers:
  - url: https://api.decor8.ai
    description: Base API URL for all endpoints.

注意：这不是一个完整的 OpenAPI 规范，只是一些文件的行，以给您一个大概的印象。

开放AI自定义GPT

创建开放AI的自定义GPT需要一个开放AI的订阅。前往https://chat.openai.com/，然后点击页面右上角你的个人资料图片。

点击“我的GPT”菜单。在这里，我们将创建一个新的自定义GPT（我已经创建了一个自定义GPT，所以你已经在页面上看到了它。）

点击“创建GPT”。接下来，你将看到一个表单，用于定义这个自定义GPT的属性。

点击“配置”标签。

提供标志、名称、描述和初始指导。

在指导中，定义地面规则非常重要。例如，你可能希望定义当用户询问GPT不擅长的问题时，GPT应该怎么做。GPT可以说“我不知道”，或者让用户知道它能为他们做什么。这有助于正确设置用户的期望。

滚动到“操作”部分。

操作是GPT在满足某些条件时知道“如何调用”的方式。每个API调用都可以成为一个操作。这里需要我们之前下载的OpenAPI规范YAML文件。

认证：选择API密钥

选择认证类型：Bearer

获取API密钥

通常，每个平台 API 都提供一种涉及使用 API 密钥的身份验证方法。通过登录该平台获取密钥。例如，对于 Decor8 AI，登录 https://prod-app.decor8.ai 并点击 API 菜单。在这里，您可以创建一个 API 密钥。将密钥复制粘贴到 Authentication 弹出窗口中。

接下来，将 OpenAPI 规范的 YAML 文件内容复制粘贴到“Schema”文本框中。

如果规范格式良好，您将看到规范中描述的 API 调用列表。您现在可以单独测试它们。如果点击“Test”按钮，它将尝试使用规范中描述的正确输入参数调用 API。如果需要获取输入参数的值，它会询问您。

在 Decor8 AI API 的情况下，让我们测试“checkAuthentication” API（GPT 本身不需要）。成功调用意味着 Custom GPT 和目标平台（在此情况下为 Decor8 AI）之间的一切都已正确设置。

您可以逐一测试剩余的 API，以确保 GPT 正确理解了这些操作。您需要验证的是当执行操作时，如果没有提供所需的输入，GPT 是否会向您询问额外的输入。这是 Custom GPT 最有趣的部分：它“知道”如何调用 API 并根据规范构建输入参数，如果缺少任何输入，会询问用户。这就是对话用户界面的样子：