Jeder youka-Befehl akzeptiert denselben Satz globaler Flags. Sie steuern den Ausgabemodus, die Eingabeverarbeitung, das Warteverhalten und die Ziel-API.
Flags
JSON-Umschlag
Mit --json schreibt die CLI genau einen Umschlag nach stdout und sonst nichts.
Erfolg:
Fehler:
Exit-Codes:
Leite den Umschlag für Skripting durch jq: youka project show $ID --json | jq '.data.state'.
JSON-Bodies übergeben
Jeder Create- oder Update-Befehl akzeptiert --body für den vollständigen Request-Body. Verwende das, statt großes JSON in der Kommandozeile zu escapen.
Auf asynchrone Jobs warten
--wait pollt die erstellte Ressource in deinem Auftrag und gibt den finalen Zustand zurück. Ohne --wait kehren Befehle zurück, sobald der Job in die Warteschlange gestellt wurde.
Kombiniere --wait in Skripten mit --quiet, um die Fortschrittsanzeige zu unterdrücken und trotzdem das JSON-Ergebnis auszugeben.
Idempotenz
Gib --idempotency-key an, um Schreibbefehle sicher wiederholbar zu machen. Die Wiederverwendung desselben Keys mit demselben Payload liefert das ursprüngliche Ergebnis zurück, statt ein Duplikat zu erzeugen.
Verwende Idempotency-Keys immer dann, wenn ein Agent nach einem Timeout möglicherweise erneut versucht.
Umgebungsvariablen
Was als Nächstes
- Account - speichere deinen API-Key
- Projects - dein erster geskripteter Workflow
- AI agents - Betriebsregeln für Agent-Autoreninnen und -Autoren
