6. Risoluzione dei problemi e supporto - Logicc Centro assistenza

16. Gestione degli errori e risoluzione dei problemi

Errore o sintomo	Causa probabile	Azione consigliata
401 con LiteLLM_VerificationTokenTable o token_not_found_in_db	Una nuova chiave Logicc viene inviata al precedente endpoint LiteLLM.	Utilizzate https://api.logicc.cloud/v1 e rimuovete il precedente Base URL api.logicc.io.
401 Authorization failed o virtual_key_not_found	La chiave manca, non è valida, è stata revocata o viene inviata nell'header errato.	Verificate la chiave completa e l'header Authorization. Richiedete una chiave sostitutiva se quella attuale funzionava in precedenza.
GET /v1/models funziona, ma manca un modello necessario	La chiave è valida, ma il modello o la route del provider non è abilitata per la chiave.	Inviate gli ID dei modelli richiesti al supporto Logicc. L'endpoint Models è autorevole per ogni chiave.
429 o RESOURCE_EXHAUSTED	È stata raggiunta una quota di richieste, token, provider o account.	Riducete la concorrenza, riprovate con backoff esponenziale e controllate l'endpoint della quota prima di contattare il supporto.
messages.*.tool_use.input must be a valid dictionary	Una chiamata a uno strumento contiene una stringa, un elenco o un JSON non valido anziché un oggetto.	Assicuratevi che ogni input dello strumento sia un oggetto JSON valido, compresi gli input vuoti rappresentati da {}.
Function tools with reasoning_effort are not supported	Il modello selezionato non supporta questa combinazione di parametri nelle Chat Completions.	Impostate reasoning_effort su none per questa richiesta oppure utilizzate un modello e un endpoint compatibili.
Un client di terze parti non funziona mentre cURL funziona	Il client potrebbe sovrascrivere il Base URL, gli header, l'ID del modello o lo schema della richiesta.	Confrontate la richiesta in uscita con l'esempio cURL e verificate il supporto degli endpoint personalizzati compatibili con OpenAI.

Per i carichi di produzione, configurate timeout espliciti di connessione e risposta, riprovate solo gli errori temporanei, limitate il numero di tentativi e preservate l'idempotenza quando una richiesta ripetuta potrebbe attivare un'azione esterna.

17. Checklist per la produzione

Conservate la chiave in un secret manager o in una variabile d'ambiente protetta.

Verificate il Base URL e gli header di autenticazione in ogni ambiente.

Individuate gli ID dei modelli abilitati tramite GET /v1/models durante la configurazione.

Impostate timeout espliciti e un numero limitato di nuovi tentativi per le risposte 429 e gli errori temporanei 5xx.

Convalidate gli input degli strumenti come oggetti JSON prima di inviare le richieste.

Registrate orario della richiesta, endpoint, ID del modello, codice di stato e ID della richiesta senza memorizzare dati riservati o contenuti sensibili.

Monitorate l'endpoint della quota e i rate limit tecnici.

Testate le funzionalità specifiche del modello, come streaming, strumenti, file, immagini e output strutturato, prima del rilascio.

Definite un comportamento di fallback per modelli non disponibili e interruzioni dei provider.

18. Supporto

Includete le seguenti informazioni per ricevere rapidamente assistenza tecnica:

Azienda e persona di contatto

Ambiente e versione del client o dell'SDK

Base URL ed endpoint completo

Identificativo del modello

Orario approssimativo e fuso orario

Codice di stato HTTP e corpo completo dell'errore

Richiesta minima riproducibile dopo la rimozione di tutti i dati riservati