概覽

本文說明如何在 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 和 用戶端密鑰

• 授權 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。