概覽
本文說明如何在 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 ID 和 Client Secret
Authorization URL 和 Token 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 控制和網域限制,請參閱:
