AI Glot websiteOpen AI Glot
CLI et MCPAutomatisation et sorties de la CLI

Automatisation et sorties de la CLI

Exécutez la CLI AI Glot en toute sécurité dans des scripts et des pipelines CI grâce à JSON ou NDJSON, aux identifiants d’environnement, aux profils, aux codes de sortie et aux nouvelles tentatives limitées.

La CLI affiche des tableaux lisibles dans un terminal et du JSON lorsque la sortie est redirigée. Une même commande fonctionne donc en mode interactif comme en automatisation.

Terminal
aiglot batches list                    # table on a terminal
aiglot batches list | jq '.data[0].id' # JSON when piped
aiglot batches list --output ndjson    # one object per line
aiglot account --json                  # explicit JSON

Les erreurs sont envoyées sur la sortie d’erreur standard, tout comme les avertissements que l’appelant doit voir, par exemple lorsqu’une page de résultats est tronquée. La sortie standard peut donc être redirigée sans risque vers un autre programme.

Attendre la fin d’une traduction

Préparez d’abord le plan, puis vérifiez sa portée, ses exclusions et le coût mesuré. La CLI renvoie directement les objets individuels : lisez .id, .status et .plan, et non .data.id ou .data.status. Les commandes de liste utilisent toujours un tableau data.

Terminal
set -euo pipefail

batch=$(aiglot batches create catalogue.csv --instruction "Translate into French" --json)
id=$(printf '%s' "$batch" | jq -er '.id')
printf '%s\n' "$batch" | jq '.plan'

Exécutez le bloc suivant uniquement lorsque le plan, la qualité Standard sélectionnée et le coût mesuré sont autorisés. Une autorisation existante suffit si elle les couvre. L’attente est limitée à 60 vérifications et s’arrête aux états completed, failed ou cancelled. En cas d’interruption ou de dépassement du délai, conservez l’ID du lot et reprenez son traitement sans créer une autre traduction.

Terminal
aiglot batches approve "$id" --quality standard --yes --json

for ((attempt = 0; attempt < 60; attempt++)); do
  status=$(aiglot batches get "$id" --timeout 15 --json | jq -er '.status')
  case "$status" in
    completed)
      aiglot batches download "$id" --output result.csv
      break
      ;;
    failed|cancelled)
      printf 'Batch %s ended with status %s.\n' "$id" "$status" >&2
      exit 1
      ;;
    awaiting_instructions|awaiting_approval)
      printf 'Batch %s needs a decision; inspect its plan before continuing.\n' "$id" >&2
      exit 2
      ;;
  esac
  if ((attempt == 59)); then
    printf 'Wait limit reached. Resume batch %s; do not create a duplicate.\n' "$id" >&2
    exit 1
  fi
  sleep 5
done

Voici tous les statuts qu’une traduction peut renvoyer, ainsi que les trois qui y mettent fin. Chacun répond à la même question : qui attend, et quoi ?

StatutSignificationQui attendTerminal
analyzingla structure du fichier est en cours d’analysenous, quelques secondes
awaiting_instructionsle fichier a été lu ; aucune demande n’a encore été formuléevous
awaiting_approvalun plan est prêt et son coût a été calculévous
translatingtraitement en cours ; seul état ayant consommé des créditsnous
completedterminé, un fichier de résultat est disponiblepersonne✓
failedterminé sans résultat ; consultez error.codevous, pour réessayer✓
cancelledarrêté délibérément, seuls les travaux effectués sont facturéspersonne✓

Pagination

batches list et glossaries list utilisent un curseur. Renvoyez sans modification le next_cursor de la réponse précédente avec --cursor, ou laissez --all le suivre jusqu’à ce que has_more soit false (avec une limite de 200 pages par précaution) :

Terminal
aiglot batches list --status completed --all
aiglot glossaries list --all --output ndjson

Avec --output ndjson, --all affiche chaque ligne de chaque page au fur et à mesure. En mode table ou json, la commande affiche un seul résultat combiné avec has_more: false, next_cursor: null et un décompte pages_fetched à la place de request_id, puisqu’il est impossible de désigner une seule requête lorsque plusieurs ont été exécutées.

Authentification en CI

Créez une clé API dédiée avec les autorisations minimales nécessaires et stockez-la dans le gestionnaire de secrets du fournisseur CI :

Terminal
export AIGLOT_API_KEY="aig_live_…"
aiglot account --json

La CLI vérifie les identifiants dans cet ordre : AIGLOT_API_KEY, trousseau de clés du système d’exploitation, puis fichier de configuration protégé.

Codes de sortie

CodeSignification
0Réussite
1Erreur d’API ou de serveur
2Commande ou arguments invalides
3Échec d’authentification ou d’autorisation
4Ressource introuvable
5Limite de requêtes atteinte
6Conflit lié à l’état de la ressource

Dans les scripts, utilisez le code de sortie ou le champ structuré error.code pour déterminer la suite à donner, et non le texte du message d’erreur.

Nouvelles tentatives

Les nouvelles tentatives sont automatiques, mais uniquement lorsqu’elles ne présentent aucun risque. Les erreurs 429 entraînent une nouvelle tentative pour toutes les commandes, en respectant Retry-After avec un délai exponentiel plafonné. Les erreurs 408 et 5xx ne déclenchent une nouvelle tentative que pour les requêtes idempotentes (RFC 9110 §9.2.2) : lectures, glossaries replace et glossaries delete.

Les commandes glossaries create, glossaries add, glossaries remove, batches rename et batches archive ne sont pas relancées après une erreur 5xx, car l’écriture a peut-être déjà été effectuée et une deuxième tentative l’appliquerait deux fois. Ces échecs sont transmis à votre script avec le code de sortie 1 : relisez la ressource et décidez vous-même s’il faut réessayer, au lieu de relancer la commande à l’aveugle.

Utilisez --no-retry si la gestion des nouvelles tentatives relève de l’appelant, et --timeout <seconds> (60 par défaut) pour limiter la durée d’une requête. Les commandes destructrices n’attendent jamais indéfiniment une réponse interactive : en mode non interactif, vous devez passer --force.

Profils

Utilisez des profils nommés pour séparer les identifiants de différents espaces de travail ou environnements :

Terminal
aiglot --profile client-a auth login --key "$CLIENT_A_KEY"
aiglot --profile client-a account
export AIGLOT_PROFILE=client-a

Variables d’environnement

VariableRôle
AIGLOT_API_KEYClé API ; remplace les identifiants enregistrés
AIGLOT_PROFILEProfil d’identifiants nommé
AIGLOT_NO_TUIForce l’affichage dans un format lisible par machine
AIGLOT_NO_KEYCHAINIgnore le trousseau de clés du système d’exploitation
NO_COLORStandard (no-color.org). Désactive uniquement les couleurs ; ne modifie pas le format de sortie

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.