环境变量

直连 Langfuse

变量	必填	说明
LANGFUSE_PUBLIC_KEY	是	Langfuse public key
LANGFUSE_SECRET_KEY	是	Langfuse secret key
LANGFUSE_HOST	否	Langfuse base URL（也可在代码中配置）

脱敏

变量	必填	说明
LANGFUSE_MASK_RULES	否	额外脱敏规则 JSON 数组

export LANGFUSE_MASK_RULES='[
  {"kind":"value","name":"openai-sk","pattern":"sk-[A-Za-z0-9]{32,}"},
  {"kind":"key","name":"salary","pattern":"^salary$"}
]'

详见 数据脱敏。

代理模式

走业务代理时，不使用 publicKey/secretKey，而是通过 authHeaders 回调动态注入认证头：

new LangfuseDirectTransport({
  host: "https://your-proxy.example.com/langfuse",
  environment: "prod",
  authHeaders: (sessionId) => ({
    Authorization: `Bearer ${resolveToken(sessionId)}`,
  }),
})

详见 LangfuseDirectTransport。