跳转至

应用列表


在应用列表,您可以查看在集成多种应用框架下创建的应用信息。

概念先解

名词 描述
调用数 统计应用 trace 请求数
错误率 应用失败请求的百分比

不同颜色表示不同错误率区间:
  • 绿:0-30
  • 橙:31-70
  • 红:71-100
  • 总 Token 数 应用消耗的总 Token 数,统计所有 tracetotal_tokens,即总和
    P50/P75 耗时 统计应用 P50/P75 请求时间(duration

    创建应用

    进入新建应用页,目前默认支持接入 Langfuse

    1. 定义应用名称与应用 ID;

    2. 系统自动生成配置参数;

    3. 默认生成 Client Token,您可按需更换;

    4. 选择接入配置;

    5. 点击“创建”。

    什么是 Client Token?

    创建应用后,系统会为您自动生成一个 Client Token,此令牌用于从用户设备中发送数据。

    更多详情,可参考 Client Token 管理

    创建成功后,可前往“应用列表”页查看。

    接入配置

    此处一般支持三类:

    接入 Python

    接入 JS/TS

    接入其他模型/框架

    接入 Python

    1. 安装依赖:

    pip install langfuse
    

    2. 初始化客户端:

    在您的应用环境中设置以下环境变量:

    LANGFUSE_PUBLIC_KEY="app_id"
    LANGFUSE_SECRET_KEY="llm_bb0f30d.....66eec"
    LANGFUSE_HOST="https://llm-openway.guance.com"
    

    在代码中初始化:

    from langfuse import Langfuse
    langfuse = Langfuse()
    

    直接在代码中传递配置参数:

    from langfuse import Langfuse
    langfuse = Langfuse(
      public_key="app_id",
      secret_key="llm_bb0f30d.....66eec",
      host="https://llm-openway.guance.com"
    )
    

    3. 验证连接:

    您可以使用 langfuse.auth_check() 验证是否接入成功。不建议在生产中使用它,因为这会增加应用程序的延迟。

    from langfuse import Langfuse
    # 初始化(通过参数构造)
    langfuse = Langfuse(
      public_key="app_id",
      secret_key="llm_bb0f30d.....66eec",
      host="https://llm-openway.guance.com"
    )
    # 验证连接,这是一个同步调用,生产环境不建议使用,此方法仅用于验证配置
    if langfuse.auth_check():
      print("Langfuse client is authenticated and ready!")
    

    如果接入失败,您可能会遇到以下错误:

    langfuse.api.resources.commons.errors.unauthorized_error.UnauthorizedError: status_code: 401, body: {}
    

    出现此错误通常表示 App ID 或 Client Token 不正确,请检查您的参数配置。

    有关更多详细信息和端到端示例,可参考 Python

    接入 JS/TS

    1. 安装依赖:

    npm install @langfuse/client
    

    2. 初始化客户端:

    在您的应用环境中设置以下环境变量:

    LANGFUSE_SECRET_KEY="llm_bb0f30d.....66eec"
    LANGFUSE_PUBLIC_KEY="pk-lf-..."
    LANGFUSE_BASE_URL="https://cloud.langfuse.com",
    

    在代码中初始化:

    import { LangfuseClient } from "@langfuse/client";
    const langfuse = new LangfuseClient();
    

    直接在代码中传递配置参数:

    import { LangfuseClient } from "@langfuse/client";
    const langfuse = new LangfuseClient({
      publicKey: "your-public-key",
      secretKey:"llm_bb0f30d.....66eec",
      baseUrl: "https://cloud.langfuse.com", // or your self-hosted instance
    });
    

    有关更多详细信息和端到端示例,可参考 JS/TS

    接入其他

    若您需要接入其他模型/框架的集成,例如:DeepSeek、Ollama、LangChain、Dify 等,可参考 Langfuse 官方完整文档进行配置

    应用列表

    在应用列表,您可以查看应用的名称、调用数、错误率、总 Token 数、P50/P75 耗时等信息。

    可通过以下操作对列表进行管理:

    • 按应用名称搜索定位;

    • 通过时间控件选择时间范围进行筛选;

    • 编辑/删除应用;

    • 点击单条应用,即可直接跳转至以该应用为查询条件的查看器页面。

    更多阅读

    文档评价

    文档内容是否对您有帮助? ×