AI Glot websiteOpen AI Glot
WorkspaceRisoluzione dei problemi
Workspace

Risoluzione dei problemi

Risolvi i problemi comuni di caricamento, mapping, credits, progresso, download e accesso sviluppatori di AI Glot senza perdere il lavoro.

Apri il sintomo che corrisponde a quanto visualizzato. Le soluzioni riportate di seguito non eliminano le traduzioni né consumano credits aggiuntivi.

Il CSV viene rifiutato prima del caricamento

Esportalo nuovamente come CSV in formato UTF-8 e verifica l’assenza di intestazioni vuote o duplicate, virgolette non chiuse e righe con un numero diverso di colonne. Il caricamento massimo per gli utenti autenticati è di 35 MB. Consulta i requisiti CSV.

L'analisi ha scelto colonne o lingue errate

L’analisi è una proposta. Modifica il layout, la sorgente, la destinazione, la modalità lingua o le lingue di destinazione nella schermata di revisione prima di iniziare. Visualizza l’anteprima dei valori campione per distinguere le colonne dei contenuti da quelle degli ID o dei metadati.

La stima dei credits sembra troppo alta

Verifica quali celle sono incluse nel layout selezionato. Le colonne multilingue moltiplicano il conteggio della sorgente per il numero di destinazioni; il Full CSV include ogni cella di testo tradotta. I piani a pagamento possono utilizzare Lite per contenuti massivi idonei a circa un terzo del costo di Standard.

La traduzione sembra lenta

Tieni aperta la pagina del batch per vedere la fase in tempo reale e la percentuale, ma il lavoro continua anche se esci. Destinazioni multiple, molte celle brevi e i tentativi di rinvio possono richiedere più tempo rispetto a un file di dimensioni simili con una sola destinazione. AI Glot ti invierà un’email al termine.

Se il progresso non cambia per un periodo prolungato, ricarica la pagina una volta. Il server — e non l’animazione del browser — è l’autorità. Un errore terminale restituisce automaticamente i credits riservati e mostra un messaggio di errore sicuro.

Il file scaricato non viene importato

Confrontalo con l’esportazione originale: stesso delimitatore, intestazioni, numero di colonne e identificatori di riga. AI Glot preserva questi elementi, ma il sistema di destinazione potrebbe imporre i propri campi obbligatori, lunghezze dei valori o codici locale.

L'autenticazione API, CLI o MCP fallisce

Verifica che la credenziale sia attiva, appartenga al workspace previsto e abbia lo scope richiesto. Per i problemi con la CLI, esegui aiglot doctor. Per i fallimenti strutturati delle API, segui l’URL in docs_url e indica il request_id restituito quando contatti l’assistenza.

Lo strumento per sviluppatori non può avviare una traduzione

Questo è previsto nella v1. Il caricamento e la creazione di batch sono attualmente funzionalità dell’app web. L’API, la CLI e l’MCP operano su traduzioni e glossari esistenti senza spendere credits.

Contattare l’assistenza

Se i passaggi precedenti non risolvono il problema, apri Support nell’app. Includi il nome del workspace, l’ID del batch e l’ID della richiesta, se pertinente, ma non includere mai una chiave API o un token di accesso.

AI Glot support page

Il supporto offre chat dal vivo e assistenza via email

AI Glot support assistant

L'assistente in-app può aiutare con domande sul workflow CSV

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.