AI Glot websiteOpen AI Glot
WorkspaceRisoluzione dei problemi
Workspace

Risoluzione dei problemi

Risolvi i problemi più comuni di AI Glot relativi a caricamento, mappatura, crediti, avanzamento, download e accesso agli strumenti per sviluppatori senza perdere il lavoro svolto.

Apri la sezione che corrisponde al problema riscontrato. Le soluzioni qui riportate non eliminano una traduzione e non consumano altri crediti.

Il CSV viene rifiutato prima del caricamento

Esportalo di nuovo come CSV UTF-8 e verifica che non ci siano intestazioni vuote o duplicate, virgolette non chiuse o righe con un numero diverso di colonne. I limiti di caricamento dipendono dal formato: 60 MB per CSV, 4 MB per un file locale. Consulta File e formati.

Una cella è troppo lunga da tradurre

Ogni singola cella sorgente selezionata per la traduzione può contenere fino a 50,000 caratteri Unicode. Se il contenuto HTML o editoriale è più lungo, suddividilo in più righe o campi più piccoli, quindi carica il CSV aggiornato. Questo limite riguarda una singola cella ed è distinto dal limite inferiore usato per raggruppare le celle normali in attività di traduzione.

Il piano include colonne o lingue sbagliate

Il piano è una proposta. Indica in parole semplici cosa modificare, ad esempio “solo la colonna della descrizione” o “lascia stare la colonna SKU”, quindi controlla la tabella degli elementi per vedere esattamente quali valori verranno inviati. Non viene addebitato nulla finché non approvi.

La stima dei crediti sembra troppo alta

Il costo si basa sul numero di parole conteggiato nei contenuti che il piano tradurrà. Apri la tabella degli elementi per vedere quali valori sono inclusi e modifica l’istruzione per escludere ID, URL o metadati non necessari. Tradurre in più lingue moltiplica il conteggio sorgente per il numero di lingue di destinazione. I piani a pagamento consentono di usare Lite per i contenuti idonei da tradurre in blocco, a circa un terzo del costo di Standard.

La traduzione sembra lenta

Lascia aperta la pagina del batch per visualizzare la fase e la percentuale in tempo reale, ma il processo continua anche se esci. Più lingue di destinazione, numerose celle brevi e i tentativi ripetuti possono richiedere più tempo rispetto a un file di dimensioni simili con una sola lingua di destinazione. AI Glot ti invia un’email al completamento.

Se l’avanzamento non cambia per un periodo prolungato, ricarica la pagina una volta. Fa fede lo stato sul server, non l’animazione del browser. In caso di errore definitivo, i crediti riservati vengono restituiti automaticamente e viene mostrato un messaggio di errore sicuro.

Il file scaricato non viene importato

Confrontalo con l’esportazione originale: delimitatore, intestazioni, numero di colonne e identificativi delle righe devono corrispondere. AI Glot li preserva, ma il sistema di destinazione può avere requisiti specifici relativi a campi obbligatori, lunghezza dei valori o codici locali.

L'autenticazione API, CLI o MCP non riesce

Verifica che la credenziale sia attiva, appartenga allo spazio di lavoro previsto e abbia l’ambito richiesto. Per i problemi con la CLI, esegui aiglot doctor. In caso di errori strutturati dell’API, segui docs_url e comunica il valore request_id restituito quando contatti l’assistenza.

Uno strumento non avvia una traduzione

Controlla l’ambito, non lo strumento: la REST API, gli strumenti MCP e la CLI possono tutti avviare una traduzione. Per creare e approvare è necessario batches:create. Anche la connessione di un membro deve avere questo ambito, entro i limiti di autorizzazione dello spazio di lavoro. I nuovi spazi di lavoro lo includono, ma quelli creati prima del 31 agosto 2026 potrebbero non averlo: un amministratore potrebbe doverlo selezionare nella scheda Permissions di Strumenti per sviluppatori. Se si prova ad approvare senza aver prima pianificato, viene restituito no_plan_yet.

Contatta l’assistenza

Se i passaggi precedenti non risolvono il problema, apri Assistenza nell’app. Se pertinenti, includi il nome dello spazio di lavoro, l’ID del batch e l’ID della richiesta, ma non condividere mai una chiave API o un token di accesso.

Pagina Guida e assistenza con un pulsante Chat dal vivo, un pulsante Assistenza via email e l'indirizzo dell'assistenza

La pagina Guida e assistenza offre chat dal vivo e supporto via email

Chat dal vivo apre una finestra di chat nell’angolo della pagina, mentre Assistenza via email apre un messaggio all’indirizzo indicato. In genere riceverai una risposta entro un giorno lavorativo.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search AI Glot Docs documentation and read it in full, instead of answering from memory.

https://ai-glot.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://ai-glot.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.