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 等客户端集成
• 审计日志：每次交互都会记录在助手审计日志中，确保安全与合规
• 零同步模式：无需向量索引或快照表；使用实时元数据实现实时准确性