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.
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 JSONLes 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.
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.
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
doneVoici 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 ?
| Statut | Signification | Qui attend | Terminal |
|---|---|---|---|
analyzing | la structure du fichier est en cours d’analyse | nous, quelques secondes | |
awaiting_instructions | le fichier a été lu ; aucune demande n’a encore été formulée | vous | |
awaiting_approval | un plan est prêt et son coût a été calculé | vous | |
translating | traitement en cours ; seul état ayant consommé des crédits | nous | |
completed | terminé, un fichier de résultat est disponible | personne | ✓ |
failed | terminé sans résultat ; consultez error.code | vous, pour réessayer | ✓ |
cancelled | arrêté délibérément, seuls les travaux effectués sont facturés | personne | ✓ |
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) :
aiglot batches list --status completed --all
aiglot glossaries list --all --output ndjsonAvec --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 :
export AIGLOT_API_KEY="aig_live_…"
aiglot account --jsonLa 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
| Code | Signification |
|---|---|
| 0 | Réussite |
| 1 | Erreur d’API ou de serveur |
| 2 | Commande ou arguments invalides |
| 3 | Échec d’authentification ou d’autorisation |
| 4 | Ressource introuvable |
| 5 | Limite de requêtes atteinte |
| 6 | Conflit 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 :
aiglot --profile client-a auth login --key "$CLIENT_A_KEY"
aiglot --profile client-a account
export AIGLOT_PROFILE=client-aVariables d’environnement
| Variable | Rôle |
|---|---|
AIGLOT_API_KEY | Clé API ; remplace les identifiants enregistrés |
AIGLOT_PROFILE | Profil d’identifiants nommé |
AIGLOT_NO_TUI | Force l’affichage dans un format lisible par machine |
AIGLOT_NO_KEYCHAIN | Ignore le trousseau de clés du système d’exploitation |
NO_COLOR | Standard (no-color.org). Désactive uniquement les couleurs ; ne modifie pas le format de sortie |