> ## 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 模型時，請使用 CometAPI 設定 Langfuse LLM Connection。

## 先決條件

* 一個 Langfuse Cloud 專案或自行託管的 Langfuse 執行個體
* 一個具有有效 API key 的 CometAPI 帳戶 — [在控制台取得你的 API key](https://www.cometapi.com/console/token)
* 至少一個從 [CometAPI Models 頁面](/zh-Hant/overview/models) 選取的 CometAPI model ID

## 設定整合

<Steps>
  <Step title="建立 Langfuse LLM connection">
    在 Langfuse 中，開啟 **Project Settings** → **LLM Connections**。開始新增 LLM API key 的流程。
  </Step>

  <Step title="選擇 OpenAI adapter">
    選擇 **OpenAI** 作為 provider。Langfuse 會將此 adapter 用於支援 OpenAI API 結構描述的模型 provider。
  </Step>

  <Step title="輸入 CometAPI 憑證">
    使用以下值設定 connection：

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

    如果 Langfuse 將 base URL 欄位放在 **Advanced Settings** 底下，請先展開該區段再儲存 connection。
  </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 評估器可以使用相同的 LLM connection。如果你的評分 Prompt 需要結構化擷取，請在評估器設定中選擇 CometAPI connection，然後選擇一個支援 tool calling 的 model ID。

只有在所選的 CometAPI 模型支援這些請求欄位時，才使用 provider 選項。若要探索模型，請使用 [CometAPI Models 頁面](/zh-Hant/overview/models) 或 `/v1/models` API。

## 疑難排解

<AccordionGroup>
  <Accordion title="Langfuse 中看不到模型">
    將確切的 CometAPI model ID 新增到 LLM connection 的 custom model IDs 清單中。對於自訂的 OpenAI-compatible provider，Langfuse 不會自動探索每個模型。
  </Accordion>

  <Accordion title="請求使用了錯誤的 API 路徑">
    請使用 `https://api.cometapi.com/v1` 作為 base URL。Langfuse 會為所選的 adapter 附加 OpenAI-compatible 路徑。
  </Accordion>

  <Accordion title="評估器呼叫失敗">
    確認所選模型支援評估器使用的請求功能，例如 tool calling 或 JSON 輸出。
  </Accordion>
</AccordionGroup>

## 相關資源

* [Langfuse LLM Connections](https://langfuse.com/docs/administration/llm-connection)
* [CometAPI 快速開始](/zh-Hant/overview/quick-start)
* [CometAPI 模型頁面](/zh-Hant/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，以及模型或供應商選項，將 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>