接入既有系統

GembaOS 是企業 AI Agent 的治理執行平台：以政策判定權限、以綁定參數的單次放行令授權每一個動作、以可追責的簽署鏈記錄人的審批，部署於企業本地機房或私有 VPC。它不是編排框架，也不是模型流量的閘道，所以在大部分技術棧上是「加上去」而不是「換掉」。

系統如何接駁

每個既有系統都由適配器封裝成一組受治理的操作。系統本身不必重寫，模型也從不持有系統的憑證：模型只能提出操作，由 GembaOS 在政策判定之後，以及作業手冊要求時經負責人簽章之後，才代為執行。

系統類型	接入方式
現代 API 與 SaaS	由 OpenAPI 規範生成接口合約草稿，憑證由閘道代管
傳統金融、核心系統	SOAP、XML、固定長度電文適配器，原始電文雜湊存證
資料庫	只允許受限只讀檢視與參數化存儲過程白名單
檔案批處理	共享盤、檔案閘道或 SFTP 掛載目錄上固定佈局檔案的生成、審批、投遞與回執對賬閉環
無 API 的遺留客戶端	以釘扎雙向 TLS 連接的隔離執行端，連線中斷即作廢放行令

只有作業手冊授予了某項操作，該操作才能被呼叫。沒有任何作業手冊使用的接駁即使已在登記冊上，也沒有 Agent 能觸及。

每個接駁上線前必須顯示甚麼

控制台的「接駁」頁面按外部系統列出其連線資料：所需變數的名稱及各自是否已設定，從不顯示數值。同時顯示從記錄讀出的運作狀態、作業手冊授予的範圍、供應商合約監察，以及憑證指紋與輪換日期。

每個接駁都附有上線核對表。每一項都由設定與記錄判定，沒有人手剔選：

變數齊全；
由真實系統回應，而非測試模擬服務；
供應商合約受監察；
記錄上有一次受治理的呼叫；
有作業手冊授予該操作；
每個會寫入的作業手冊都列明責任人；
寫入操作說明書沒有缺口；
已設定輪換政策；
已申明資料去向。

作業手冊授予的每一項生產寫入操作，都有一張從設定讀出的說明書回答六個問題：

誰呼叫：角色、責任人、由誰執行、以誰的憑證。
能讀哪些資料。
何時需要人簽章：判定、各檔的簽章、必須由人判斷的信號、決裁權限表要求的人數。
獲准參數如何綁定：一次性放行令、寫入前重讀甚麼、容許範圍、冪等鍵由誰填寫。
每一類失敗會怎樣處理。
目標系統自身支援甚麼：版本或條件寫入、寫入後回讀、重複標記。

設定以空白作答的問題列為缺口，目標系統的限制列為說明，絕不寫成已具備的能力。

接駁前需要準備甚麼

試行期間，第 3 至 4 週會接駁兩至三個目標系統。每個系統若先備妥以下各項，上述說明書會更容易填寫：

目標系統的測試環境或沙盒帳戶；
接口說明：OpenAPI 規範、電文佈局或檔案佈局；
只具備操作所需最小權限的服務帳戶，保存在貴公司自己的環境內；
哪些操作只讀、哪些會寫入，以及每項寫入由誰負責；
系統是否支援條件寫入、寫入後回讀與重複標記。這些答案決定 GembaOS 寫入前要重讀甚麼，以及如何避免重試變成重複執行。

現有 AI 助手與 Agent 框架

GembaOS 以雙向 MCP 與現有 AI 助手和 Agent 框架互通。對外，既有系統成為標準 MCP 工具，企業現有的 Claude Code、Copilot 或 Cursor 可以呼叫，每次呼叫都經過同樣的管控。對內，以 LangGraph、Dify 或同類框架建成的 Agent 只需把工具端點指向 GembaOS 閘道，即可獲得審批與放行令，無須改動編排代碼。以下每篇說明接縫在哪裡，並用那套技術棧自己的用語來講。