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

概覽

本文說明如何在 GPT 中設定動作，包括如何連接外部 API、定義 GPT 能做什麼，以及管理驗證、結構描述（schema）與工作區限制。

要設定動作，你需要欲連接服務的 API 詳細資訊，包括驗證資訊與 OpenAPI 結構描述。GPT 可以使用 apps 或 actions 其中之一，但無法同時使用兩者。

每個動作由兩個主要元件定義：GPT 如何向 API 進行驗證，以及定義 API 能做什麼的結構描述。

限制

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

Pro 模式不提供動作功能；建立含自訂動作的 GPT 時，該 GPT 只會提供 Instant 與 Thinking 模型供選擇。

建立動作

在 GPT 編輯器中，前往 Actions 區段並選取 Create new action。

接著你會設定你的 GPT 如何連接並使用外部 API。

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

驗證

驗證用來控制你的 GPT 如何連接外部 API。

可用選項：

None: 不需要驗證
API key: 使用秘密金鑰授權請求
OAuth: 使用使用者登入以取得基於帳戶的存取權

API key

伺服器對伺服器存取時請使用 API key 驗證。可設定為：

Basic
Bearer
Custom header

OAuth

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

Client ID 與 Client Secret
Authorization URL 與 Token URL
Scope 與權杖交換方法

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

結構描述

結構描述定義你的 API 能做什麼。它會告訴 ChatGPT：

要呼叫哪個伺服器
有哪些端點可用
可接受哪些參數
如何識別每個動作（operation IDs）

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

新增結構描述

你可以用三種方式新增結構描述：

直接貼到編輯器中
從 URL 匯入
從內建範例開始：
- 天氣（JSON）
- Pet Store（YAML）
- 空白範本

若結構描述有效，編輯器會顯示偵測到的動作；若無效，則會顯示驗證錯誤。

工作區限制（Enterprise 與 Edu）

如果你看到訊息：

“No domains are allowed by your workspace’s settings.”

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

管理員可允許所有網域，或將動作限制於核准的網域。
若不允許任何網域，你將無法使用動作。

如需關於動作與網域限制的工作區層級控管，請參閱：在 Enterprise 與 Edu 工作區中管理 GPT 存取權。

隱私與使用者控制

每個動作都可以包含隱私權政策 URL。
具有動作的公開 GPT（連結或 GPT Store）必須包含有效的隱私權政策 URL。
在執行前，系統可能會要求使用者核准動作。
對於 OAuth 動作，使用者可檢視並管理已連線的帳戶。

在 GPT 中設定動作

概覽

限制