追踪入门

本指南带你完成将第一个 trace 接入 Langfuse 的过程。如果你想了解什么是追踪以及它为什么重要,请先查看可观测性概览。关于 traces 在 Langfuse 中的结构以及它在后台如何工作的细节,参见核心概念。

Agent 化安装

安装 Langfuse Agent Skill,让你的编码 agent 能够访问所有 Langfuse 功能。

让你的编码 agent 安装

让你的编码 agent 通过指向 GitHub 仓库 来安装该 skill,并指示它开始接入追踪。

Install the Langfuse Agent Skill from github.com/langfuse/skills
and use it to add tracing to this application with Langfuse
following best practices.

Cursor 插件

Langfuse 有一个 Cursor 插件,其中自动包含该 skill。

在 Cursor 中安装插件

然后提示你的 agent:

Add tracing to this application with Langfuse following best practices.

手动安装

通过 npm 安装(skills CLI):

npx skills add langfuse/skills --skill "langfuse"

如果你想直接针对某个特定 agent:

npx skills add langfuse/skills --skill "langfuse" --agent "<agent-id>"

git clone https://github.com/langfuse/skills.git /path/to/langfuse-skills

mkdir -p /path/to/<agent-skill-root>/skills

ln -s /path/to/langfuse-skills/skills/langfuse /path/to/<agent-skill-root>/skills/langfuse

然后提示你的 agent:

Add tracing to this application with Langfuse following best practices.

手动安装

本指南帮助你手动开始使用 Langfuse 追踪。

没看到你预期的内容?

后续步骤

既然你已经接入了第一个 trace,你就可以开始为 traces 添加更多功能。我们推荐从以下几项开始:

• 将多轮应用的 traces 分组为 sessions
• 按应用的不同阶段将 traces 拆分到不同环境
• 为 traces 添加属性,便于日后过滤

已经知道想要什么?查看 Features 下的具体主题指南。