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

在 GPT 中設定動作

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

更新日期:8 days ago

總覽

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

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

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

限制

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

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

建立動作

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

接著,你將設定你的 GPT 如何連線至外部 API 並加以使用。

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

驗證

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

可用選項:

  • 無: 不需要驗證

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

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

API 金鑰

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

  • Basic

  • Bearer

  • 自訂標頭

OAuth

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

  • 用戶端 ID用戶端密鑰

  • 授權 URLToken URL

  • 範圍 和 Token 交換方法

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

結構描述

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

  • 要呼叫哪個伺服器

  • 有哪些可用的端點

  • 它們接受哪些參數

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

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

新增結構描述

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

  • 直接貼到編輯器中

  • 從 URL 匯入

  • 從內建範例開始:

    • 天氣 (JSON)

    • 寵物商店 (YAML)

    • 空白範本

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

工作區限制(Enterprise 和 Edu)

如果你看到訊息:


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

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

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

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

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

隱私權和使用者控制項

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

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

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

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

其他說明

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

這篇文章有幫助嗎?