你的網站可能需要儲存收到的請求、記錄使用者進度,或顯示來自已連接應用程式的資訊。告訴 ChatGPT 要儲存哪些資料、資料來自哪裡,以及誰可以存取。
選擇儲存與登入功能
建立新專案時,工作站可以使用建議的網站範本作為起點。如果是既有專案,請先讓 ChatGPT 確認專案能產生相容的部署產物,再要求部署。
說明網站要提供哪些功能,讓 ChatGPT 選擇所需的儲存與身分識別功能:
| 網站需求 | 可向工作站提出的要求 |
|---|---|
| 以內容為主的網站或到達網頁 | 只有在網站功能需要時,才持久儲存應用程式狀態 |
| 儲存記錄、使用者進度或遊戲分數 | 使用 D1 關聯式資料庫持久儲存結構化資料 |
| 圖片、文件、音訊、影片或其他上傳檔案 | 使用 R2 物件儲存服務存放檔案 |
| 上傳檔案並支援搜尋檔案的中繼資料 | 使用 D1 儲存中繼資料,使用 R2 儲存檔案內容 |
| 需要識別目前工作區使用者身分的內部網站 | 使用經工作區驗證的使用者身分 |
| 供公眾登入,或使用外部身分提供者 | 建立具備身分驗證功能的網站 |
像是選了哪個佈景主題或關閉了哪則橫幅,這類暫時的顯示狀態不需要持久儲存。如果使用者預期網站上線後會保留某些產品資料,就應要求持久儲存這些資料。
加入「使用 ChatGPT 登入」功能
公開網站可以開放所有人瀏覽,同時讓訪客選擇使用 ChatGPT 登入,以使用需要識別身分的功能,例如儲存進度、顯示個人化檢視畫面,或查看屬於特定使用者的記錄。僅限工作區成員存取的網站已使用 ChatGPT 身分,依照分享設定控管存取權。
請工作站加入登入功能:
運作方式
工作站透過平台提供的路徑處理登入與登出流程,完成後會將訪客導回你的網站:
<a href="/signin-with-chatgpt">Sign in with ChatGPT</a>
<a href="/signout-with-chatgpt">Sign out</a>訪客登入後,工作站會透過下列請求標頭將訪客的身分資訊傳給伺服器:
oai-authenticated-user-email包含已驗證的電子郵件地址。oai-authenticated-user-full-name可能包含訪客在個人資料中設定的名稱。這個標頭可能不存在或值為空字串,沒有名稱時請改用電子郵件地址。
請在伺服器端程式碼中判斷存取權限,且不要依賴將姓氏和名字分開提供的標頭。
使用 SIWC 略過登入權杖呼叫私人網站
當指令碼或服務需要呼叫必須登入的網站時,可以使用「使用 ChatGPT 登入」(SIWC)的略過登入權杖。有了這個權杖,請求就能通過網站的登入檢查,無須建立互動式瀏覽器工作階段。
如果你是網站擁有者,可以請 ChatGPT 工作或 Codex 為你的網站產生權杖:
智慧體會使用 generate_siwc_bypass_token,並傳回 siwc_bypass_bearer_token。產生新權杖會取代該網站現有的權杖,因此請將所有使用舊權杖的服務更新為使用新權杖。
請透過下列 HTTP 請求標頭傳送權杖:
OAI-Sites-Authorization: Bearer <siwc_bypass_bearer_token>
工作站會讀取並移除這個標頭,再將請求轉送至你的網站。如果網站還需要自己的 API 憑證,請另外透過標準的 Authorization 標頭傳送憑證。工作站會在轉送請求時保留這個標頭。
使用權杖略過登入的請求沒有已登入訪客的身分。這類請求不會包含上述已驗證使用者的標頭,也無法存取訪客已連接的應用程式。請在網站的伺服器端程式碼中執行其他必要的授權檢查。如果功能需要訪客身分或外掛程式權限,請使用一般登入流程。
請妥善保密權杖,因為任何持有權杖的人都能通過該網站的登入檢查。請將權杖存放在服務專用的機密儲存空間,避免將它寫入瀏覽器端程式碼、放入網址或納入版本控制。如果權杖外洩,請產生新權杖,並更新所有使用它的指令碼或服務。新權杖會立即生效,但在快取的設定到期前,舊權杖可能仍然有效,最長可達五分鐘。
透過外掛程式在網站載入使用者資料
在工作站中使用外掛程式建立網站,即可從每位訪客自己連接的應用程式載入資料。例如,在同一個議題儀表板上,你會看到指派給你的議題,團隊成員則會看到指派給他們的議題。每位訪客都使用 ChatGPT 登入,並自行選擇要授權網站使用哪些已連接的帳戶,以及要授予哪些存取權限。
工作區必須啟用外掛程式,且網站必須設為僅供該工作區使用。訪客必須是工作區成員,並以自己現有的應用程式權限存取資料。管理員可參閱在工作站中啟用外掛程式,瞭解各外掛程式的權限與租用戶限制。
建立使用已連接應用程式資料的網站
- 請 ChatGPT 工作或 Codex 建立網站。指明要使用哪個外掛程式連接器,以及它需要執行哪些操作,或先詢問有哪些外掛程式可用。
- 使用實際資料預覽網站。智慧體在建立和預覽網站時,會使用你可用的連線。
- 請智慧體將網站發布到你的工作區,並與團隊成員分享網站連結。
例如:
你也可以建立文件搜尋工具,提供原始文件的連結,或建立專案總覽,彙整工單與訊息。
載入資料
載入頁面時,工作站會使用訪客的連線與權限,從已連接的應用程式讀取資料。工作站會管理快取並處理資料重新載入。如有需要,可以請 ChatGPT 工作或 Codex 加入手動重新整理功能。
依預設,當連接器傳回游標時,工作站會透過「載入更多」操作取得下一頁資料。
技術參考:探索外掛程式
工作站使用 getContext() 查詢外掛程式支援的操作。這個函式會傳回快取中的工具名稱、說明與結構描述,不會重新探索可用工具。
如需瞭解已連接的應用程式支援哪些操作,以及這些操作的適用範圍,請參閱說明中心的〈建立及使用 ChatGPT 工作站〉。
讓訪客選擇自己的連線
訪客要使用需要連線的功能時,會先使用 ChatGPT 登入,查看網站要求的應用程式存取權限,選擇要使用哪個已連接的帳戶及要授予哪些權限,再返回網站。分享網站不會讓其他人取得你已連接帳戶的存取權。網站會從每位訪客授權的應用程式取得資料。
訪客可以選擇不授予應用程式存取權並繼續使用網站,但需要該權限的功能將無法運作。如果某個應用程式無法使用,請確認該應用程式已在正確的工作區中連接,且工作區設定允許使用該應用程式。