在你的 GPT 中為用戶創建個性化體驗。本教程將向你展示如何使用 OAuth 來創建個人行程助手 GPT。
GPTs 非常適合深度自定義 ChatGPT 體驗以滿足特定用例。更好的是，它允許你直接使用 actions 與你的服務進行交互。
在本教程中，我們將向你展示如何使用 OAuth 在你的 GPTs 操作中驗證用戶。我們將構建一個個人行程助手，允許用戶直接在 GPT 中管理他們的事件。
最終的 GPT 會像這樣：
左邊是用戶與 GPT 的互動；右邊是展示用戶行程的網頁應用。這種方法還有更多可能性，例如：
本教程的結果和資源：
在底部點擊 創建新行動 按鈕。在新頁面中，有三個部分：
在本教程中，我們有一個預建的行程應用，其暴露了用於管理用戶行程的 REST API。你可以在 GitHub repo 中找到 OpenAPI 架構。
一旦你粘貼了架構，GPT 會自動識別端點並為你生成一個表格。你可以點擊 測試 按鈕來測試端點。
GPT 會要求你授權來執行 API 呼叫。點擊 允許 或 始終允許 按鈕以繼續。
如果你的端點需要驗證，你會看到如上的錯誤消息。當我們查看服務器日誌時，我們可以看到 GPT 發送了沒有任何驗證信息的請求。
ChatGPT 要求操作和驗證端點都在同一根域中。例如，如果你的操作端點是 https://api.example.com/，則驗證端點必須是類似 https://auth.example.com/ 的形式。
為了滿足這一要求，我們需要在 Logto Cloud 中配置自定義域名。登錄到 Logto Cloud 後，點擊左側的 設置 標籤，然後點擊頂部的 域名 標籤。
通常只需幾分鐘即可完成配置。完成後，你會看到自定義域名變為 使用中。
為了執行 OAuth 驗證，我們需要在 Logto Cloud 中創建一個應用。登入 Logto Cloud 後，點擊左側的 應用程序 標籤，然後點擊右上角的 創建應用程序 按鈕。
在新頁面中，點擊底部的 "不使用框架創建應用"。選擇 "傳統網絡" 作為應用程序類型，並為你的應用輸入名稱，例如 GPT 行程助手。然後點擊底部的 "創建應用程序"。
應用創建完成後，導航到 ENDPOINTS & CREDENTIALS 卡片（你可能需要稍微向下滾動）。點擊 顯示端點詳情 以展開信息。
現在，返回 GPT 行動頁面，點擊 驗證 部分，然後選擇 OAuth。表單欄目與 Logto Cloud 中的信息對應如下：
對於 作用域 欄目，輸入 openid offline_access; 對於 "令牌交換方法" 欄目，保持為默認值（POST 請求）。
最後，點擊底部的 保存 按鈕。
返回 GPT 配置頁面，現在你可以在 行動 部分下看到一個 回調 URL 欄目。
複製該 URL，然後返回到 Logto Cloud 應用頁面。將該 URL 粘貼到 重定向 URI 欄目。
現在，向下滾動到頁面的底部，切換打開 始終發行刷新令牌，以啟用 GPT 的刷新令牌支持。這可以幫助你的用戶在 GPT 中保持較長時間的登入狀態。
然後點擊底部的 保存 按鈕。
現在一切準備就緒，我們來測試 OAuth 流程，確保一切按照預期運行。返回 GPT 配置頁面，點擊我們創建的行動，然後點擊 listItems 端點（第一個）的 測試 按鈕。
預覽部分將提示你登入。點擊 用 [你的操作名稱] 登入 按鈕，然後完成 OAuth 流程。
你可以在 Logto Cloud 中自定義登入體驗，比如品牌化和登入方法。更多信息，請參閱 🎨 自定義登入體驗。
如果一切正常運行，你的後端服務器應該會在 Authorization 標頭中收到帶有訪問令牌的請求。在我們的例子中，後端服務器是行程應用。它將在響應體中返回用戶的行程：
令人驚訝的是，由於我們的 OpenAPI 架構足夠詳細，GPT 可以在沒有任何額外配置的情況下執行 API 呼叫。例如，如果你點擊 createItems 端點的 測試 按鈕，你會看到 GPT 為你生成請求正文（或根據其心情要求你提供缺少的信息）。
隨著 OAuth 流程的運行，我們現在可以在後端服務中驗證訪問令牌，以確保請求來自經過身份驗證的用戶。由於 Logto 是 OIDC 提供者，我們可以使用 Userinfo 端點 來驗證訪問令牌。該端點可以在 Logto Cloud 應用頁面中找到。
只需在 Authorization 標頭中帶有訪問令牌發送一個 GET 請求到該端點。如果訪問令牌有效，端點會在響應體中返回用戶的信息。以下是使用 Node.js 的示例：
你可以在 GitHub repo 中找到完整代碼。
你可能有自己行程應用，通過認證，你可以在不離開對話的情況下實時同步用戶的行程。要查看實時同步，你可以前往 網頁應用 並使用你在 演示 GPT 中使用的相同帳戶登入。
GPT 行動可以成為為你的用戶構建個性化體驗的強大工具。如果你有任何問題或反饋，請隨時加入我們的 Discord 服務器 進行討論。