CLI-Automatisierung und Ausgabe
Führen Sie die AI Glot CLI sicher in Skripten und CI aus. Nutzen Sie JSON oder NDJSON, Anmeldedaten aus der Umgebung, Profile, Exit-Codes und begrenzte Wiederholungsversuche.
Die CLI gibt im Terminal gut lesbare Tabellen aus und bei Weiterleitung JSON. So funktioniert derselbe Befehl interaktiv und in der Automatisierung.
aiglot batches list # Tabelle im Terminal
aiglot batches list | jq '.data[0].id' # JSON bei Weiterleitung
aiglot batches list --output ndjson # ein Objekt pro Zeile
aiglot account --json # explizite JSON-AusgabeFehler werden auf die Standardfehlerausgabe geschrieben. Dort erscheinen auch Warnungen, die der aufrufende Prozess sehen muss, etwa wenn eine Ergebnisseite abgeschnitten wurde. Die Standardausgabe kann daher sicher an ein anderes Programm weitergeleitet werden.
Warten, bis eine Übersetzung abgeschlossen ist
Erstellen Sie zuerst den Plan und prüfen Sie seinen Umfang, die Ausschlüsse und die ermittelten Kosten.
Die CLI gibt einzelne Objekte direkt zurück: Lesen Sie .id, .status und .plan,
nicht .data.id oder .data.status. Bei Listenbefehlen wird weiterhin ein data-Array verwendet.
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'Führen Sie den nächsten Block erst aus, wenn der Plan, die gewählte Qualität Standard und die ermittelten Kosten freigegeben sind. Eine bereits vorliegende Freigabe genügt, sofern sie diese Punkte abdeckt. Die Wartezeit ist auf 60 Abfragen begrenzt. Beendet wird das Warten bei completed, failed oder cancelled. Wird der Vorgang unterbrochen oder läuft die Wartezeit ab, behalten Sie die Batch-ID und setzen Sie den Vorgang fort, ohne eine weitere Übersetzung anzulegen.
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
doneDies sind alle Status, die eine Übersetzung melden kann, einschließlich der drei Endstatus. Jeder beantwortet dieselbe Frage: Wer wartet und worauf?
| Status | Bedeutung | Wer wartet | Endstatus |
|---|---|---|---|
analyzing | Die Dateistruktur wird eingelesen | wir, einige Sekunden lang | |
awaiting_instructions | Die Datei ist eingelesen; es wurde noch kein Auftrag erteilt | Sie | |
awaiting_approval | Ein Plan liegt vor und die Kosten sind berechnet | Sie | |
translating | Läuft; nur in diesem Status werden Guthabenpunkte verbraucht | wir | |
completed | Abgeschlossen; eine Ergebnisdatei steht bereit | niemand | ✓ |
failed | Ohne Ergebnis beendet; lesen Sie error.code | Sie, um es erneut zu versuchen | ✓ |
cancelled | Bewusst gestoppt; berechnet wird nur die ausgeführte Arbeit | niemand | ✓ |
Seitennummerierung
batches list und glossaries list verwenden cursorbasierte Seitennummerierung. Übergeben Sie den next_cursor aus der vorherigen Antwort unverändert mit --cursor oder lassen Sie --all die Seiten automatisch abrufen, bis has_more den Wert false hat. Als zusätzliche Begrenzung werden höchstens 200 Seiten abgerufen:
aiglot batches list --status completed --all
aiglot glossaries list --all --output ndjsonBei --output ndjson gibt --all jede Zeile aus jeder Seite aus, sobald sie eintrifft. Im table- und json-Modus wird ein zusammengeführtes Ergebnis mit has_more: false, next_cursor: null und der Anzahl pages_fetched anstelle von request_id ausgegeben. Sobald mehrere Anfragen ausgeführt wurden, lässt sich keine einzelne Anfrage mehr angeben.
Authentifizierung in CI
Erstellen Sie einen dedizierten API-Schlüssel mit minimalem Berechtigungsumfang und hinterlegen Sie ihn im Secret-Manager Ihres CI-Anbieters:
export AIGLOT_API_KEY="aig_live_…"
aiglot account --jsonDie CLI prüft die Anmeldedaten in dieser Reihenfolge: AIGLOT_API_KEY, OS-Schlüsselbund und anschließend die geschützte Konfigurationsdatei.
Exit-Codes
| Code | Bedeutung |
|---|---|
| 0 | Erfolg |
| 1 | API- oder Serverfehler |
| 2 | Ungültiger Befehl oder ungültige Argumente |
| 3 | Authentifizierungs- oder Berechtigungsfehler |
| 4 | Ressource nicht gefunden |
| 5 | Ratenbegrenzung erreicht |
| 6 | Konflikt mit dem Ressourcenstatus |
Skripte sollten anhand des Exit-Codes oder des strukturierten Werts error.code verzweigen, nicht anhand des Fehlertextes.
Wiederholungsversuche
Wiederholungsversuche erfolgen automatisch, aber nur, wenn sie sicher sind. Bei jedem Befehl wird 429 erneut versucht; dabei wird Retry-After beachtet und eine begrenzte Backoff-Strategie verwendet. 408 und 5xx werden nur bei idempotenten Anfragen erneut versucht (RFC 9110 §9.2.2): Lesezugriffe sowie glossaries replace und glossaries delete.
glossaries create, glossaries add, glossaries remove, batches rename und batches archive werden nach einem 5xx nicht erneut versucht. Die Änderung könnte bereits übernommen worden sein und ein zweiter Versuch würde sie doppelt ausführen. Solche Fehler werden Ihrem Skript mit Exit-Code 1 gemeldet. Lesen Sie die Ressource erneut ein und entscheiden Sie selbst, ob ein weiterer Versuch sinnvoll ist, statt blind erneut zu versuchen.
Verwenden Sie --no-retry, wenn der aufrufende Prozess die Wiederholungsstrategie steuert, und --timeout <seconds> (Standardwert 60), um die Dauer einer einzelnen Anfrage zu begrenzen. Bei destruktiven Befehlen wird nie unbegrenzt auf eine interaktive Eingabe gewartet: Bei nicht interaktiver Verwendung muss --force angegeben werden.
Profile
Mit benannten Profilen können Sie Anmeldedaten für verschiedene Arbeitsbereiche oder Umgebungen getrennt verwalten:
aiglot --profile client-a auth login --key "$CLIENT_A_KEY"
aiglot --profile client-a account
export AIGLOT_PROFILE=client-aUmgebungsvariablen
| Variable | Zweck |
|---|---|
AIGLOT_API_KEY | API-Schlüssel; hat Vorrang vor gespeicherten Anmeldedaten |
AIGLOT_PROFILE | Benanntes Anmeldeprofil |
AIGLOT_NO_TUI | Erzwingt ein maschinenlesbares Ausgabeformat |
AIGLOT_NO_KEYCHAIN | Überspringt den Schlüsselbund des Betriebssystems |
NO_COLOR | Standard (no-color.org). Deaktiviert nur Farben, nicht das Ausgabeformat |