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

在 GPT 中設定動作

說明如何使用動作將你的 GPT 連接到外部 API,包括設定、驗證與結構描述(schema)設定。

更新日期:7 hours ago

我們計劃停用自訂 GPT,並協助建立者將工作流程移轉至外掛程式。外掛程式將可重複使用的指令、參考檔案和已連結的應用程式整合在一起。

受影響的 Enterprise 工作區已於 2026 年 10 月 26 日停止提供建立新 GPT 的功能。FedRAMP 工作區不受此次停止建立功能的影響,仍可建立 GPT。尚未移轉的現有 GPT,在各自適用的退役日期前仍可使用及編輯。移轉後,原始 GPT 會變成唯讀。一般停用日期訂於 2026 年 12 月 11 日。FedRAMP 工作區及符合資格且已獲准延期的工作區,停用日期為 2027 年 2 月 11 日。

此次轉換涵蓋所有 ChatGPT 方案,但建立限制與移轉功能的使用權限會因帳戶或工作區而異。請依照通知上的內容操作。如需瞭解日期、移轉步驟,以及其他方案將有哪些變更,請參閱:自訂 GPT 停用與移轉常見問答集。

總覽

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

若要設定動作,你需要取得要連線之服務的 API 詳細資料,包括驗證資訊和 OpenAPI 結構描述。GPT 可以使用應用程式或動作,但不能同時使用兩者。

每個動作由兩個主要元件定義:GPT 如何向 API 驗證,以及定義 API 可以執行哪些操作的結構描述。

限制

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

Pro 模式不提供動作。當你建立或編輯含有自訂動作的 GPT 時,模型選擇器只會顯示支援動作的非 Pro 模型。

遷移至外掛程式

將 GPT 遷移至外掛程式時,自訂動作不會自動轉移。在開始依賴外掛程式之前,請先設定並測試替代的整合功能。以下說明仍適用於你有權編輯、尚未遷移的現有 GPT。如需遷移指引,請參閱:自訂 GPT 停用與遷移常見問題。

建立動作

在 GPT 編輯器中,前往動作區段,然後選取建立新動作。

接著,你將設定 GPT 連接及使用外部 API 的方式。

設定動作後,請在預覽中測試,確認其運作符合預期。

驗證

驗證會控制你的 GPT 如何連線至外部 API。

可用選項:

  • 無: 不需要驗證

  • API 金鑰: 使用密鑰授權要求

  • OAuth: 使用使用者登入進行帳戶型存取

API 金鑰

對伺服器對伺服器存取,請使用 API 金鑰驗證。可設定為:

  • Basic

  • Bearer

  • 自訂標頭

OAuth

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

  • 用戶端 ID 和 用戶端密鑰

  • 授權 URL 和 Token URL

  • 範圍 和 Token 交換方法

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

結構描述

結構描述會定義你的 API 可以執行哪些操作。它會告訴 ChatGPT:

  • 要呼叫哪個伺服器

  • 有哪些可用的端點

  • 它們接受哪些參數

  • 每個動作如何識別(作業 ID)

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

新增結構描述

你可以透過三種方式新增結構描述:

  • 直接貼到編輯器中

  • 從 URL 匯入

  • 從內建範例開始:

    • 天氣 (JSON)

    • 寵物商店 (YAML)

    • 空白範本

如果結構描述有效,編輯器會顯示偵測到的動作。如果無效,系統會顯示驗證錯誤。

工作區限制(Enterprise 和 Edu)

如果你看到訊息:


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

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

  • 管理員可以允許所有網域,或將動作限制為已核准的網域。

  • 如果不允許任何網域,你就無法使用動作。

如需工作區層級的動作控制項和網域限制,請參閱:在 Enterprise 和 Edu 工作區中管理 GPT 存取權。

隱私權和使用者控制項

  • 每個動作都可以包含隱私權政策 URL。

  • 含有動作的公開 GPT(連結或 GPT 商店)必須包含有效的隱私權政策 URL。

  • 系統可能會要求使用者在動作執行前核准動作。

  • 對於 OAuth 動作,使用者可以檢視和管理已連線的帳戶。

其他說明

如需撰寫或偵錯動作的協助,請使用官方 ActionsGPT。

這篇文章有幫助嗎?