廣告位招商中 歡迎洽談

如何在 HuggingChat 中設定資料共享、對話紀錄保留與 Hugging Face API 權杖

365Finds Editorial
已收錄 11,430 篇 Wiki 文章

讓你的 AI 用上 365 Wiki

複製下方的提示詞,貼給你常用的 AI,然後直接提問。

下載完整版 Skill

先用提示詞體驗;經常使用時,安裝完整版 365Wiki Skill,以後無需重複複製。沒有常用 AI?Gemini、Microsoft Copilot 等網頁版也可以。

365Wiki Skill

對於注重資料隱私與合規要求的用戶及開發者而言,HuggingChat 憑藉其開源可審計架構、透明的資料邊界以及高度自主的底層控制能力,成為商業封閉式聊天服務之外的重要開源替代方案。HuggingChat 以開源前端引擎 chat-ui 為核心,其運行於 huggingface.co/chat 的官方託管服務遵循「隱私優先設計」(privacy by design)原則,預設既不向第三方模型開發者提供對話用於模型訓練,亦不會將對話內容用於商業廣告畫像追蹤。

不論是用於日常專業調研,抑或為團隊建立私有化推理聊天系統,全面理解資料共享機制、對話歷史留存週期以及 Hugging Face API 存取權杖(Access Tokens)的配置步驟,都是確保機密資料安全並順利存取受限(gated)模型的關鍵工作。


一、資料共享政策與隱私架構深入分析

評估 HuggingChat 的隱私安全性時,需區分官方雲端平台與自託管私有實例兩大情境。

預設隱私基準

Hugging Face 對 HuggingChat 的資料處理原則有著明確界定:

資料共享開關控制

在 chat-ui 開源專案與客製化部署架構中,管理員可透過設定環境變數 PUBLIC_APP_DATA_SHARING=1,在使用者介面中開啟「向模型創作者共享資料」的切換開關。若未宣告該變數或設定為 0,前端介面將完全停用任何共享管道,所有對話數據嚴格封裝於本地會話與所屬資料庫中。

聯網搜尋(Web Search)的資料外洩隱患

HuggingChat 的提示詞輸入欄具備選配的「聯網搜尋」功能。啟用後,系統會自動解析提問內容提取關鍵詞,並呼叫整合的搜尋引擎(如 Serper 或 Exa)抓取網路參考資料。若提問中包含敏感的專有程式碼、內部網域名稱或商業機密,請在送出前關閉聯網搜尋,避免機密語彙隨搜尋請求被外部搜尋服務記錄或索引。

公開分享連結的安全規範

HuggingChat 支援透過「Share」功能產生對話分享網址,此動作會將該次對話的靜態快照發布至公開網路。處理公司機密或內部技術文檔時,團隊內部應明定嚴禁建立公開分享連結。若不慎建立了分享網址,只要在左側欄位中刪除原始對話,對應的公開分享快照亦會立即失效。


二、對話歷史紀錄的保存週期與清除機制

HuggingChat 提供了從免登入訪客模式到資料庫硬刪除的多元保留管理方案。

訪客模式(無帳號無痕作業)

使用者無須註冊或登入 Hugging Face 帳號即可直接與模型對話:

單筆對話的精確刪除

登入帳號後,過去的對話清單會完整顯示於左側側邊欄:

  1. 將滑鼠游標移至側邊欄中欲移除的對話標題。
  2. 點擊標題旁的選項圖示(...)或垃圾桶圖示。
  3. 於提示視窗確認執行刪除。

在後端架構中,HuggingChat 執行的是物理硬刪除(Hard Delete),對話資料會直接從 MongoDB 資料庫中徹底抹除,不保留任何軟刪除標記或 30 天回收緩衝期。

帳號歷史紀錄全數清空

若需一次性清除帳號底下的所有累積會話:

  1. 點擊畫面左下角的齒輪圖示開啟 Settings(設定)。
  2. 切換至資料控制(Data Controls)或對話管理選項。
  3. 點選 Delete all conversations(刪除所有對話)並確認操作。

此步驟將立即從資料庫中刪除該 Hugging Face 使用者 ID 名下的所有歷史會話、外掛呼叫結果與自訂助理設定。


三、配置 Hugging Face API 權杖與取得受限模型存取權

配置 API 權杖讓開發者能夠調用 Hugging Face 強大的推論生態系,並在私有架構中解鎖受限權重模型與 MCP 進階工具。

在官方網頁介面解鎖受限模型(Gated Models)

