graphiti

🕸️ 私有化知识图谱智能管家

🥥2总安装量 1评分人数 1
100% 的用户推荐

基于 Getzep Graphiti 开源项目的知识图谱管理技能,支持本地部署的实体关系搜索与记忆存储,数据完全由用户掌控。

A

基本安全,请在特定环境下使用

  • 来自社区或个人来源,建议先隔离验证
  • ✅ 无危险代码执行:未使用 eval/exec/system 等函数,无命令注入风险
  • ✅ 数据隐私可控:所有 API 调用指向用户配置的本地服务,无第三方数据上传
  • ✅ 依赖透明可靠:仅使用 curl、jq 标准工具,无动态代码加载
  • ⚠️ 来源为个人开发者:非官方组织维护,建议关注上游 Graphiti 项目更新
  • ⚠️ 需自行保障网络安全:默认 HTTP 通信,远程部署时需额外配置 TLS 与访问控制

使用说明

核心用法

Graphiti 技能提供知识图谱的查询与管理能力,通过 REST API 与本地部署的 Graphiti 服务交互。主要功能包括:

1. 事实搜索(graphiti_search):使用自然语言查询知识图谱,检索相关实体、关系及事实,支持设置返回结果数量(max_facts)。

2. 记忆添加(graphiti_add):将新的对话片段或信息以"episode"形式写入图谱,系统自动提取实体与关系,实现知识的持续积累。

3. 动态服务发现:通过三级配置机制(clawdbot config → 环境变量 → 默认地址)自动定位 Graphiti 服务,无需硬编码地址。

显著优点

  • 完全本地化:数据仅在内网传输(默认 localhost),不上传至任何第三方服务器,隐私可控性极强。
  • 架构清晰:基于成熟的 Graphiti(Zep 开源项目)+ Neo4j(图存储)+ Qdrant(向量检索)技术栈,扩展性强。
  • 零代码侵入:纯 curl API 调用,无复杂依赖,与现有系统易于集成。
  • 配置灵活:支持环境变量与配置文件双模式,适配开发、测试、生产多环境。

潜在缺点与局限性

  • 部署门槛高:需自行搭建 Neo4j、Qdrant、Graphiti 三个服务,对运维能力有要求。
  • 来源可信度有限:当前为个人开发者维护(T3),非 Getzep 官方直接背书。
  • 功能边界明确:仅覆盖搜索与添加两类操作,不支持图谱可视化、复杂查询语言(如 Cypher)直接执行。
  • 网络依赖:虽为本地服务,但仍需确保服务健康,否则操作将失败。

适合的目标群体

  • 需要私有化知识管理的企业技术团队
  • 研究记忆增强型 AI 应用的开发者
  • 已使用或计划采用 Graphiti/Zep 作为记忆层的项目
  • 对数据主权敏感、拒绝 SaaS 化方案的用户

使用风险

  • 服务可用性风险:三组件任一故障将导致技能不可用,需建立监控与备份机制。
  • 配置错误风险:若错误配置 GRAPHITI_URL 指向不可信服务,可能导致数据泄露。
  • 版本兼容性:Graphiti API 若升级,技能可能需要同步更新。
  • 无内置加密:默认 HTTP 通信,跨网络部署需自行配置 TLS。

graphiti 内容

文件夹图标references文件夹
手动下载zip · 2.8 kB
env-check.shtext/x-shellscript
请选择文件