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

# Collega Langfuse a CometAPI

> Usa questa guida per collegare Langfuse a CometAPI impostando l'URL di base, la chiave API e le opzioni del modello o del provider.

[Langfuse](https://langfuse.com/) offre osservabilità LLM, gestione dei prompt, playground e flussi di lavoro di valutazione. Configura una connessione LLM di Langfuse con CometAPI quando vuoi che Langfuse Playground o le valutazioni LLM-as-a-Judge chiamino i modelli CometAPI.

## Prerequisiti

* Un progetto Langfuse Cloud o un'istanza Langfuse self-hosted
* Un account CometAPI con una chiave API attiva — [ottieni la tua nella dashboard](https://www.cometapi.com/console/token)
* Almeno un model ID di CometAPI selezionato dalla [pagina dei modelli CometAPI](/it/overview/models)

## Configura l'integrazione

<Steps>
  <Step title="Crea una connessione LLM di Langfuse">
    In Langfuse, apri **Project Settings** → **LLM Connections**. Avvia la procedura per aggiungere una chiave API LLM.
  </Step>

  <Step title="Scegli l'adattatore OpenAI">
    Seleziona **OpenAI** come provider. Langfuse usa questo adattatore per i provider di modelli che supportano lo schema API OpenAI.
  </Step>

  <Step title="Inserisci le credenziali di CometAPI">
    Configura la connessione con questi valori:

    | Field            | Value                                                                       |
    | ---------------- | --------------------------------------------------------------------------- |
    | Chiave API       | La tua chiave API CometAPI                                                  |
    | URL di base      | `https://api.cometapi.com/v1`                                               |
    | Custom model IDs | Uno o più model ID dalla [pagina dei modelli CometAPI](/it/overview/models) |

    Se Langfuse mostra il campo dell'URL di base in **Advanced Settings**, espandi quella sezione prima di salvare la connessione.
  </Step>

  <Step title="Testa in Playground">
    In Langfuse Playground, seleziona la connessione LLM di CometAPI e uno dei model ID configurati. Invia un prompt breve per confermare che Langfuse riceva una risposta.
  </Step>
</Steps>

## Usa CometAPI per LLM-as-a-Judge

I valutatori LLM-as-a-Judge di Langfuse possono usare la stessa connessione LLM. Seleziona la connessione CometAPI nella configurazione del valutatore, quindi scegli un model ID che supporti il tool calling se il tuo prompt di valutazione richiede un'estrazione strutturata.

Usa le opzioni del provider solo quando il modello CometAPI selezionato supporta quei campi della richiesta. Per individuare i modelli, usa la [pagina dei modelli CometAPI](/it/overview/models) o l'API `/v1/models`.

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Il modello non è visibile in Langfuse">
    Aggiungi l'esatto model ID di CometAPI all'elenco dei custom model IDs nella connessione LLM. Langfuse non rileva automaticamente ogni modello per i provider personalizzati compatibili con OpenAI.
  </Accordion>

  <Accordion title="La richiesta usa il percorso API sbagliato">
    Usa `https://api.cometapi.com/v1` come URL di base. Langfuse aggiunge il percorso compatibile con OpenAI per l'adattatore selezionato.
  </Accordion>

  <Accordion title="Le chiamate del valutatore non riescono">
    Conferma che il modello selezionato supporti le funzionalità di richiesta usate dal valutatore, come tool calling o output JSON.
  </Accordion>
</AccordionGroup>

## Risorse correlate

* [Connessioni LLM di Langfuse](https://langfuse.com/docs/administration/llm-connection)
* [Avvio rapido di CometAPI](/it/overview/quick-start)
* [Pagina Models di CometAPI](/it/overview/models)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/langfuse#howto",
        "name": "Collega Langfuse a CometAPI",
        "description": "Usa questa guida per collegare Langfuse a CometAPI impostando l'URL di base, la chiave API e le opzioni del model o del provider.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-1",
            "position": 1,
            "name": "Crea una connessione LLM di Langfuse",
            "text": "Completa il passaggio Crea una connessione LLM di Langfuse nella guida Collega Langfuse a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-2",
            "position": 2,
            "name": "Scegli l'adapter OpenAI",
            "text": "Completa il passaggio Scegli l'adapter OpenAI nella guida Collega Langfuse a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-3",
            "position": 3,
            "name": "Inserisci le credenziali CometAPI",
            "text": "Completa il passaggio Inserisci le credenziali CometAPI nella guida Collega Langfuse a CometAPI."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/langfuse#step-4",
            "position": 4,
            "name": "Esegui il test nel Playground",
            "text": "Completa il passaggio Esegui il test nel Playground nella guida Collega Langfuse a CometAPI."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "Documentazione CometAPI",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Integrazioni",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "Collega Langfuse a CometAPI",
            "item": "https://apidoc.cometapi.com/integrations/langfuse"
          }
        ]
      }
    ]
    }
    `}
</script>