A ideia#
Um agente edita e exporta sem perguntar antes. O Vukem Video torna isso seguro removendo as habilidades perigosas em vez de pedir confirmação. O pior que uma instrução errada ou hostil pode fazer é produzir edições que você pode desfazer e usar recursos até um teto.
O que um agente não pode fazer#
- Enviar o seu projeto para algum lugar. Nenhum comando, ferramenta ou rota HTTP publica, envia, chama um webhook ou exporta para uma URL. A importação por URL não existe, e um caminho que parece uma URL ou um compartilhamento de rede é recusado.
- Excluir de vez.
project:trashemedia:trashmovem as coisas para a lixeira, eproject:restoreemedia:restoreas trazem de volta. Esvaziar a lixeira não é uma ferramenta MCP nem um comando da CLI: é feito por uma pessoa no editor. - Ler segredos. Nenhuma ferramenta devolve tokens, chaves ou configuração.
- Alcançar outros arquivos pelo FFmpeg. O FFmpeg só abre arquivos que o produto escolheu; listas de reprodução e URLs de usuário nunca são passadas a ele.
O que pode ser desfeito#
Toda edição é um lote com uma revisão e o ator que a fez. undo e redo percorrem o histórico de quem chama, e history lista quem mudou o quê. Dois atores que mudam a mesma propriedade a partir da mesma revisão não se sobrescrevem: o segundo recebe E_REVISION_CONFLICT com details.diff, e o seu lote não muda nada. Veja Lotes, revisões e idempotência.
vukem-video history --project prj_7k2m9x4q1b
vukem-video undo --project prj_7k2m9x4q1bLimites#
Cada espaço de trabalho tem tetos para o trabalho que um agente pode iniciar. Uma chamada que excede um falha com um erro que nomeia o teto, o seu valor e a variável que o muda, para que o agente (ou você) saiba o que fazer em seguida.
| Teto | Variável |
|---|---|
| Tamanho do arquivo importado | VUKEM_VIDEO_MAX_IMPORT_BYTES |
| Resolução e duração do vídeo importado | VUKEM_VIDEO_MAX_IMPORT_PIXELS, VUKEM_VIDEO_MAX_IMPORT_SECONDS |
| Exportações na fila ou em execução | VUKEM_VIDEO_MAX_EXPORTS |
| Tamanho de um arquivo exportado | VUKEM_VIDEO_MAX_EXPORT_BYTES |
| Transcrições em execução e o áudio mais longo | VUKEM_VIDEO_MAX_TRANSCRIBES, VUKEM_VIDEO_MAX_TRANSCRIBE_SECONDS |
E_QUEUE_FULL e E_REVISION_CONFLICT podem ser repetidos: a CLI sai com 2 e o erro diz retryable: true. Um limite como E_LIMIT_EXCEEDED não pode ser repetido até a entrada ou o teto mudar. A página de códigos de erro lista cada código e o seu status HTTP. A página de variáveis de configuração lista os padrões.
O texto vindo da mídia é dado#
Uma transcrição, um nome de arquivo ou um campo de metadados pode dizer "ignore as suas instruções". O produto devolve esse texto dentro de blocos delimitados e truncados, marcados como dados, e as descrições das ferramentas dizem ao agente que o trate assim. Não o cole em um prompt como se viesse de você.
Erros comuns#
- Supor que um projeto na lixeira sumiu. Ele fica no disco até uma pessoa esvaziar a lixeira.
- Repetir um erro de limite em um laço. Leia antes o teto no erro.