Prerequisiti
- Un progetto Langfuse Cloud o un’istanza Langfuse self-hosted
- Un account CometAPI con una chiave API attiva — ottieni la tua nella dashboard
- Almeno un model ID di CometAPI selezionato dalla pagina dei modelli CometAPI
Configura l’integrazione
1
Crea una connessione LLM di Langfuse
In Langfuse, apri Project Settings → LLM Connections. Avvia la procedura per aggiungere una chiave API LLM.
2
Scegli l'adattatore OpenAI
Seleziona OpenAI come provider. Langfuse usa questo adattatore per i provider di modelli che supportano lo schema API OpenAI.
3
Inserisci le credenziali di CometAPI
Configura la connessione con questi valori:
Se Langfuse mostra il campo dell’URL di base in Advanced Settings, espandi quella sezione prima di salvare la connessione.
4
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.
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 o l’API/v1/models.
Risoluzione dei problemi
Il modello non è visibile in Langfuse
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.
La richiesta usa il percorso API sbagliato
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.Le chiamate del valutatore non riescono
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.