如需完整的文件索引,請參閱 llms.txt。在文件頁面的網址末尾加上 .md ,即可取得該頁面的 Markdown 版本。
主要導覽
主題

資料與連線

儲存記錄、連接應用程式,並為網站加入登入功能

你的網站可能需要儲存收到的請求、記錄使用者進度,或顯示來自已連接應用程式的資訊。告訴 ChatGPT 要儲存哪些資料、資料來自哪裡,以及誰可以存取。

選擇儲存與登入功能

建立新專案時,工作站可以使用建議的網站範本作為起點。如果是既有專案,請先讓 ChatGPT 確認專案能產生相容的部署產物,再要求部署。

說明網站要提供哪些功能,讓 ChatGPT 選擇所需的儲存與身分識別功能:

網站需求 可向工作站提出的要求
以內容為主的網站或到達網頁 只有在網站功能需要時,才持久儲存應用程式狀態
儲存記錄、使用者進度或遊戲分數 使用 D1 關聯式資料庫持久儲存結構化資料
圖片、文件、音訊、影片或其他上傳檔案 使用 R2 物件儲存服務存放檔案
上傳檔案並支援搜尋檔案的中繼資料 使用 D1 儲存中繼資料,使用 R2 儲存檔案內容
需要識別目前工作區使用者身分的內部網站 使用經工作區驗證的使用者身分
供公眾登入,或使用外部身分提供者 建立具備身分驗證功能的網站

像是選了哪個佈景主題或關閉了哪則橫幅,這類暫時的顯示狀態不需要持久儲存。如果使用者預期網站上線後會保留某些產品資料,就應要求持久儲存這些資料。

加入「使用 ChatGPT 登入」功能

公開網站可以開放所有人瀏覽,同時讓訪客選擇使用 ChatGPT 登入,以使用需要識別身分的功能,例如儲存進度、顯示個人化檢視畫面,或查看屬於特定使用者的記錄。僅限工作區成員存取的網站已使用 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 為你的網站產生權杖:

請為這個網站產生「使用 ChatGPT 登入」的略過登入權杖,讓我的服務無須透過瀏覽器登入就能呼叫網站。

智慧體會使用 generate_siwc_bypass_token,並傳回 siwc_bypass_bearer_token。產生新權杖會取代該網站現有的權杖,因此請將所有使用舊權杖的服務更新為使用新權杖。

請透過下列 HTTP 請求標頭傳送權杖:

OAI-Sites-Authorization: Bearer <siwc_bypass_bearer_token>

工作站會讀取並移除這個標頭,再將請求轉送至你的網站。如果網站還需要自己的 API 憑證,請另外透過標準的 Authorization 標頭傳送憑證。工作站會在轉送請求時保留這個標頭。

使用權杖略過登入的請求沒有已登入訪客的身分。這類請求不會包含上述已驗證使用者的標頭,也無法存取訪客已連接的應用程式。請在網站的伺服器端程式碼中執行其他必要的授權檢查。如果功能需要訪客身分或外掛程式權限,請使用一般登入流程。

請妥善保密權杖,因為任何持有權杖的人都能通過該網站的登入檢查。請將權杖存放在服務專用的機密儲存空間,避免將它寫入瀏覽器端程式碼、放入網址或納入版本控制。如果權杖外洩,請產生新權杖,並更新所有使用它的指令碼或服務。新權杖會立即生效,但在快取的設定到期前,舊權杖可能仍然有效,最長可達五分鐘。

透過外掛程式在網站載入使用者資料

在工作站中使用外掛程式建立網站,即可從每位訪客自己連接的應用程式載入資料。例如,在同一個議題儀表板上,你會看到指派給你的議題,團隊成員則會看到指派給他們的議題。每位訪客都使用 ChatGPT 登入,並自行選擇要授權網站使用哪些已連接的帳戶,以及要授予哪些存取權限。

工作區必須啟用外掛程式,且網站必須設為僅供該工作區使用。訪客必須是工作區成員,並以自己現有的應用程式權限存取資料。管理員可參閱在工作站中啟用外掛程式,瞭解各外掛程式的權限與租用戶限制。

建立使用已連接應用程式資料的網站

  1. 請 ChatGPT 工作或 Codex 建立網站。指明要使用哪個外掛程式連接器,以及它需要執行哪些操作,或先詢問有哪些外掛程式可用。
  2. 使用實際資料預覽網站。智慧體在建立和預覽網站時,會使用你可用的連線。
  3. 請智慧體將網站發布到你的工作區,並與團隊成員分享網站連結。

例如:

使用我已連接的議題追蹤工具建立網站,顯示指派給我的議題,並依優先順序分組。加入專案篩選器、各議題原始頁面的連結,以及「重新整理」按鈕。

你也可以建立文件搜尋工具,提供原始文件的連結,或建立專案總覽,彙整工單與訊息。

載入資料

載入頁面時,工作站會使用訪客的連線與權限,從已連接的應用程式讀取資料。工作站會管理快取並處理資料重新載入。如有需要,可以請 ChatGPT 工作或 Codex 加入手動重新整理功能。

依預設,當連接器傳回游標時,工作站會透過「載入更多」操作取得下一頁資料。

技術參考:探索外掛程式

工作站使用 getContext() 查詢外掛程式支援的操作。這個函式會傳回快取中的工具名稱、說明與結構描述,不會重新探索可用工具。

如需瞭解已連接的應用程式支援哪些操作,以及這些操作的適用範圍,請參閱說明中心的〈建立及使用 ChatGPT 工作站〉。

讓訪客選擇自己的連線

訪客要使用需要連線的功能時,會先使用 ChatGPT 登入,查看網站要求的應用程式存取權限,選擇要使用哪個已連接的帳戶及要授予哪些權限,再返回網站。分享網站不會讓其他人取得你已連接帳戶的存取權。網站會從每位訪客授權的應用程式取得資料。

訪客可以選擇不授予應用程式存取權並繼續使用網站,但需要該權限的功能將無法運作。如果某個應用程式無法使用,請確認該應用程式已在正確的工作區中連接,且工作區設定允許使用該應用程式。