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

# Conectar o Langfuse ao CometAPI

> Use este guia para conectar o Langfuse ao CometAPI definindo a URL base, a chave de API e as opções de model ou provider.

[Langfuse](https://langfuse.com/) oferece observabilidade de LLM, gerenciamento de prompt, playgrounds e fluxos de avaliação. Configure uma conexão de LLM do Langfuse com o CometAPI quando quiser que o Langfuse Playground ou as avaliações LLM-as-a-Judge chamem modelos do CometAPI.

## Pré-requisitos

* Um projeto Langfuse Cloud ou uma instância Langfuse auto-hospedada
* Uma conta CometAPI com uma chave de API ativa — [obtenha a sua no dashboard](https://www.cometapi.com/console/token)
* Pelo menos um model ID do CometAPI selecionado na [página de modelos do CometAPI](/pt/overview/models)

## Configurar a integração

<Steps>
  <Step title="Criar uma conexão de LLM no Langfuse">
    No Langfuse, abra **Project Settings** → **LLM Connections**. Inicie o fluxo para adicionar uma chave de API de LLM.
  </Step>

  <Step title="Escolher o adaptador OpenAI">
    Selecione **OpenAI** como provider. O Langfuse usa esse adaptador para provedores de modelo que oferecem suporte ao esquema de API da OpenAI.
  </Step>

  <Step title="Inserir credenciais do CometAPI">
    Configure a conexão com estes valores:

    | Field            | Value                                                                        |
    | ---------------- | ---------------------------------------------------------------------------- |
    | Chave de API     | Sua chave de API do CometAPI                                                 |
    | URL base         | `https://api.cometapi.com/v1`                                                |
    | Custom model IDs | Um ou mais model IDs da [página de modelos do CometAPI](/pt/overview/models) |

    Se o Langfuse expuser o campo de URL base em **Advanced Settings**, expanda essa seção antes de salvar a conexão.
  </Step>

  <Step title="Testar no Playground">
    No Langfuse Playground, selecione a conexão de LLM do CometAPI e um dos model IDs configurados. Envie um prompt curto para confirmar que o Langfuse recebe uma resposta.
  </Step>
</Steps>

## Usar o CometAPI para LLM-as-a-Judge

Os avaliadores LLM-as-a-Judge do Langfuse podem usar a mesma conexão de LLM. Selecione a conexão do CometAPI na configuração do avaliador e depois escolha um model ID que ofereça suporte a tool calling se o seu prompt de pontuação exigir extração estruturada.

Use opções de provider apenas quando o modelo CometAPI selecionado oferecer suporte a esses campos de requisição. Para descobrir modelos, use a [página de modelos do CometAPI](/pt/overview/models) ou a API `/v1/models`.

## Solução de problemas

<AccordionGroup>
  <Accordion title="O modelo não está visível no Langfuse">
    Adicione o model ID exato do CometAPI à lista de custom model IDs na conexão de LLM. O Langfuse não descobre automaticamente todos os modelos para provedores personalizados compatíveis com OpenAI.
  </Accordion>

  <Accordion title="A requisição usa o caminho de API incorreto">
    Use `https://api.cometapi.com/v1` como URL base. O Langfuse acrescenta o caminho compatível com OpenAI para o adaptador selecionado.
  </Accordion>

  <Accordion title="As chamadas do avaliador falham">
    Confirme que o modelo selecionado oferece suporte aos recursos de requisição usados pelo avaliador, como tool calling ou saída em JSON.
  </Accordion>
</AccordionGroup>

## Recursos relacionados

* [Conexões de LLM do Langfuse](https://langfuse.com/docs/administration/llm-connection)
* [Início rápido do CometAPI](/pt/overview/quick-start)
* [Página de Models do CometAPI](/pt/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/langfuse#howto",
        "name": "Conectar o Langfuse ao CometAPI",
        "description": "Use este guia para conectar o Langfuse ao CometAPI definindo a URL base, a chave de API e as opções de model ou provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-1",
            "position": 1,
            "name": "Criar uma conexão LLM no Langfuse",
            "text": "Conclua a etapa Criar uma conexão LLM no Langfuse no guia Conectar o Langfuse ao CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-2",
            "position": 2,
            "name": "Escolher o adaptador OpenAI",
            "text": "Conclua a etapa Escolher o adaptador OpenAI no guia Conectar o Langfuse ao CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-3",
            "position": 3,
            "name": "Inserir as credenciais do CometAPI",
            "text": "Conclua a etapa Inserir as credenciais do CometAPI no guia Conectar o Langfuse ao CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-4",
            "position": 4,
            "name": "Testar no Playground",
            "text": "Conclua a etapa Testar no Playground no guia Conectar o Langfuse ao CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentação do CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrações",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Conectar o Langfuse ao CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/langfuse"
          }
        ]
      }
    ]
    }
    `}
</script>