O que você vai aprender#
- como conectar um agente e o que ele pode fazer;
- a ordem em que um bom agente trabalha e os comandos que ele executa;
- como você confere o trabalho dele.
A ideia#
O agente usa os mesmos comandos que você. Pelo MCP, ele chama ferramentas como edit, lint e view; com um shell, ele executa as mesmas operações pela CLI. Toda edição é uma revisão numerada com o nome do agente, então você pode ler o histórico e desfazer qualquer passo. Nada é enviado pela rede pelo próprio produto.
Passos#
-
Conecte o agente. Para o Claude Code:
Terminal claude mcp add vukem-video -- vukem-video mcpOutros clientes aceitam o mesmo comando, veja Conecte um agente. Se você executa o editor, o agente e o navegador compartilham o projeto.
-
Ensine o produto a ele. O
vukem-video agent:docs --print skillimprime a skill e o--print agentso trecho para o seuAGENTS.md; veja A skill. -
Peça em palavras simples, por exemplo: "Importe
interview.mp4, remova os silêncios, legende a fala e exporte um vídeo 9:16." -
O agente trabalha nesta ordem. Você pode acompanhá-lo no histórico.
Passo Ferramenta MCP CLI criar o projeto project_createvukem-video project:create --name "Interview" --id prj_7k2m9x4q1bimportar a mídia media_importvukem-video media:import interview.mp4 --project prj_7k2m9x4q1b --asset-id ast_3c5v8n2w6daprender as operações command_helpvukem-video command:help clip.addeditar em um lote editvukem-video edit --project prj_7k2m9x4q1b --ops -transcrever job_startcom"kind": "transcribe"vukem-video transcribe --project prj_7k2m9x4q1b --asset ast_3c5v8n2w6d --waitconferir lint, depoisviewvukem-video lint --project prj_7k2m9x4q1bexportar job_startcom"kind": "export"vukem-video export --project prj_7k2m9x4q1b -
Leia o que ele fez. O agente vê o mesmo histórico que você:
Terminal vukem-video history --project prj_7k2m9x4q1b -
Desfaça o que você não gostar. O
vukem-video undo --project prj_7k2m9x4q1breverte o último passo, e o agente pode refazer ou tentar de novo.
Como conferir o trabalho dele#
Um agente deve olhar do jeito mais barato primeiro: ler o projeto como texto, executar lint, depois olhar quadros com view. Como um agente verifica o próprio trabalho explica a ordem. Peça ao agente que execute lint antes de cada exportação; a exportação é recusada enquanto a verificação encontrar um erro.
Erros comuns#
- Deixar dois atores editarem a partir de uma revisão antiga:
E_REVISION_CONFLICT. O agente lê o projeto de novo e planeja de novo; veja Receitas. - Pedir a transcrição antes de o auxiliar estar instalado. Uma pessoa o instala uma vez com
vukem-video tools:install whisper. - Dar ao agente um caminho em outra máquina. Os caminhos são lidos na máquina que roda o servidor.