Strumenti MCP Standard

Il server Standard offre strumenti progettati per attività specifiche, invece di replicare uno per uno tutti gli endpoint REST.

Strumenti per account e utilizzo

Strumento per i feedback

Usa send_feedback quando il problema è chiaro. Descrivi la situazione, cosa è successo e cosa sarebbe dovuto succedere. Se li conosci, indica l’azione correlata, il modello di AI e l’ambiente dell’agente. Non includere chiavi API, token, URL firmati o il contenuto integrale dei file. Non costa crediti e non modifica una traduzione.

Gli strumenti per account e utilizzo sono di sola lettura e non consumano crediti.

Strumenti per le traduzioni

Per impostazione predefinita, lo strumento per i link ai risultati restituisce un URL di download temporaneo. Per i formati di testo inferiori a 2 MB, passa format: 'content' per ricevere il testo tradotto nella risposta dello strumento. update_batch modifica solo i metadati di gestione e l’archiviazione è reversibile.

Strumenti di traduzione

Questi strumenti fanno la differenza tra un agente che legge la tua area di lavoro e uno che può svolgere il lavoro. La sequenza è fissa (creazione, pianificazione, approvazione) e solo il terzo passaggio ha un costo.

Invio di un documento locale

Il client MCP deve poter leggere i byte del file originale ed effettuare una richiesta HTTP PUT al di fuori di MCP. Collegare un assistente ad AI Glot non gli dà automaticamente accesso agli allegati né a un client HTTP. AI Glot Code Mode non può effettuare questo trasferimento autonomamente.

1. Chiama create_upload_url specificando il filename senza percorso e il valore esatto di size_bytes.
2. Invia i byte originali a upload_url usando il method e le headers restituiti. L’intestazione Authorization è un segreto temporaneo utilizzabile solo per il caricamento. Non sostituirla mai con una chiave API dell’area di lavoro o un token OAuth, non seguire i reindirizzamenti, non registrarla nei log e non mostrarla all’utente.
3. Dopo aver caricato correttamente il file, chiama create_translation con upload_id e, facoltativamente, instruction, sulla stessa connessione AI Glot. È accettato uno solo tra upload_id, content e file_url. Con upload_id, ometti filename.
4. Esamina il piano verificato e plan.not_included, quindi controlla che l’utente abbia autorizzato il piano e il costo in crediti prima di chiamare approve_translation.

Il segreto di caricamento consente un solo tentativo di PUT entro 10 minuti. Crea la traduzione entro un’ora. Se la risposta alla PUT va persa, prova prima a chiamare create_translation con lo stesso upload_id. Se non è stato completato alcun caricamento, crea una nuova sessione. Ripetendo la creazione recuperi la stessa traduzione, senza applicare implicitamente eventuali istruzioni modificate; per perfezionarla, usa plan_translation. Il recupero tramite upload_id è disponibile fino alla pulizia della sessione, almeno 24 ore dopo il rilascio. Conserva l’ID del batch per ritrovare in seguito la traduzione nella cronologia.

Se l’ambiente di esecuzione non può leggere l’allegato locale o inviare richieste HTTP PUT, spiega subito questa limitazione. Per esempio: “Questo assistente può collegarsi ad AI Glot, ma non può inviare questo allegato locale. Carica il documento nell’app web di AI Glot, usa l’AI Glot CLI oppure fornisci un link di download HTTPS a cui AI Glot possa accedere.” Non dichiarare che il documento è stato caricato, non chiedere all’utente la sua chiave API e non approvare una traduzione senza aver verificato il file e il piano.

Puoi comunque inviare come file_url un documento già disponibile tramite un URL di download HTTPS accessibile. I file di testo di piccole dimensioni possono essere inviati direttamente come content. Consulta caricamenti temporanei per le richieste HTTP e le procedure di recupero.

Strumenti per i glossari

Per impostazione predefinita, edit_glossary_terms aggiunge i termini. replace_all: true elimina tutti i termini assenti dalla mappa fornita. Entrambi gli strumenti di modifica dei glossari sono contrassegnati come distruttivi perché possono rimuovere termini, così i client compatibili possono richiedere una conferma.

Risorsa delle lingue

Le lingue supportate sono disponibili nella risorsa MCP memorizzabile nella cache:

aiglot://languages

È esposta come risorsa perché contiene dati di riferimento statici. Consultala prima di creare un glossario per una coppia linguistica.

Risultati ed errori degli strumenti

Ogni strumento dichiara uno schema di input e restituisce contenuti strutturati insieme a una rappresentazione testuale leggibile. Il server Standard non dichiara schemi di output separati. Gli errori vengono restituiti come risultati leggibili dello strumento, con un code stabile e un URL alla documentazione, così il modello può correggere la richiesta invece di considerare un errore operativo come un problema di connessione MCP.