在 Hugging Face 上利用 Docker 或 Chat-UI 模板建立自己的 AI 聊天空間時，最常遇到的第一個技術門檻就是環境變數（Secrets）的設定。尤其是紅框標注的 MONGODB_URL，這對於需要儲存對話紀錄、使用者資料的應用程式來說至關重要。
一、 什麼是 MONGODB_URL？
簡單來說，這是一串「地址 + 通關密碼」。它告訴你的 Hugging Face Space：資料庫在哪裡？由誰登入？登入密碼是什麼？
如果你使用的是官方推薦的 MongoDB Atlas（雲端版），這個 URL 通常長得像這樣：
mongodb+srv://<username>:<password>@cluster0.xxxx.mongodb.net/myFirstDatabase
二、 取得 URL 的具體步驟
大多數開發者會選擇 MongoDB 提供的免費方案，你可以依照這三個步驟取得字串：
- 登入控制台： 進入 MongoDB Atlas 官網並登入。
- 開啟連線選單： 在 Database 頁面中，找到你的 Cluster（叢集），點擊 「Connect」 按鈕。
- 選擇驅動程式： 選擇 「Drivers」 連結方式（通常預設為 Node.js 或 Python 即可）。
- 複製字串： 系統會跳出一串以
mongodb+srv://開頭的文字，這就是我們要的原始碼。
三、 填寫時的關鍵檢查（最容易出錯的地方）
直接把複製的內容貼上去通常會報錯！請務必手動替換掉字串中的兩個「尖括號佔位符」：
- <username>：替換成你在 Database Access 頁面設定的資料庫使用者名稱。
- <password>：替換成該使用者的密碼。（注意： 這是資料庫專用密碼，不是你登入 MongoDB 官網的帳號密碼！）
- 資料庫名稱：在網址最後一個
/之後，你可以自定義資料庫名稱（例如chat-history），系統會自動為你建立。
四、 為什麼要填在 Secrets 而不是 Variables？
在 Hugging Face 的設定介面中，你會發現有 Secrets（私密）與 Variables（公開）兩種。
由於 MONGODB_URL 包含了你的資料庫密碼，請務必填寫在「Space secrets」欄位中。這樣一來，即使你的 Space 是公開的，其他人也無法看到你的資料庫連線資訊，確保資料安全。
結語
設定好這組字串後，你的 AI 聊天機器人就能擁有「記憶」，儲存所有的對話過程了。如果在設定過程中遇到 Authentication Failed（認證失敗），通常是密碼填錯或特殊字元未編碼，建議重新檢查 Database Access 的密碼設定。
