Langfuse 提供 LLM 可观测性、Prompt 管理、playground 和评估工作流。当你希望 Langfuse Playground 或 LLM-as-a-Judge 评估调用 CometAPI 模型时,请将 Langfuse 的 LLM Connection 配置为使用 CometAPI。Documentation Index
Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
Use this file to discover all available pages before exploring further.
前提条件
- 一个 Langfuse Cloud 项目或自托管的 Langfuse 实例
- 一个拥有有效 API key 的 CometAPI 账户 — 在控制台中获取
- 至少一个从 CometAPI Models page 中选择的 CometAPI model ID
配置集成
输入 CometAPI 凭证
使用以下值配置连接:
如果 Langfuse 将 base URL 字段放在 Advanced Settings 下,请在保存连接前展开该部分。
| Field | Value |
|---|---|
| API key | 你的 CometAPI API key |
| Base URL | https://api.cometapi.com/v1 |
| Custom model IDs | 来自 CometAPI Models page 的一个或多个 model ID |
将 CometAPI 用于 LLM-as-a-Judge
Langfuse LLM-as-a-Judge 评估器可以使用同一个 LLM connection。在评估器配置中选择 CometAPI 连接,然后选择一个支持 tool calling 的 model ID(如果你的评分 Prompt 需要结构化提取)。 仅当所选的 CometAPI 模型支持这些请求字段时,才使用 provider options。要发现模型,请使用 CometAPI Models page 或/v1/models API。
故障排查
模型在 Langfuse 中不可见
模型在 Langfuse 中不可见
将精确的 CometAPI model ID 添加到 LLM connection 的 custom model IDs 列表中。对于自定义的 OpenAI 兼容提供方,Langfuse 不会自动发现每一个模型。
请求使用了错误的 API 路径
请求使用了错误的 API 路径
使用
https://api.cometapi.com/v1 作为 base URL。Langfuse 会为所选适配器追加 OpenAI 兼容路径。评估器调用失败
评估器调用失败
确认所选模型支持评估器使用的请求功能,例如 tool calling 或 JSON 输出。