Semantica 是一个开源的 AI 基础设施项目,给 AI 智能体(能自主调用工具、做判断的 AI 程序)加一层「决策记录层」:它把企业里的文件、数据库、表格等零散数据整理成一张知识图谱(把实体和关系建成网络结构的数据组织方式),让智能体基于它做决策,并把每次决策的依据、来源、影响范围都记录下来,事后能查、能审计、能导出报告。项目自称「AI 智能体的开源版 Palantir」——Palantir 是硅谷知名的商业大数据分析平台,Semantica 用 MIT 协议开源、支持自己部署,相当于把同类能力开放出来。

它面向的不是普通个人开发者,而是需要用 AI 做关键决策的团队:AI 平台工程师、数据工程师,以及金融、医疗、法律、政府等受监管行业的合规、风控与审计人员。2026 年 8 月发布的 v0.6.6 版本在 GitHub 上已有 10.8k star。

它解决什么问题

大多数 AI 应用是「黑盒」:你给大模型一堆资料,它给出一个答案,但没人能说清它依据了哪些数据、为什么这样判断。日常问答无所谓,可当 AI 去审批贷款、检查药物相互作用、判定合规风险时,「为什么」就是硬要求——监管机构可能在几个月后还追问当时那个结论的依据。

Semantica 的思路是把决策本身变成数据:每次决策都记成图谱里的一个节点,包含当时喂入的上下文、判断理由、置信度、以及关联的上游原因和下游影响。这些记录按 W3C 的 PROV-O 标准存放(一种描述「数据从哪来、由谁产生」的国际溯源格式),可导出成 JSON、CSV 或 RDF 文件,直接用于监管报送。

核心机制:上下文图、因果推理与规则引擎

Semantica 的核心是一个「上下文图」:把人、公司、合同这类实体、它们之间的关系、每个事实的来源都建成图结构。与向量检索只回答「哪些内容相似」不同,图能回答「这件事和那件事怎么关联、为什么关联」——比如想知道某客户和某份合同有没有间接关系,图遍历几步就能查出来。

在此之上,项目提供确定性的推理与规则能力:前向链(从已知事实一步步推导新结论)、Rete 网络(一种高效匹配规则的算法)、Datalog(一种声明式逻辑查询语言)和 SPARQL(图数据库的标准查询语言),每一步推理路径都可以展开解释。它还有冲突检测——多个来源说法矛盾时会被标记出来,而不是悄悄覆盖;以及 SHACL 约束校验(一种描述「数据必须满足什么规则」的 W3C 标准),可以把合规要求写成机器可自动校验的约束。

与「向量库加 RAG」的差别

当前主流的 AI 记忆方案是向量数据库加 RAG(检索增强生成:把文档切块存入向量库,提问时按相似度捞相关片段喂给大模型)。它的短板是:决策历史不保存、回答依据说不清、数据冲突时静默覆盖。Semantica 的做法不是替换这套方案,而是在它下面补一层图结构和记录层,把「检索」升级为「图遍历加语义搜索」,并保留每次决策的完整轨迹和来源。

存储与数据源

图数据支持多种后端且可随时更换:RDF 类(Oxigraph、Blazegraph、Apache Jena、Eclipse RDF4J)和属性图类(Neo4j、FalkorDB、Apache AGE、AWS Neptune);向量存储支持 FAISS、Qdrant、Milvus、Pinecone 等。换后端不需要改业务代码。数据接入原生支持 Databricks(Unity Catalog 与 Delta Lake,Databricks 是主流的数据湖平台)和 Snowflake(云数据仓库),也支持常规的文件、网页、SQL 数据库、Kafka 消息流、Git 仓库、邮件,以及 MCP 资源(MCP 是给 AI 工具提供统一接口的开放协议)。

集成方式

项目不要求替换现有技术栈:提供 MCP 服务器、REST API、命令行工具和可视化工作台,并原生支持 Agno 与 CrewAI 两个智能体框架。它可以放在现有的 LLM、向量库和智能体框架之下当补充层使用。值得注意的是,整个图谱构建、推理和溯源过程不调用大模型,是确定性的——同样的输入必然得出同样的结果。

项目现状与上手

仓库地址为 semantica-agi/semantica:10.8k star、1.2k fork、2571 次提交,代码以 Python 为主(占 91.3%),MIT 协议,支持自托管。安装只需执行 pip install semantica,项目提供 semantica doctor 命令验证环境是否就绪。它也明确声明了边界:不做大模型内部思维链的解释,只解释系统层面——喂进去的上下文、产生的决策、决策来源、应用的策略和完整执行轨迹。

值得记住的一点

如果你的团队正在用 AI 处理监管敏感或后果重大的决策,Semantica 提供了一条开源路径:把事情从「AI 说了算」变成「AI 说了算,且每一步都有据可查」。对合规压力不明显的项目,它暂时不是必需品;但对金融、医疗等行业的 AI 应用,这种可审计性正在从加分项变成硬性要求。