项目 Graphiti 图谱 API
为项目写入图谱 episode、查询异步任务和执行语义检索。所有项目端点接受平台支持的组合认证,并要求调用方具有项目访问权限;功能未启用或管理员配置不完整时会 fail-closed。
GET /projects/:projectId/graph/status
返回项目图谱功能状态、配置可用性和上游 Graphiti 服务状态。
POST /projects/:projectId/graph/episodes
向项目图谱提交 episode。请求成功后返回异步 jobId,客户端应继续查询任务状态。
GET /projects/:projectId/graph/jobs/:jobId
读取指定图谱任务的处理状态、结果或失败信息;任务必须属于当前项目。
POST /projects/:projectId/graph/search
在当前项目隔离的 Graphiti namespace 中执行语义搜索并返回匹配结果。