文档 / Langfuse CLI

Langfuse CLI

Langfuse CLI 封装了整个 Langfuse API,让你能够直接在终端与 Langfuse 交互。它为偏好命令行的 AI 编码 agent 和高级用户而构建。

Langfuse CLI

完整文档请阅读专门的 CLI GitHub 仓库。

运行以下命令开始使用:

bash

npx langfuse-cli api <resource> <action>

或者直接让你的编码 agent 替你做:

markdown

please install langfuse-cli

身份验证

CLI 使用与你用于 Langfuse SDK 和 public API 相同的项目 API 密钥对进行身份验证。在 Langfuse UI 的 Project settings → API Keys 下创建密钥对,然后在运行 CLI 命令之前将凭证作为环境变量暴露:

bash

export LANGFUSE_PUBLIC_KEY="pk-lf-..."
export LANGFUSE_SECRET_KEY="sk-lf-..."

# Region-specific host. Defaults to https://cloud.langfuse.com (EU).
# US:    https://us.cloud.langfuse.com
# Japan: https://jp.cloud.langfuse.com
# HIPAA: https://hipaa.cloud.langfuse.com
# Self-hosted: your own deployment URL.
export LANGFUSE_BASE_URL="https://cloud.langfuse.com"

CLI 会自动读取这些变量——没有单独的 login 步骤。密钥的作用域是单个项目,因此对你想交互的每个项目使用不同的密钥对。

它能做什么

CLI 能做 Langfuse API 能做的任何事。

它动态封装完整的 OpenAPI 规范,因此每个端点(traces、提示词、数据集、分数、sessions、指标等)都可作为 CLI 命令使用。详见完整的 API Reference。

为什么使用它

让你的编码 agent 替你管理 Langfuse。 Cursor、Claude Code、Windsurf 等可以使用 CLI 创建数据集、拉取 traces、更新提示词等,而你无需离开编辑器。
脚本化你的工作流。 自动化重复性任务,如在 CI/CD 或 bash 脚本中导出 traces、批量打分或跨环境同步提示词。
快速查询比 UI 更快。 几秒钟内获取最近 5 条 traces、检查提示词版本或列出分数。

与 Agent Skills 配合

CLI 被设计为与 Agent Skills 协同工作。该 skill 教 agent 如何发现端点、遵循常见工作流并访问文档,全部通过 CLI。参见 Langfuse for Agents 了解 skill、CLI 和 MCP server 如何组合的全貌,或阅读博客文章。