日常工作

使用工作區 bot

在 code-server 中啟動 Archibot 並讓它開始工作：它對你的 Archibus 環境了解什麼、能做和不能做什麼、可直接使用的提示，以及它與 Console 聊天有何不同。

客戶成員客戶管理員平台維運人員

最後更新 2026年6月19日

每個 Archibus 工作區都隨附 Archibot，這是一個在工作區內執行、且已經了解你的 Archibus 環境的受管 AI 助理。它可以讀取你的程式碼、驗證 AXVW 檢視、對工作區資料庫執行唯讀查詢、在 Archibus 參考資料中查詢，以及驅動執行中的應用程式——這一切都無需你接入金鑰或上下文。本指南適用於任何在 code-server 中工作的人，無論你的角色為何。

關於它周圍的其餘環境——編輯器、應用程式、資料庫——請參閱 Work inside your workspace。

啟動 bot

你有兩種進入方式：

• 終端機。 在 code-server 中開啟一個終端機（Terminal → New Terminal）並執行 archibot start。這會啟動一個受管工作階段——在底層它是一個為 Archibus 調校過的受管 Codex CLI。
• 編輯器面板。 從編輯器的側邊欄開啟 Archibot 面板，並在其訊息框中輸入——無需終端機。在面板中按 Start Archibot 即可開始一個工作階段。

你無需登入。工作區已持有一個受管金鑰，因此工作區一就緒，bot 也就緒了。如果找不到 archibot，你的工作區範本可能未包含受管 Archibot——請向你的帳戶管理員確認。

從編輯器面板聊天

偏好留在編輯器中而不是使用終端機？從側邊欄開啟 Archibot 面板，並使用底部的訊息框。該面板有 Chat、Agent 和 Full Access 三種模式：使用 Chat 詢問你所在檔案或專案的問題，使用 Agent 讓 Archibot 在你的工作區中進行變更，使用 Full Access 讓它更廣泛地操作工作區。它與終端機交談的是同一個受管 bot、具備相同的 Archibus 技能——選擇當下最適合的方式即可。

它知道什麼、能做什麼

Archibot 被設定為 Archibus 與 WebCentral 開發人員的助理。開箱即可：

• 處理 AXVW 檢視 — 建立新檢視的骨架、解釋現有檢視，並對照 Archibus 規則驗證它，回報需要修正的具體問題。
• 安全地讀取資料庫 — 對工作區資料庫執行 SELECT 類查詢，以檢查結構描述、查看範例資料列或確認某個資料來源。結果會有資料列上限，並遵守檢視限制。
• 撰寫資料來源、工作流程規則和表單 — 並在你接入它們之前，對照 Archibus 慣例加以檢查。
• 查詢資料 — 搜尋隨附的 Archibus 參考資料和產品說明，而不是憑空猜測。
• 查看執行中的應用程式 — 在無頭瀏覽器中開啟即時應用程式，以確認某個檢視能算繪，或重現某個問題。
• 處理建置與執行雜務 — 讀取記錄、重新啟動 Tomcat，並逐步完成部署或遷移步驟。

它會透過龐大的 Archibus 技能庫（空間、資產、租賃、搬遷、專案、報表、安全等）來分派工作，因此它往往會遵循你的團隊已經在使用的相同模式。

它不會做什麼

• 它不會變更資料庫。 它的查詢工具是唯讀的——沒有 UPDATE、INSERT 或 DELETE。結構描述和資料變更仍須透過遷移和你正常的審查流程。
• 它不會洩漏密鑰。 供應商金鑰會被遮蔽、原始認證的回讀已關閉，且它被指示要讓權杖、金鑰和原始客戶資料遠離檔案、筆記以及任何它儲存的內容。請你自己也守住同一條界線。
• 它會操作你的工作區檔案 — 請像審查同事的變更一樣，在提交前審查它的編輯。

範例

可以試用的具體提示。請明確指出你指的是哪個檔案或資料表；你愈精確，結果愈好。

建立一個 AXVW 檢視

“Create an AXVW view that lists rooms for a selected building, with a building filter and columns for room name, area, and category. Validate it and fix any issues before you finish.”

驗證並修復現有檢視

“Validate schema/ab-products/.../my-view.axvw and walk me through fixing each error you find.”

在建置之前檢查資料

“Show me the columns on the rm table, then return 20 sample rooms with their building and floor.”

新增一條工作流程規則

“Add a workflow rule that emails the space manager when a room’s category changes, and show me where it’s registered.”

處理一個表單

“On this form, add a document field for floor plans and validate the form controls.”

追蹤一個資料來源

“Find the datasource behind this panel and add a restriction so it only shows active records.”

找出為什麼變更沒有顯示

“My view change isn’t appearing in the app. Check the Tomcat logs, tell me what’s wrong, and restart Tomcat if that’s the fix.”

確認它能算繪

“Open the new room list in the browser and confirm it loads without errors.”

查詢某項內容

“How does Archibus handle multi-currency on lease records? Cite the reference.”

送它去審查

“Summarize the changes I made, then submit them for CI review.”

最後那一個會用到 archibot-submit-review，它會把你的變更打包，送入 Console 的 CI Review 流程——請參閱 Persistent environments and CI Review。

驗證和資料庫查詢會透過 Archibot 內建的 Archibus 工具執行——這裡它正在驗證一個 AXVW 檢視：

當你請它變更某項內容時，Archibot 會就地編輯檔案，變更會出現在 Source Control 中，準備好讓你像審查任何其他編輯一樣審查。

保留你的工作階段

對話與工作區執行階段繫結。用 archibot sessions list 列出過去的工作階段，並用 archibot start --session <name> 重新開啟其中一個；單獨執行 archibot start 則會開始一段全新的對話。工作階段不會在工作區停止/啟動或重建後存活，因此當 bot 產出你在意的內容時——一份摘要、一份計畫、一個產生的檔案——請儲存它：提交到 git，或複製到 Shared Drive。不要指望靠捲動回看一個重新啟動就會清空的終端機。

工作區 bot 與 Console 聊天的比較

Archibot 也以 Console 中的瀏覽器聊天形式存在（Using ArchibotChat）。它們共用相同的技能和 Archibus 知識，但在不同的地方運作：

• 工作區 bot 能親手操作你的工作區——它讀取你的檔案、對你的資料庫執行查詢、重新啟動你的應用程式，並就地編輯程式碼。
• Console 聊天 是基於瀏覽器的，適合在你不在工作區裡時用來提問、規劃和查詢參考資料。

對於某項任務，請擇一使用。對同一項工作同時跑兩者只會把點數花兩次。

其他命令

• archibot status 和 archibot doctor — 檢查受管工作階段及其工具是否健康。
• archibot capabilities — 列出受管 bot 在此工作區中能做什麼。
• archibot skills list — 查看它可用的 Archibus 技能。
• archibot versions — 顯示使用中的受管工具和映像版本。
• archibot feedback — 向平台團隊傳送已清理的意見回饋。
• archibot-v2、archibot-cc 和 cursor-agent — 受管的 Cursor 風格和 Claude 風格助理，若你偏好那些介面。它們使用相同的受管存取權。

相關指南

• Work inside your workspace — bot 所操作的編輯器、應用程式、資料庫和記錄。
• Using ArchibotChat — 瀏覽器聊天版本及其上下文來源。
• Workspace Archibot and Shared Drive — 在哪裡儲存 bot 產出的內容。
• Persistent environments and CI Review — 你送出變更審查之後會發生什麼。
• Troubleshooting — 當 bot 或應用程式行為異常時的第一步。