如何使用第三方的API建立一個 OpenAI 自訂 GPT

隨著大型語言模型(LLM)的出現,對話式使用者介面變得非常流行。你只需詢問你在尋找什麼,ChatGPT 就會產生輸出。此外,該模型可以根據你的指令或問題執行動作並向你呈現結果。這開啟了一個巨大的機會來構建一種新型介面,其中唯一的輸入是使用者的文字——書面或口頭的。

這真是太棒了,你可以想像無限的可能性。我們需要的是讓 LLM 能夠訪問儘可能多的複雜、現實世界中的動作,然後它們可以適當地調用。這就是第三方 API 發揮作用的地方。

平台 API

選擇任何流行的網路服務,並想像一個 API 來調用它以執行該服務通常執行的任務。每個服務通常提供一個漂亮的圖形使用者介面(GUI)——無論是作為網頁應用程式還是移動應用程式——用戶登錄以使用它。但相反,如果用戶只需通過文字或語音命令向單一實體——LLM 的指令介面——詢問呢?你將不需要任何其他介面。

這很有趣,因為現在你可以構建一個自定義版本的 GPT,它非常擅長執行某些動作,通過意識到這些動作的存在而成為專家。它將使用者的意圖與所需的動作聯繫起來,並分享所執行動作的結果(輸出)。

OpenAPI YAML 規範

在 Custom GPT 的情況下,這是通過註冊任何第三方 API 並使用其 OpenAPI 規格來實現的。例如,以下是一個 AI 室內設計平台 的 OpenAPI 規格。這個 API 允許您只用房間的照片來創建新的室內設計。雖然該平台提供自己的網絡應用程序,用戶可以上傳房間照片並選擇室內設計風格來生成新的室內設計,但您可以通過部署為自定義 GPT將此功能带到您的平台。

讓我們以此 API 作為示例建立一個自定義 GPT。您可以上線任何第三方 API 並使用其 OpenAPI 規格。还有一些工具可供使用,它們將幫助您為自己的平台 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) 並點擊左側菜單中的 APIs

    ![](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

您需要一個 Open AI 訂閱才能創建一個 Custom GPT。前往 https://chat.openai.com/ 並點擊頁面上方右角落的个人资料图片。

點擊 “My GPTs” 菜單。在此處,我們將創建一个新的 Custom GPT(我已經創建了一个 Custom GPT,因此您已在這頁上看到它。)

點擊 “Create a GPT”。您將看到一個表单,用來定義這個 Custom GPT 的屬性。

點擊 “Configure” 標籤。

提供 Logo, Name, Description, 和初始指示。

在指示中,定義基礎規則非常重要。例如,您可能希望定義當用戶問及超出 GPT 專業知識範圍的問題時 GPT 應該怎么做。GPT 可以说 “我不知道”,或者讓用戶知道它能为他們做什么。這對於設定正確的用戶期望非常有幫助。

滚动到 “Actions” 部分。

动作是 GPT 知曉在滿足某些條件時“要做什麼”的方式。每個 API 調用 都可以成为一个动作。我們需要的就是之前下載的 OpenAPI spec YAML 文件。

  • 认证:選擇 API Key

  • 選擇 认证类型Bearer

獲取 API Key

通常每個平台API都提供一種認證方式,涉及使用API金鑰。通過登錄該平台來獲取金鑰。例如,在Decor8 AI的情況下,登錄https://prod-app.decor8.ai並點擊APIs菜單。這裡可以創建一個API金鑰。將金鑰複製粘貼到认证弹出窗口中。

接下來,將OpenAPI规格的YAML文件內容複製粘贴到”架构”文字框下。

如果规格格式正確,您將看到规格中描述的API調用列表。現在您可以单个测试它们。如果您點擊”测试”按鈕,它將嘗試使用规格中描述的正确输入参数调用API。如果它需要获取输入参数的值,它將向您询问。

在Decor8 AI API的情況下,讓我們測試”checkAuthentication” API(對於GPT本身是不需要的)。它的成功调用以意味著 Custom GPT 和目標平台(在此例中為 Decor8 AI)之間的設定都是正確的。

您可以逐一測試剩餘的API,以確保GPT正確理解了操作。您要核實的是,當GPT在执行操作時沒有提供時,它是否会向您询问額外输入。這是Custom GPT最有趣的部分:它“知道”如何調用API並根據规格構建输入参数,如果任何输入缺失,請求用戶。這是對話用戶界面的样子:

以下是我要求它為卧房設計一個 farmhouse 风格的室內設計。這是為了呼叫一個 API,這個 API 能夠根據給定的房間照片、房間類型和設計風格生成新的室內設計並回傳一幅圖像。

以下是空房間的原始照片(來自上面截圖中提到的 URL):

如果點擊“查看 Farmhouse 臥室設計”,我們會看到:

現在,您可以測試其他 API 以確保一切都能如您预期的那样運作。

創建並發布自訂 GPT

請確保仔細查看這個自訂 GPT 的所有屬性。以下是我為我的自訂 GPT 設定的一些配置屬性示例,我觉得它已經準備好發布了。

在右上角點擊“創建”或“更新”按鈕,您的 GPT 就能在互聯網上運作。

例如,我的自訂 GPT現在已經上線了。(您需要登錄 OpenAI 才能訪問。)

结语!

使用像 Decor8 AI 這樣的第三方 API 建立自訂 GPT 是相当直接的。您可以建立自己的 GPT 並添加最优秀的平台。這將使您的 GPT 變得更加先進和複雜,能夠進行很多有益的活动。

希望您喜歡這篇教程,如果您有任何問題或反饋,请在评论区留下您的留言。

Source:
https://dzone.com/articles/how-to-build-an-openai-custom-gpt-with-3rd-party-api