諸如 Meta Llama 3 等開源頂級模型在 Hugging Face Hub 上通常設定為受限存取模式(Gated Model),使用者必須先完成授權申請方可使用:

  1. 登入個人的 Hugging Face 帳號。
  2. 前往受限模型的官方儲存庫頁面(例如 meta-llama/Meta-Llama-3-70B-Instruct)。
  3. 填寫核准表單並同意社群授權協議條款。
  4. 重新返回 HuggingChat。由於 HuggingChat 整合了帳號認證狀態,系統會自動核發權限,該模型即會直接出現在下拉切換選單中,無需於瀏覽器端手動填寫 API 權杖。

MCP 工具的權杖轉發機制(Token Forwarding)

HuggingChat 支援模型上下文協定(Model Context Protocol,MCP),讓模型能夠執行外掛工具與讀取儲存庫資料:

  1. 進入 Settings -> MCP Servers。
  2. 新增自訂 MCP 伺服器的連線端點網址。
  3. 在企業內部工作流中,可設定 MCP_FORWARD_HF_USER_TOKEN=true。此設定將安全地把當前使用者的 Hugging Face 權杖轉發給經授權的 MCP 服務,使其得以直接存取私有 Dataset 與專案,避免於伺服器全域寫死管理員憑證。

私有化架設 Chat UI 與 HF_TOKEN 環境變數設定

若企業追求極致的資料主權與網路隔離,建議以 chat-ui 原始碼建立獨立伺服器:

步驟 1:建立最小權限 Access Token

  1. 前往 Hugging Face Settings > Access Tokens。
  2. 點擊 Create new token。
  3. 角色務必選擇 Read(或設定僅限推論應用的 Fine-grained 細粒度權杖),絕對不要將含有 Write 或 Admin 高權限的權杖設定於前端介面。
  4. 複製以 hf_ 開頭的權杖字串。

步驟 2:設定 .env.local 檔案

在專案目錄下編輯環境變數檔案:

# Hugging Face 推論服務端點
OPENAI_BASE_URL=https://router.huggingface.co/v1

# 推論認證權杖(填入個人 Read 權杖)
OPENAI_API_KEY=hf_your_read_token_here

# 啟用使用者權杖轉發(搭配 OpenID 登入時,由每位使用者個別負擔推論配額與權限驗證)
USE_USER_TOKEN=true

# 專用本地 MongoDB 連線,保障對話留存週期完全自主掌控
MONGODB_URL=mongodb://localhost:27017
MONGODB_DB_NAME=chat-ui-private

# 明確關閉外部數據共享功能
PUBLIC_APP_DATA_SHARING=0

步驟 3:啟動私有服務

docker run -d -p 27017:27017 --name mongo-chatui mongo:latest
npm install
npm run dev

四、隱私等級與部署配置對照表

模式與方案隱私防護層級資料保留方式Hugging Face 權杖需求最合適的使用情境
網頁訪客模式高(純匿名操作)僅保留於瀏覽器 Cookie,關閉分頁即清空不需要零痕跡查詢單次敏感問題
網頁登入模式中等(日常平衡)持久保留於雲端 MongoDB,支援單則或全數硬刪除不需要(自動繼承帳號授權)日常研發工作,需要跨裝置同步紀錄
受限模型調用中等(合規授權)保留於雲端 MongoDB,受模型許可協議約束需至模型頁面簽署授權協議評估與實測 Llama 3 等指標型開源模型
自建 chat-ui最高(支援隔離斷網)自管 MongoDB,支援設定 TTL 自動銷毀機制需配置只讀 hf_ 權杖或本地端點涉及商業機密、醫療或金融法規之內部系統

五、最高等級隱私實務指引

  1. 細讀受限模型授權條款: 簽署受限模型存取協議即具備法律約束力,涉及重大專利或營業秘密之輸入內容,應確認是否符合條款限制。
  2. 貫徹最小權限權杖原則: 設定任何 HF_TOKEN 或 OPENAI_API_KEY 時,僅開放 Read 權限,避免金鑰洩漏導致儲存庫被篡改。
  3. 建立資料庫自動清除機制: 於自建 MongoDB 中的 conversations 集合建立 TTL 索引(例如 14 天或 30 天自動抹除),從底層根絕過期資料留存風險。
  4. 機密對話關閉聯網搜尋: 輸入機密程式碼或敏感業務資料前,確認聯網搜尋外掛處於關閉狀態,防止查詢語彙流向外部搜尋引擎。

參考資料