Trulens 开发指南和踩坑记

Trulens是什么

Trulens是一个可视化的开源LLM追踪和调试工具。

有点类似langsmith，不过Trulens是完全可以在本地运行的，无需像langsmith那样把数据上传到云端展示。

Trulens的界面(Dashboard)是用Streamlit做的。

开发实践

Trulens和Langchain

由于Trulens和Langchain都在不停的更新，所以两者的协同有很多问题。

目前版本（langchain 0.3.25, Trulens 1.5.2）下，如果使用LCEL编写思维链，且思维链使用字典格式输出，Trulens就会报错，根据初步调查，Trulens只能支持字符串（str）的输出，字典格式会报错:

在Trulens 1.5.2中追踪Langchain的示例代码：

from trulens.apps.langchain import TruChain

tru_chain = TruChain(
            chain,                     # langchain的思维链
            app_id="Trace_Visualizer",  
            feedbacks=[],  # 禁用所有评估功能
            record_app=True,  # 启用详细追踪
            # 增强配置
            record_time=False,          # 记录时间戳
            record_metadata=False,      # 记录元数据
            record_cost=False,          #