SDAS AI 助理

連結後，Jarvis Telegram bot 執行的每一次查詢與排程任務都會以你的帳號權限運作，而不是共用服務帳號——這樣才能正確套用 promquery 的權限控管。

步驟：點擊上方「產生連結代碼」，複製顯示的 6 位數代碼，在 5 分鐘內於 Telegram 與 Jarvis 的對話中輸入：

/link 123456

代碼僅能使用一次，過期或用過即失效；需要時可以隨時重新產生新代碼取代舊的連結。要解除連結，在 Telegram 輸入 /unlink。

⚠️ 這個代碼本身不是密碼，只是一次性的兌換憑證——完整代碼只顯示這一次，過期後無法查回，需要時請重新產生。

左側每一個連結，點下去都會在新分頁開啟該服務的 Swagger UI——一個可以直接在網頁上瀏覽每個端點的參數說明、並且實際發送請求測試的互動文件工具，不需要另外準備 Postman 或寫 curl。

• User Service API（user.cxit.dev/swagger/）：帳號登入、組織/群組管理、使用者管理、API Key 建立/查詢/刪除。
• Gateway API（gateway.cxit.dev/swagger/）：對話（/chat）、定時任務（/cron/jobs）、知識庫（/rag/*）、報告（/reports/*）、計劃（/plans/*）。
• PromQuery API（promquery.cxit.dev/swagger/）：Prometheus 查詢代理、資料源（instance）管理、儲存查詢語句。
• Alertmanager API（:8093/swagger/，需 port-forward）：告警規則、目前告警、靜音（silence）管理。
• Facility API（:4000/api-docs）：機房圖面上傳、機櫃/設備資料、即時狀態查詢。

User Service、Gateway、PromQuery 都有對外的網域可以直接連，但 Alertmanager、Facility API 這兩個服務在 GKE 上只有 cluster 內部的 ClusterIP，沒有對外的 ingress——點左側連結前，要先在本機用 kubectl 開一條通道到你要看的那個服務（namespace 預設是 cxit-sdas）：

kubectl port-forward svc/cxit-alertmanager 8093:8093 -n cxit-sdas
kubectl port-forward svc/cxit-facility-api 4000:4000 -n cxit-sdas

⚠️ 指令跑著的那個終端機視窗要保持開啟，通道才會一直存在；關掉終端機或按 Ctrl+C 就會斷線，連結也會打不開。

大部分端點都需要帶 Authorization: Bearer <token>，Swagger UI 頁面右上角有一個 Authorize 按鈕，點下去貼上 token 就會自動套用到之後所有的「Try it out」請求：

• 快速測試：從瀏覽器開發者工具的 Local Storage 複製目前登入的 authToken（JWT，有效期較短）。

Facility API 是例外——它認的是 X-API-Key 這個 header，不是 Authorization: Bearer，值是部署時設定的 config.apiKey（在 deploy/values/secrets.yaml），跟上面的使用者 token 無關。

⚠️ Swagger UI 送出的每一個請求都是真實請求——會真的建立/刪除/修改資料（例如真的新增一筆 cron 任務），測試時請留意，不要對正式資料誤按。