> ## 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) 관리, 플레이그라운드, 평가 워크플로를 제공합니다. Langfuse Playground 또는 LLM-as-a-Judge 평가가 CometAPI model을 호출하도록 하려면 CometAPI로 Langfuse LLM Connection을 구성하세요.

## 사전 요구 사항

* Langfuse Cloud 프로젝트 또는 자체 호스팅 Langfuse 인스턴스
* 활성 API key가 있는 CometAPI 계정 — [대시보드에서 발급받기](https://www.cometapi.com/console/token)
* [CometAPI Models 페이지](/ko/overview/models)에서 선택한 CometAPI model ID 최소 1개

## 통합 구성하기

<Steps>
  <Step title="Langfuse LLM connection 생성">
    Langfuse에서 **Project Settings** → **LLM Connections**를 엽니다. LLM API key 추가 흐름을 시작하세요.
  </Step>

  <Step title="OpenAI adapter 선택">
    provider로 **OpenAI**를 선택하세요. Langfuse는 OpenAI API 스키마를 지원하는 model provider에 이 adapter를 사용합니다.
  </Step>

  <Step title="CometAPI 자격 증명 입력">
    다음 값으로 connection을 구성하세요:

    | Field            | Value                                                      |
    | ---------------- | ---------------------------------------------------------- |
    | API key          | CometAPI API key                                           |
    | Base URL         | `https://api.cometapi.com/v1`                              |
    | Custom model IDs | [CometAPI Models 페이지](/ko/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>

## LLM-as-a-Judge에 CometAPI 사용하기

Langfuse LLM-as-a-Judge evaluator는 동일한 LLM connection을 사용할 수 있습니다. evaluator 구성에서 CometAPI connection을 선택한 다음, 채점 프롬프트(Prompt)에 구조화된 추출이 필요하다면 tool calling을 지원하는 model ID를 선택하세요.

선택한 CometAPI model이 해당 요청 필드를 지원하는 경우에만 provider 옵션을 사용하세요. model 탐색에는 [CometAPI Models 페이지](/ko/overview/models) 또는 `/v1/models` API를 사용하세요.

## 문제 해결

<AccordionGroup>
  <Accordion title="Langfuse에서 model이 보이지 않습니다">
    LLM connection의 custom model IDs 목록에 정확한 CometAPI model ID를 추가하세요. Langfuse는 사용자 지정 OpenAI 호환 provider에 대해 모든 model을 자동으로 검색하지 않습니다.
  </Accordion>

  <Accordion title="요청이 잘못된 API 경로를 사용합니다">
    base URL로 `https://api.cometapi.com/v1`을 사용하세요. Langfuse는 선택한 adapter에 맞는 OpenAI 호환 경로를 추가합니다.
  </Accordion>

  <Accordion title="Evaluator 호출이 실패합니다">
    선택한 model이 tool calling 또는 JSON output 등 evaluator가 사용하는 요청 기능을 지원하는지 확인하세요.
  </Accordion>
</AccordionGroup>

## 관련 리소스

* [Langfuse LLM 연결](https://langfuse.com/docs/administration/llm-connection)
* [CometAPI 빠른 시작](/ko/overview/quick-start)
* [CometAPI Models 페이지](/ko/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>