> ## 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, задав base URL, API key и параметры model или provider.

[Langfuse](https://langfuse.com/) предоставляет observability для LLM, управление prompt, playground-среды и рабочие процессы оценки. Настройте LLM Connection в Langfuse с CometAPI, если хотите, чтобы Langfuse Playground или оценки LLM-as-a-Judge вызывали модели CometAPI.

## Предварительные требования

* Проект Langfuse Cloud или самостоятельно размещённый экземпляр Langfuse
* Аккаунт CometAPI с активным API key — [получите его в панели управления](https://www.cometapi.com/console/token)
* Как минимум один model ID CometAPI, выбранный на [странице моделей CometAPI](/ru/overview/models)

## Настройка интеграции

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

  <Step title="Выберите адаптер OpenAI">
    Выберите **OpenAI** в качестве provider. Langfuse использует этот адаптер для provider моделей, которые поддерживают схему OpenAI API.
  </Step>

  <Step title="Введите учётные данные CometAPI">
    Настройте подключение со следующими значениями:

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

    Если в Langfuse поле base URL находится в разделе **Advanced Settings**, раскройте этот раздел перед сохранением подключения.
  </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. Выберите подключение CometAPI в конфигурации оценщика, затем выберите model ID, который поддерживает tool calling, если ваш scoring prompt требует структурированного извлечения.

Используйте параметры provider только в том случае, если выбранная модель CometAPI поддерживает эти поля запроса. Для поиска моделей используйте [страницу моделей CometAPI](/ru/overview/models) или API `/v1/models`.

## Устранение неполадок

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

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

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

## Связанные ресурсы

* [Подключения Langfuse LLM](https://langfuse.com/docs/administration/llm-connection)
* [Быстрый старт CometAPI](/ru/overview/quick-start)
* [Страница моделей CometAPI](/ru/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, а также параметры модели или провайдера.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-1",
            "position": 1,
            "name": "Создайте подключение Langfuse LLM",
            "text": "Выполните шаг Create a Langfuse LLM connection в руководстве Connect Langfuse to CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-2",
            "position": 2,
            "name": "Выберите адаптер OpenAI",
            "text": "Выполните шаг Choose the OpenAI adapter в руководстве Connect Langfuse to CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-3",
            "position": 3,
            "name": "Введите учетные данные CometAPI",
            "text": "Выполните шаг Enter CometAPI credentials в руководстве Connect Langfuse to CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-4",
            "position": 4,
            "name": "Протестируйте в Playground",
            "text": "Выполните шаг Test in Playground в руководстве Connect Langfuse to 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>