📌 项目地址:semantica-agi/semantica | ⭐ 2,254 颗星 | 🔧 Python | 📜 未标注
AI系统正在接管信贷审批、医疗建议、法律文书审查这类有后果的决策。但大多数Agent的行为是没痕迹的:输入一堆文档,输出一个结论,中间过程锁在模型权重和向量相似度里。监管机构追问“为什么批这笔贷款”,系统只能回一句“模型算出来的”。
Semantica(github.com/semantica-agi/semantica)想做的是在LLM和向量库下面垫一层确定性的图基础设施。它不是又一个知识图谱数据库,而是把企业数据抽成Context Graph(上下文图),在图结构上跑推理和分析,把每一次决策的来龙去脉记下来。图构建、推理、溯源全都不需要LLM参与,纯确定性逻辑,结果可以逐条验证。
为什么需要它:AI的黑箱在企业场景里是合规事故
信贷审批是README点名的场景。一个AI助手批准了一笔贷款,几个月后监管来查,问“当时为什么批”。如果系统的回答是“基于模型风险评估”,这就是合规事故。监管要的是明确的实体、关系、规则和路径:哪份收入证明、哪个信用分变化、哪条风控规则触发了通过。Semantica记录的decision provenance(决策溯源)就是为这个设计的。
这个词值得展开说清楚。Provenance不只是日志,它是一张图:决策节点连到触发它的数据节点,数据节点连到它的来源表,规则节点说明依据哪条风控策略。审计时可以顺着图走一遍,每一步都有据可查。这是向量数据库给不了的——向量索引只告诉你“有这个文档”,不告诉你“为什么是这个文档”。
它解决的具体问题:三个层面
上下文管理。 企业数据是碎片化的:CRM里的客户记录、SAP里的订单、PDF合同、邮件往来。Semantica把这堆东西抽取成结构化的图,实体是同一套,关系是明确的,而不是让LLM每次现查现找。
确定性推理。 知识图谱建好之后,推理是规则的,不是概率的。没有LLM参与意味着结果可复现、可验证。同样的输入走同样的路径,得出同样的结论。对受监管企业,这个“确定性”是刚需。
端到端可追溯。 从原始数据到最终决策,每一步都在图中留痕。往前能溯源,往后能解释,审计时不需要从模型日志里大海捞针。
README里有什么:老实说,还不多
安装命令只有一个:
pip install semantica
README写了项目定位和技术特性,但没给完整的使用示例。初始化怎么做、Context Graph怎么建、怎么接进现有Agent框架,都要去官方文档翻。这是项目的真实状态:定位清晰,文档没跟上,API可能还在变。如果打算评估,建议先跑通最小示例再谈集成。
参考入口:
- 官方文档:https://docs.getsemantica.ai/
- 平台演示视频:https://www.youtube.com/watch?v=QfnNZg4-dZA
- CHANGELOG:https://github.com/semantica-agi/semantica/blob/main/CHANGELOG.md
和同类工具的分工
向量数据库管“相似性检索”,不表达“A导致了B”。Semantica管的是决策路径:哪个实体、哪个关系、哪条规则、哪个数据源。两者不是竞争关系,是互补关系——Semantica甚至允许在图上挂向量索引,给Agent既提供可推理的结构,也提供语义检索的能力。
传统知识图谱工具(Neo4j这类)解决图存储和图查询。Semantica的差异在“为AI决策服务”这层:做本体管理、决策推理、溯源记录,而不是只提供一个图数据库。它同时支持RDF和LPG两种图模型,兼容W3C标准,方便嵌进已有的企业数据治理体系。
还有个关键差异:Semantica可以自托管,数据不出企业边界。README写了Zero Vendor Lock-In和Self-Hostable。对金融、医疗、政务这些不能把数据送进第三方SaaS的行业,这是硬约束。把数据打包发给外部服务做知识图谱,本身就是新的合规风险。
目标用户:谁真的需要它
README说的很清楚,不是给聊天机器人加记忆用的。
AI/ML平台团队,做的是“会做有后果决策”的Agent。数据平台团队,数据在Databricks或Snowflake上,Unity Catalog或Snowflake仓库里的表需要变成治理过的知识图谱,又不想把数据导给第三方。合规、风险、审计团队,要给监管方一个说得通的“为什么”。金融、医疗、法律、政务、国防这些不能接受黑箱的行业。平台和基础设施工程师,要一个能自托管的KG、推理、溯源整套栈。
几个需要留意的现实问题
项目有2254颗星,但在生态成熟度上跟Neo4j这种老牌图数据库没法比。README没有完整使用示例,说明最佳实践还没定型,接入生产环境要花时间踩坑。
“可审计AI”不只是技术问题。Semantica提供的是基础设施,但企业要真正过监管这关,还得自己定义本体(Ontology)、权限模型、审计策略。工具记录的是技术链路,监管认可的是整个体系。两者之间隔着组织流程和制度建设。
MIT许可证对商用友好,代码可以自己审查。对于要部署到高安全环境的企业,这比闭源方案多一层保障——你能确认它没有把数据发到任何地方去。
Semantica的价值在于它选了“确定性”而不是“智能”作为核心。AI决策需要可解释性的时候,确定性基础设施比再聪明的模型都管用。如果你做的是有后果的AI系统,这个项目值得盯住。如果你只是在给聊天机器人加记忆,它不适合你。