Skill de Produção de Vídeo com Plan
Escopo de Aplicação
Pré-requisito: A colaboração Plan já está ativa (scenario(activate, plan) ativado), e é necessária uma tarefa que envolva produção visual/vídeo (geração de imagens, vídeos curtos, narração, legendas).
Escolha do Fornecedor: Para geração de imagens, consulte a skill byted-ark-seedream-skill; para geração de vídeos, consulte o script media-production (Volcengine Seedance). Para outros fornecedores, veja agnes-media-generation / wan-media-generation / kling-media-generation.
Credenciais (Variáveis de Ambiente)
Adicione as variáveis de ambiente necessárias em Configurações → Variáveis de Ambiente (ex.: VOLCENGINE_API_KEY / ARK_API_KEY). Você também pode preencher as chaves de outros fornecedores em Configurações → Modelo → Mídia Criativa.
| Capacidade | Chave Comum | Skill |
|---|---|---|
| Geração de Imagens | VOLCENGINE_API_KEY / ARK_API_KEY | byted-ark-seedream-skill |
| Geração de Vídeos | Igual | media-production |
| Agnes | AGNES_API_KEY | agnes-media-generation |
Mudança Central: Todos os profissionais de mídia (roteirista, planejador visual, artista, diretor, pós-produção) são especificados inteiramente em plan(goal, steps[]) através de assigned_agent. Após o plano ser salvo e o usuário confirmar, a execução em série começa, sem delegação de subagentes fora do plano.
Fluxo de Trabalho
Usuário expressa necessidade
↓
Perguntar e confirmar as necessidades do usuário (tema, duração, estilo, proporção de tela, etc.)
↓
Usar diretamente plan(goal, steps[]) para planejar
etapa 1: media-screenwriter — Roteiro/storyboard/script de locução
etapa 2: media-visual-planner — Prompt de geração de imagem
etapa 3: media-artist — Gerar quadros-chave
etapa 4: media-video-director — Produzir vídeo + narração nativa
etapa 5: media-post — Legendas fixas
↓
Usuário confirma → Execução (em série, validação em cada etapa)
Passos da Operação
Primeiro Passo: Perguntar ao Usuário
Colete ativamente as seguintes informações do usuário:
| Pergunta | Exemplo |
|---|---|
| Qual é o tema/produto/conteúdo do vídeo? | Propaganda do novo smartwatch |
| Duração alvo? | 15 segundos / 30 segundos |
| Estilo visual? | Tecnológico / Aconchegante / Estilo chinês |
| Proporção de tela? | 16:9 / 9:16 vertical |
| Direção do texto de locução? | Destaques de funcionalidades + slogan da marca |
| Há material de referência? | Imagem de referência / Vídeo de concorrente |
Segundo Passo: Após a Confirmação, Usar Diretamente o Plan
Após o usuário confirmar as necessidades, use diretamente a ferramenta plan para escrever todas as etapas no plano estruturado:
plan(
goal="Produzir um vídeo promocional de 15 segundos, tema: xxx, estilo: xxx",
steps=[
{
"step_id": 1,
"description": "Roteirista escreve o production brief, contendo logline, storyboard e script de locução",
"assigned_agent": "media-screenwriter",
"expected_output": "outputs/production-brief.md",
"acceptance_criteria": "Deve conter User intent, logline, visual style, shot list, narration script"
},
{
"step_id": 2,
"description": "Planejador visual converte storyboard em prompts de geração de imagem",
"assigned_agent": "media-visual-planner",
"expected_output": "outputs/shot-prompts.json",
"depends_on": [1]
},
{
"step_id": 3,
"description": "Artista gera imagens de quadro-chave do primeiro quadro",
"assigned_agent": "media-artist",
"expected_output": "Imagens PNG de quadros-chave em outputs",
"depends_on": [2]
},
{
"step_id": 4,
"description": "Diretor de vídeo gera MP4 com narração nativa",
"assigned_agent": "media-video-director",
"expected_output": "outputs/*.mp4",
"depends_on": [3]
},
{
"step_id": 5,
"description": "Pós-produção adiciona legendas fixas, entrega MP4 final",
"assigned_agent": "media-post",
"expected_output": "outputs/*-subtitled.mp4",
"depends_on": [4]
}
],
flowchart_mermaid="..."
)
Terceiro Passo: Usuário Confirma a Execução
Após o plano ser salvo e o usuário confirmar "iniciar execução", a fase de execução começa. Cada etapa é executada em série de acordo com a ordem de dependência, e após a conclusão de cada etapa, o Agente principal valida o artefato antes de prosseguir para a próxima.
Lista de Subagentes de Mídia
| assigned_agent | Responsabilidade | Ferramentas Principais |
|---|---|---|
media-screenwriter | Escrever roteiro, storyboard, script de locução | read_file, write_to_file |
media-visual-planner | Escrever prompts de geração de imagem | read_file, write_to_file |
media-artist | Geração de imagens Seedream (jimeng) | read_file, terminal → scripts/image_generate.py |
media-video-director | Geração de vídeo a partir de imagem Seedance + narração nativa | read_file, terminal → scripts/video_generate.py, task_wait.py |
media-post | Legendas SRT + legendas fixas com ffmpeg | read_file, terminal → scripts/subtitle_build.py, subtitle_burn.py |
Atenção: Não inclua media-voice-director nas etapas — o Seedance já tem áudio nativo (generate_audio=true ativado por padrão).
Stack Tecnológico
Diretório de scripts: skills/public/media-production/scripts/ (primeiro leia a skill media-production)
| Capacidade | Script | provider |
|---|---|---|
| Geração de Imagens | image_generate.py | jimeng (Volcengine Ark Seedream) |
| Geração de Vídeos | video_generate.py + task_wait.py | jimeng (Volcengine Ark Seedance, com áudio padrão) |
| Legendas | subtitle_build.py + subtitle_burn.py | ffmpeg local |
Tratamento de Falhas: Se o jimeng falhar, é proibido trocar automaticamente para wan/kling. Instrua o usuário a ativar o endpoint do modelo Ark. Repetir no máximo 1 vez com os mesmos parâmetros.
Erros Comuns
- Executar
image_generate.pydiretamente na sessão principal no modo plan → Deve ser executado pelomedia-artistdentro da etapa do plano - Delegar subagentes fora das etapas do plano → Todos os profissionais devem estar escritos no
assigned_agentnas etapas do plano - Pular
task_wait.py→ O vídeo é entregue antes da conclusão da geração - O pipeline padrão ainda delega
media-voice-director→ O Seedance já tem áudio nativo, é redundante