> ## 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

> Скористайтеся цим посібником, щоб підключити Langfuse до CometAPI, налаштувавши базовий URL, API key та параметри model або provider.

[Langfuse](https://langfuse.com/) надає спостережуваність LLM, керування Prompt, playground-и та workflows для оцінювання. Налаштуйте Langfuse LLM Connection з CometAPI, якщо хочете, щоб Langfuse Playground або оцінювання LLM-as-a-Judge зверталися до моделей CometAPI.

## Передумови

* Проєкт Langfuse Cloud або self-hosted інстанс Langfuse
* Обліковий запис CometAPI з активним API key — [отримайте його в dashboard](https://www.cometapi.com/console/token)
* Щонайменше один model ID CometAPI, вибраний на [сторінці моделей CometAPI](/uk/overview/models)

## Налаштування інтеграції

<Steps>
  <Step title="Створіть Langfuse LLM connection">
    У Langfuse відкрийте **Project Settings** → **LLM Connections**. Запустіть процес додавання API key для LLM.
  </Step>

  <Step title="Виберіть адаптер OpenAI">
    Виберіть **OpenAI** як provider. Langfuse використовує цей адаптер для provider-ів моделей, які підтримують схему OpenAI API.
  </Step>

  <Step title="Введіть облікові дані CometAPI">
    Налаштуйте connection, використовуючи такі значення:

    | Field            | Value                                                                        |
    | ---------------- | ---------------------------------------------------------------------------- |
    | API key          | Ваш API key CometAPI                                                         |
    | Base URL         | `https://api.cometapi.com/v1`                                                |
    | Custom model IDs | Один або кілька model ID зі [сторінки моделей CometAPI](/uk/overview/models) |

    Якщо Langfuse показує поле base URL у розділі **Advanced Settings**, розгорніть цей розділ перед збереженням connection.
  </Step>

  <Step title="Протестуйте в Playground">
    У Langfuse Playground виберіть LLM connection CometAPI та один із налаштованих model ID. Надішліть короткий Prompt, щоб підтвердити, що Langfuse отримує відповідь.
  </Step>
</Steps>

## Використання CometAPI для LLM-as-a-Judge

Оцінювачі Langfuse LLM-as-a-Judge можуть використовувати той самий LLM connection. Виберіть connection CometAPI в конфігурації оцінювача, а потім виберіть model ID, який підтримує tool calling, якщо ваш Prompt для оцінювання потребує структурованого вилучення.

Використовуйте параметри provider лише тоді, коли вибрана модель CometAPI підтримує ці поля запиту. Для пошуку моделей використовуйте [сторінку моделей CometAPI](/uk/overview/models) або API `/v1/models`.

## Усунення несправностей

<AccordionGroup>
  <Accordion title="Модель не відображається в Langfuse">
    Додайте точний model ID CometAPI до списку custom model IDs у LLM connection. Langfuse не виявляє автоматично кожну модель для кастомних OpenAI-compatible provider-ів.
  </Accordion>

  <Accordion title="Запит використовує неправильний шлях API">
    Використовуйте `https://api.cometapi.com/v1` як base URL. Langfuse додає OpenAI-compatible шлях для вибраного адаптера.
  </Accordion>

  <Accordion title="Виклики оцінювача завершуються помилкою">
    Переконайтеся, що вибрана модель підтримує функції запиту, які використовує оцінювач, наприклад tool calling або JSON output.
  </Accordion>
</AccordionGroup>

## Пов’язані ресурси

* [Підключення Langfuse LLM](https://langfuse.com/docs/administration/llm-connection)
* [Швидкий старт CometAPI](/uk/overview/quick-start)
* [Сторінка Models у CometAPI](/uk/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": "Скористайтеся цим посібником, щоб підключити Langfuse до CometAPI, налаштувавши base URL, API key і параметри model або provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-1",
            "position": 1,
            "name": "Створіть LLM-підключення Langfuse",
            "text": "Виконайте крок «Створіть LLM-підключення Langfuse» у посібнику «Підключення Langfuse до CometAPI»."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-2",
            "position": 2,
            "name": "Виберіть адаптер OpenAI",
            "text": "Виконайте крок «Виберіть адаптер OpenAI» у посібнику «Підключення Langfuse до CometAPI»."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-3",
            "position": 3,
            "name": "Введіть облікові дані CometAPI",
            "text": "Виконайте крок «Введіть облікові дані CometAPI» у посібнику «Підключення Langfuse до CometAPI»."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-4",
            "position": 4,
            "name": "Протестуйте в Playground",
            "text": "Виконайте крок «Протестуйте в Playground» у посібнику «Підключення Langfuse до CometAPI»."
          }
        ]
      },
      {
        "@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>