Todos os comandos youka aceitam o mesmo conjunto de flags globais. Elas controlam o modo de saída, o tratamento de entrada, o comportamento de espera e a API de destino.
Flags
Envelope JSON
Com --json, o CLI grava exatamente um envelope no stdout e nada mais.
Sucesso:
Falha:
Códigos de saída:
Envie o envelope por pipe para o jq em scripts: youka project show $ID --json | jq '.data.state'.
Passando bodies JSON
Qualquer comando de criação ou atualização aceita --body para o corpo completo da requisição. Use isso em vez de escapar JSON grande na linha de comando.
Aguardando jobs assíncronos
--wait faz polling do recurso criado por você e retorna o estado final. Sem --wait, os comandos retornam assim que o job é enfileirado.
Em scripts, combine --wait com --quiet para suprimir a barra de progresso enquanto ainda imprime o resultado JSON.
Idempotência
Passe --idempotency-key para tornar comandos de escrita seguros para repetir. Reutilizar a mesma chave com o mesmo payload retorna o resultado original em vez de criar um duplicado.
Use chaves de idempotência sempre que um agente puder tentar novamente após um timeout.
Variáveis de ambiente
Próximos passos
- Conta - salve sua chave de API
- Projetos - seu primeiro workflow com scripts
- Agentes de IA - regras de operação para autores de agentes
