Langfuse 新增了用于读取分析信息和同时执行多项评估的外部集成方式。开发者可将查询和评估执行接入基于工具的工作流,而使用 AI 网关这一转发 AI 请求服务的用户,则可使用改进后的设置指引和密钥管理界面。

1. 新增读取 Topics 信息的公开 API

10月24日发布的 Langfuse 4.70.0 新增了读取 Topics 信息的公开 API。此次变更的重点是只读访问。对开发者而言,重要的是集成程序有了获取信息的接口。

首次设置 Topics 的界面也得到完善。缺少 AI 连接时,界面会说明情况,并为没有管理员权限的用户提供指引。这些变化有助于设置人员了解连接状态和权限问题。

首次运行时,界面会根据分析中、等待和失败状态显示相应内容。继设置阶段的指引之后,运行状态也会体现在界面中,重点是让初次使用者了解任务所处的状态。

2. 提供执行多项评估的工具和结果标识符

批量评估新增了一种遵循 MCP 的执行方式。MCP 是用于连接 AI 工具的通信协议,外部客户端可借此将功能作为工具调用。工具名称为 runBatchEvaluation。开发者可用它将多项评估的执行纳入客户端的工具调用流程。

批量执行结果中还新增了 batch_action_id。这意味着用于请求执行的工具和附在结果中、用于区分结果的标识符一并加入。考察此次变更时,除了发起评估的一端,还需确认接收结果的集成程序将如何处理新字段。

查询和执行通过不同接口加入,这一点也值得关注。前述公开 API 用于读取 Topics 信息,而评估工具用于启动批量任务。可根据所需操作是信息查询还是评估执行,选择要集成的功能。

3. 优化网关设置指引和密钥页面

AI 网关修改了 Claude Desktop 设置指引,并合并了 Claude 相关标签页。此项变更调整了用户按初始设置步骤操作时看到的指引结构。同时还进行了内部整理,将设置指引标签页与数据加载分离。

网关密钥页面会在界面内显示密钥说明。同一页面还新增了邀请成员的功能。用户可在查看密钥说明后继续邀请团队成员,让密钥操作界面与开始协作的流程衔接得更紧密。

设置示例也采用了语法高亮。适用内容包括用户输入到操作系统的 Shell 命令,以及 TOML·JSON 格式示例。它并非改变设置步骤的功能,而是帮助用户在阅读示例时直观区分语法的界面改进。

4. 扩展集成的收益与引入时需确认的范围

此版本的收益在于,将查询和评估执行接入外部工作流的选择更多了。网关改进了设置指引、密钥说明和团队成员邀请功能,使首次使用的准备过程有所变化。这是一次兼顾扩展自动化接口和提升初始使用便利性的发布。

构建新集成的一方也需准备应对变更,Topics API 被标为尚未达到稳定阶段的功能。记录发布变更的发行说明没有给出查询路径、请求与响应规范,也未提供评估工具的调用参数及调用时传入的值,因此实际实现前需要确认详细规范。

Langfuse 4.70.0 的核心在于扩展查询和评估执行的集成接口,同时优化首次设置网关用户的引导流程。