> ## 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 连接到 CometAPI

> 使用本指南通过设置 base URL、API key 以及 model 或 provider 选项，将 Langfuse 连接到 CometAPI。

[Langfuse](https://langfuse.com/) 提供 LLM 可观测性、Prompt 管理、playground 和评估工作流。当你希望 Langfuse Playground 或 LLM-as-a-Judge 评估调用 CometAPI 模型时，请在 Langfuse 中将 CometAPI 配置为 LLM Connection。

## 前提条件

* 一个 Langfuse Cloud 项目或自托管的 Langfuse 实例
* 一个具有有效 API key 的 CometAPI 账户 — [在控制台获取](https://www.cometapi.com/console/token)
* 至少一个从 [CometAPI Models 页面](/zh-Hans/overview/models) 选择的 CometAPI model ID

## 配置集成

<Steps>
  <Step title="创建 Langfuse LLM connection">
    在 Langfuse 中，打开 **Project Settings** → **LLM Connections**。开始添加 LLM API key 的流程。
  </Step>

  <Step title="选择 OpenAI 适配器">
    选择 **OpenAI** 作为 provider。对于支持 OpenAI API schema 的模型 provider，Langfuse 会使用此适配器。
  </Step>

  <Step title="输入 CometAPI 凭证">
    使用以下值配置该连接：

    | Field            | Value                                                             |
    | ---------------- | ----------------------------------------------------------------- |
    | API key          | 你的 CometAPI API key                                               |
    | Base URL         | `https://api.cometapi.com/v1`                                     |
    | Custom model IDs | 来自 [CometAPI Models 页面](/zh-Hans/overview/models) 的一个或多个 model ID |

    如果 Langfuse 将 base URL 字段放在 **Advanced Settings** 下，请在保存连接前展开该部分。
  </Step>

  <Step title="在 Playground 中测试">
    在 Langfuse Playground 中，选择 CometAPI LLM connection 以及一个已配置的 model ID。发送一个简短的 Prompt，以确认 Langfuse 收到了响应。
  </Step>
</Steps>

## 将 CometAPI 用于 LLM-as-a-Judge

Langfuse 的 LLM-as-a-Judge evaluator 也可以使用同一个 LLM connection。在 evaluator 配置中选择 CometAPI connection，然后选择一个支持 tool calling 的 model ID（如果你的评分 Prompt 需要结构化提取）。

仅当所选 CometAPI model 支持这些请求字段时才使用 provider 选项。要发现可用 model，请使用 [CometAPI Models 页面](/zh-Hans/overview/models) 或 `/v1/models` API。

## 故障排查

<AccordionGroup>
  <Accordion title="在 Langfuse 中看不到 model">
    将准确的 CometAPI model ID 添加到 LLM connection 的 custom model IDs 列表中。对于自定义的 OpenAI-compatible provider，Langfuse 不会自动发现每一个 model。
  </Accordion>

  <Accordion title="请求使用了错误的 API 路径">
    使用 `https://api.cometapi.com/v1` 作为 base URL。Langfuse 会为所选适配器追加 OpenAI-compatible 路径。
  </Accordion>

  <Accordion title="Evaluator 调用失败">
    确认所选 model 支持 evaluator 使用的请求功能，例如 tool calling 或 JSON 输出。
  </Accordion>
</AccordionGroup>

## 相关资源

* [Langfuse LLM 连接](https://langfuse.com/docs/administration/llm-connection)
* [CometAPI 快速开始](/zh-Hans/overview/quick-start)
* [CometAPI 模型页面](/zh-Hans/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/langfuse#howto",
        "name": "将 Langfuse 连接到 CometAPI",
        "description": "使用本指南，通过设置 base URL、API key 以及 model 或 provider 选项，将 Langfuse 连接到 CometAPI。",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-1",
            "position": 1,
            "name": "创建 Langfuse LLM 连接",
            "text": "完成“将 Langfuse 连接到 CometAPI”指南中的“创建 Langfuse LLM 连接”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-2",
            "position": 2,
            "name": "选择 OpenAI 适配器",
            "text": "完成“将 Langfuse 连接到 CometAPI”指南中的“选择 OpenAI 适配器”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-3",
            "position": 3,
            "name": "输入 CometAPI 凭证",
            "text": "完成“将 Langfuse 连接到 CometAPI”指南中的“输入 CometAPI 凭证”步骤。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-4",
            "position": 4,
            "name": "在 Playground 中测试",
            "text": "完成“将 Langfuse 连接到 CometAPI”指南中的“在 Playground 中测试”步骤。"
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI 文档",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "集成",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "将 Langfuse 连接到 CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/langfuse"
          }
        ]
      }
    ]
    }
    `}
</script>