OpenAI
此頁面由機器翻譯。查看原文英文文章

設定 GPT 中的 actions

如何使用 actions 將 GPT 連接至外部 API,包括設定、驗證及結構定義配置。

更新日期:12 days ago

概覽

本文說明如何在 GPT 中設定 actions,包括如何連接至外部 API、定義 GPT 可執行的操作,以及管理驗證、結構定義和工作區限制。

如要設定 action,你需要備妥想連接服務的 API 詳細資料,包括驗證資訊及 OpenAPI 結構定義。GPT 可以使用 apps 或 actions,但不能同時使用兩者。

每個 action 由兩個主要部分定義:GPT 如何與 API 進行驗證,以及一個定義 API 可執行內容的結構定義。

限制

如果你的工作區允許零個 action 網域,GPT 自訂 actions 將無法執行,因為沒有 action 網域能通過允許清單檢查。這不一定表示所有 GPT 可見性或存取權都被封鎖。

Pro mode 不支援 actions;建立包含自訂 actions 的 GPT 時,其中只會提供 Instant 和 Thinking 模型供選擇。

建立 action

在 GPT 編輯器中,前往 Actions 部分,然後選擇 Create new action

之後你將設定 GPT 如何連接及使用外部 API。

設定 action 後,請在 Preview 中測試,以確認其行為符合預期。

驗證

驗證控制 GPT 如何連接至外部 API。

可用選項:

  • None: 不需要驗證

  • API key: 使用密鑰授權請求

  • OAuth: 使用使用者登入以進行基於帳戶的存取

API key

伺服器對伺服器存取請使用 API key 驗證。可配置為:

  • Basic

  • Bearer

  • Custom header

OAuth

當 actions 需要使用者帳戶時,請使用 OAuth。OAuth 需要:

  • Client IDClient Secret

  • Authorization URLToken URL

  • Scope 及 token 交換方法

編輯器會提供回呼 URL 以完成 OAuth 流程。

結構定義

結構定義會定義你的 API 可執行的內容。它會告訴 ChatGPT:

  • 要呼叫哪個伺服器

  • 有哪些端點可用

  • 它們接受哪些參數

  • 如何識別每個 action(operation ID)

結構定義必須以 JSON 或 YAML 格式的 OpenAPI 規格提供。

加入結構定義

你可用三種方式加入結構定義:

  • 直接貼到編輯器中

  • 從 URL 匯入

  • 從內建範例開始:

    • Weather (JSON)

    • Pet Store (YAML)

    • 空白範本

如果結構定義有效,編輯器會顯示偵測到的 actions。如屬無效,則會顯示驗證錯誤。

工作區限制(Enterprise 和 Edu)

如果你看見以下訊息:

「你的工作區設定不允許任何網域。」

這表示 actions 受到你的工作區設定限制。

  • 管理員可允許所有網域,或將 actions 限制於已核准的網域。

  • 如果不允許任何網域,你便無法使用 actions。

如要了解工作區層級的 actions 控制和網域限制,請參閱:

這篇文章對你有幫助嗎?