buildswithpaul/Frappe_Assistant_Core

解決的問題

Frappe Assistant Core (FAC) 允許使用者透過 LLM（如 Claude 或 ChatGPT）以自然語言與 ERPNext 站點互動。它消除了手動執行重複性任務（例如搜尋逾期發票、更新潛在客戶狀態或執行收入報表）的需求，讓 LLM 能直接且安全地存取 ERPNext 資料與工作流程。

作用方式

FAC 作為 MCP 就緒的 LLM 與 Frappe/ERPNext 生態系統之間的橋樑。它提供 24 個內建工具，涵蓋文件管理、搜尋、報表與分析。系統使用 OAuth 2.0 進行驗證，確保 LLM 在登入使用者的特定權限下運作。

關鍵架構特色包括：

• 即時模式存取：每次呼叫時直接從 Frappe API 讀取元資料，表示自訂欄位與權限變更會立即反映，無需同步或索引。
• 技能與範本：管理者可定義「技能」（處理特定任務的指示）與「提示範本」（使用者使用的預設起點），以確保一致性。
• 可擴充性：開發者可透過在自己的 Frappe 應用中使用鈎子，向助理新增工具與技能。

適用對象

• ERPNext 使用者：希望使用 AI 自動化資料檢索與業務流程管理的團隊
• Frappe 開發者：希望擴展 ERPNext 站點的 AI 功能，加入自訂工具與業務邏輯的開發者
• 管理者：需要一種安全、可稽核的方式將 LLM 結合至業務運作的使用者

主要亮點

• 24 個內建工具：涵蓋 CRUD 操作、搜尋、報表產生、工作流程執行與 Python 基礎分析
• 權限感知：嚴格遵循現有的 ERPNext 使用者角色與權限
• MCP 相容：支援 Model Context Protocol，可輕鬆與 Claude Desktop 等客戶端整合
• 稽核日誌：每次互動皆記錄於助理稽核日誌中，確保安全性與合規性
• 零同步模式：無需向量索引或快照表格；使用即時元資料以確保即時準確性