Cada comando de youka acepta el mismo conjunto de flags globales. Controlan el modo de salida, el manejo de entrada, el comportamiento de espera y la API de destino.
Flags
Sobre JSON
Con --json, la CLI escribe exactamente un sobre en stdout y nada más.
Éxito:
Fallo:
Códigos de salida:
Canaliza el sobre a través de jq para scripting: youka project show $ID --json | jq '.data.state'.
Pasar cuerpos JSON
Cualquier comando de creación o actualización acepta --body para el cuerpo completo de la solicitud. Úsalo en lugar de escapar JSON grande en la línea de comandos.
Esperar trabajos asíncronos
--wait sondea el recurso creado en tu nombre y devuelve el estado final. Sin --wait, los comandos vuelven en cuanto el trabajo queda encolado.
Combina --wait con --quiet en scripts para suprimir la barra de progreso mientras sigues imprimiendo el resultado JSON.
Idempotencia
Pasa --idempotency-key para que los comandos de escritura sean seguros de reintentar. Reutilizar la misma clave con el mismo payload devuelve el resultado original en lugar de crear un duplicado.
Usa claves de idempotencia siempre que un agente pueda reintentar tras un timeout.
Variables de entorno
Qué sigue
- Account - guarda tu clave de API
- Projects - tu primer flujo de trabajo con scripting
- AI agents - reglas operativas para autores de agentes
