Graphiti Knowledge Graph 介绍
Graphiti 是一个用于知识图谱操作的技能,通过 Graphiti 的 REST API 实现查询与管理知识图谱的能力,并支持动态服务发现。
用途 该技能面向需要为 AI 工作流接入知识记忆层的场景,用于查询知识图谱中的相关事实、向图谱添加新的情节(episode/memory),以及抽取实体与关系。
前提条件 使用该技能需要以下组件:
- Neo4j 数据库(用于图存储)
- Qdrant(用于向量搜索)
- 正在运行的 Graphiti 服务(默认地址:http://localhost:8001)
主要能力 技能提供两个工具:
-
graphiti_search:在知识图谱中搜索相关事实。 用法示例(bash): GRAPHITI_URL=$({baseDir}/references/env-check.sh) curl -s -X POST "$GRAPHITI_URL/facts/search"
-H 'Content-Type: application/json'
-d '{"query": "YOUR_QUERY", "max_facts": 10}' | jq . -
graphiti_add:向知识图谱添加一个新的情节/记忆。 用法示例(bash): GRAPHITI_URL=$({baseDir}/references/env-check.sh) curl -s -X POST "$GRAPHITI_URL/messages"
-H 'Content-Type: application/json'
-d '{"name": "EPISODE_NAME", "content": "EPISODE_CONTENT"}' | jq .
使用方式 该技能使用环境发现机制自动定位 Graphiti 服务,依次为:
- Clawdbot 配置:clawdbot config get skills.graphiti.baseUrl
- 环境变量:$GRAPHITI_URL
- 默认回退:http://localhost:8001
如需修改 Graphiti URL,可使用: export GRAPHITI_URL="http://10.0.0.10:8001"
或
clawdbot config set skills.graphiti.baseUrl "http://10.0.0.10:8001"
示例
搜索信息:
GRAPHITI_URL=$({baseDir}/references/env-check.sh)
curl -s -X POST "$GRAPHITI_URL/facts/search"
-H 'Content-Type: application/json'
-d '{"query": "Tell me about Essam Masoudy", "max_facts": 5}'
添加记忆:
GRAPHITI_URL=$({baseDir}/references/env-check.sh)
curl -s -X POST "$GRAPHITI_URL/messages"
-H 'Content-Type: application/json'
-d '{"name": "Project Update", "content": "Completed Phase 1 of Clawdbot integration"}'
限制 该技能依赖外部服务,需先自行部署 Neo4j、Qdrant 与 Graphiti 服务。关于收费与价格、具体平台支持范围、额外功能特性等信息,资料暂未提供。