Ir para o conteúdo

Agentes

A CLI para agentes

Como um agente com um shell usa o vukem-video: saída JSON, códigos de saída e espera.

Última atualização:

A ideia#

Cada comando é um adaptador sobre o mesmo serviço das ferramentas MCP. Para um agente, três flags importam: --json imprime um único documento JSON e nada mais na saída padrão; --actor <rótulo> identifica quem chama no histórico; --project (ou VUKEM_VIDEO_PROJECT) diz qual é o projeto.

Códigos de saída#

CódigoSignificado
0sucesso
2um erro que pode ser repetido, ou um --wait que estourou o tempo
1qualquer outra coisa, inclusive um arquivo que falhou no media:import

Com --json, um erro é um único documento JSON com code, message, hint e retryable, e a saída de erro fica vazia.

Espera#

O media:import e o export esperam por padrão, até o --timeout (dez minutos). O --no-wait devolve a tarefa na hora; o job:show <id> --wait a retoma depois. Uma espera que estourou o tempo imprime a tarefa como está e sai com 2.

Início rápido#

Terminal
vukem-video project:create --name "Launch teaser" --json --actor claude-code
vukem-video edit --project prj_7k2m9x4q1b --ops - --json < batch.json
vukem-video export --project prj_7k2m9x4q1b --json

Todos os comandos e flags estão na referência da CLI.

Próximos passos#