Chaque commande youka accepte le même ensemble d’options globales. Elles contrôlent le mode de sortie, la gestion des entrées, le comportement d’attente et l’API cible.
Options
Enveloppe JSON
Avec --json, la CLI écrit exactement une enveloppe sur stdout et rien d’autre.
Succès :
Échec :
Codes de sortie :
Faites passer l’enveloppe via jq pour le scripting : youka project show $ID --json | jq '.data.state'.
Passer des bodies JSON
Toute commande de création ou de mise à jour accepte --body pour le body complet de la requête. Utilisez-le plutôt que d’échapper de gros JSON sur la ligne de commande.
Attendre les tâches asynchrones
--wait interroge la ressource créée pour vous et renvoie l’état final. Sans --wait, les commandes se terminent dès que la tâche est mise en file d’attente.
Associez --wait à --quiet dans des scripts pour supprimer la barre de progression tout en imprimant le résultat JSON.
Idempotence
Passez --idempotency-key pour rendre les commandes d’écriture sûres à retenter. Réutiliser la même clé avec le même payload renvoie le résultat d’origine au lieu de créer un doublon.
Utilisez des clés d’idempotence dès qu’un agent pourrait réessayer après un timeout.
Variables d’environnement
Et ensuite
- Compte - enregistrer votre clé API
- Projets - votre premier workflow scripté
- Agents IA - règles de fonctionnement pour les auteurs d’agents
