Zep发布v4版Context API（应用程序接口），为智能体增加图导航与摄取追踪

Zep官方博客公布v4更新。 新增能力包括：超边，将涉及三个及以上实体的事实作为单条事实存储； 实体类型层级，自定义实体类型可设父类型与子类型，该功能处于面向部分账户的封闭测试； document_id将同一文件的分块归组，提取每个分块时带上先前分块作为上下文； 身份与受保护属性，按账户ID等标识值匹配实体，导入时不覆盖来自记录系统的受保护值；

strict_ontology: true使图谱符合已定义实体与边类型； reference_time记录事件发生时间，与数据接收时间分开，回填时保持事件顺序。 单次调用最多添加100个节点或100条边。

导航新增graph.node.list（支持order_by="degree"）、graph.node.list_neighbors和graph.get_subgraph； get_subgraph最多从20个种子节点扩展、深度最多三跳，达到节点或边上限时返回truncated并在truncation_reason中标明限制。

通过Context MCP（模型上下文协议） Server接入的智能体可获得get_node_neighbors与get_subgraph工具。

debug_log.enable在限定窗口内开启调试模式（标准账户60分钟，Enterprise账户24小时），Flex、Flex Plus和Enterprise计划的同一调用还开启Ingestion Traces（摄取追踪）； 工作流日志保留12小时、Enterprise账户7天，追踪保留30天。

每个用户、线程和图改用Zep生成的UUID寻址，v3的user_id、thread_id、graph_id成为旧名称； SDK（软件开发工具包）在自身重试时发送幂等键。 错误响应统一含code、message、param、details、request_id，响应头X-Zep-Request-ID与request_id一致。

搜索按范围拆分为graph.search_edges、graph.search_nodes、graph.search_episodes、graph.search_observations和graph.search_thread_summaries，graph.get_context返回Context Block。 列表默认每页50条，使用不透明游标翻页。

用户与线程UUID在v3和v4中取值相同； 图迁移应使用v3返回的canonical_graph_uuid，而非v3的Graph.uuid。 lookup为迁移工具，将随v3退役而弃用。