新來這裡?從透過 CLI 連線開始連結您的專案。本部分關於代理在連線後如何處理後端。
基元
CLI 工具
代理的雙手。用於登入、結構描述、部署、設定和診斷的一個終端機介面。
診斷和顧問
拉取顧問發現、DB 健康、指標和錯誤日誌,代理可以讀取和修復。
代碼設定
身份驗證、SMTP、儲存體、保留和部署設定存在於
insforge.toml 中。計畫和套用如基礎設施。分支
將整個後端複製到隔離分支以測試危險變更,然後合併或重設。
為什麼這很重要
人和代理想要來自後端的不同東西。一個人想要一個 UI 按一下。一個代理想要一個穩定的文字介面,可以驅動、讀取和推理。這在 InsForge 各處顯示。 結構描述變更是您的存放庫中的移轉,專案設定是一個insforge.toml 檔案,所以代理編輯文字、提交它並在 PR 中評論它,而不是按一下表單。當它想嘗試危險的事情時,它轉動一個後端分支、執行對複本的變更並在出錯時扔掉分支。當某些事情看起來不對時,它直接用 npx @insforge/cli diagnose 取得診斷和顧問發現,沒有儀表板在迴圈中,這就是讓它關閉像許可 RLS 原則這樣的安全漏洞本身而不是等待人類記得檢查。它還用 npx @insforge/cli metadata 直接從後端讀取目前結構描述、日誌和中繼資料,所以它從真實狀態工作,而不是猜測。
迴圈
這些串聯在一起。工作階段通常是這樣的:- 用
npx @insforge/cli metadata讀取目前狀態。 - 分支後端、寫一個移轉並檢查什麼是待處理的
npx @insforge/cli db migrations list,或編輯insforge.toml並用npx @insforge/cli config plan預覽設定差異。 - 用
npx @insforge/cli db migrations up --all或config apply套用它,針對分支先,然後父項。 - 執行
npx @insforge/cli diagnose以檢查顧問發現和錯誤日誌,並問diagnose --ai以解釋它們。 - 套用補救、重新執行診斷並合併分支。