核心用法
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。