Laboratório: Agente Claude para Validação de Novos Produtos com Avaliação Automatizada e Apresentação em Vídeo HeyGen

Roteiro para estudo em ambiente de laboratório ou de teste. Execute apenas em equipamentos, redes e contas que você tenha autorização para usar, com backup e homologação próprios. Comandos podem causar indisponibilidade ou perda de dados. Software e marcas citados pertencem aos seus titulares. Termos de Uso.

Duração estimada

120 min

Passos

11

Validações

5

Versões da documentação consultada

Python 3.10 ou superior · Claude Agent SDK Python a versão estável atual · Requests a versão estável atual

Topologia

O agente Claude roda em uma VM local (10.0.0.10), recebe prompts do usuário e usa ferramentas Python para buscar dados fictícios de mercado e validar critérios. Após a validação, o agente gera um resumo e envia para a API HeyGen (nuvem, 0.0.0.0/0) para criar o vídeo de apresentação. O resultado final é salvo e exibido localmente.

[Usuário]
    |
    v
[VM Local: Claude Agent SDK]
    |
    +---> [Ferramenta: Validação de Produto (Python)]
    |
    +---> [API HeyGen (Internet)]
    |
    v
[Arquivo de vídeo gerado]

Equipamentos e software

Roteiro

1. Preparar ambiente Python isolado

   Isolar dependências evita conflitos e facilita a limpeza. Use venv.

   python3 -m venv venv
   source venv/bin/activateCopiar

   O que você deve ver: Prompt do terminal com (venv) à esquerda

2. Instalar dependências

   Instale o SDK do Claude Agent e Requests para HTTP.

   pip install claude-agent-sdk-python requestsCopiar

   O que você deve ver: Mensagens de sucesso de instalação

3. Configurar variáveis de ambiente para segredos

   Nunca exponha chaves no código. Exporte as chaves da Claude API e HeyGen.

   export CLAUDE_API_KEY='SUA_CHAVE_AQUI'
   export HEYGEN_API_KEY='SUA_CHAVE_AQUI'Copiar

   O que você deve ver: Nenhuma saída (variáveis setadas)

4. Criar prompt de sistema versionado

   Defina as instruções do agente em português, salve como system_prompt_v1.txt.

   echo 'Você é um agente de validação de novos produtos. Analise a ideia, valide critérios de mercado, gere um relatório objetivo e prepare um resumo para apresentação. Use apenas dados fornecidos pelas ferramentas. Não decida sozinho sobre questões legais ou financeiras.' > system_prompt_v1.txtCopiar

   O que você deve ver: Arquivo system_prompt_v1.txt criado

5. Definir ferramenta de validação de produto

   Implemente uma função Python que simula busca de mercado e valida critérios (nome, segmento, preço EXEMPLO, diferencial).

   cat > ferramentas.py <<EOF
   import random
   def validar_produto(nome, segmento, preco, diferencial):
       # EXEMPLO: Simulação de critérios
       criterios = []
       if len(nome) < 3:
           criterios.append('Nome muito curto')
       if preco <= 0:
           criterios.append('Preço inválido')
       if segmento not in ['tecnologia', 'alimentação', 'serviços']:
           criterios.append('Segmento não suportado')
       if not diferencial:
           criterios.append('Diferencial não informado')
       mercado = random.choice(['Alta demanda', 'Baixa demanda', 'Concorrência intensa'])
       return {'criterios': criterios, 'mercado': mercado}
   EOFCopiar

   O que você deve ver: Arquivo ferramentas.py criado

6. Integrar ferramenta ao Claude Agent SDK

   Implemente o agente Claude importando o prompt e a ferramenta, expondo a função como ferramenta do agente.

   cat > agente.py <<EOF
   import os
   from claude_agent_sdk import Agent, Tool, run_agent
   from ferramentas import validar_produto
   with open('system_prompt_v1.txt') as f:
       system_prompt = f.read()
   
   class ValidaProdutoTool(Tool):
       name = 'validar_produto'
       description = 'Valida critérios de um novo produto.'
       parameters = {
           'nome': str,
           'segmento': str,
           'preco': float,
           'diferencial': str
       }
       def run(self, **kwargs):
           return validar_produto(**kwargs)
   
   tools = [ValidaProdutoTool()]
   
   def main():
       agent = Agent(
           name='AgenteValidador',
           instructions=system_prompt,
           tools=tools
       )
       entrada = {
           'nome': 'Café Digital',
           'segmento': 'tecnologia',
           'preco': 99.9,
           'diferencial': 'Integração IA'
       }
       resposta = run_agent(agent, entrada)
       print('Relatório:', resposta)
       with open('resumo.txt', 'w') as f:
           f.write(str(resposta))
   
   if __name__ == '__main__':
       main()
   EOFCopiar

   O que você deve ver: Arquivo agente.py criado

7. Rodar o agente e gerar relatório

   Execute o agente para validar o produto e gerar o resumo.

   python agente.pyCopiar

   O que você deve ver: Saída com 'Relatório:' e arquivo resumo.txt criado

8. Preparar texto para vídeo de apresentação

   Extraia o resumo do relatório para um arquivo texto.

   tail -n 10 resumo.txt > texto_video.txtCopiar

   O que você deve ver: Arquivo texto_video.txt criado

9. Criar script para enviar texto à API HeyGen

   Implemente script Python que envia texto para criar vídeo do tipo avatar.

   cat > video_heygen.py <<EOF
   import os, requests, time
   HEYGEN_API_KEY = os.getenv('HEYGEN_API_KEY')
   with open('texto_video.txt') as f:
       script = f.read()
   headers = {'x-api-key': HEYGEN_API_KEY, 'Content-Type': 'application/json'}
   data = {
       'type': 'avatar',
       'avatar_id': 'EXEMPLO_AVATAR_ID',
       'script': script,
       'voice_id': 'EXEMPLO_VOICE_ID',
       'output_format': 'mp4',
       'title': 'Apresentação Produto'
   }
   r = requests.post('https://api.heygen.com/v3/videos', json=data, headers=headers)
   video_id = r.json()['data']['video_id']
   print('Video ID:', video_id)
   # Polling para status
   while True:
       status = requests.get(f'https://api.heygen.com/v3/videos/{video_id}', headers=headers).json()['data']['status']
       print('Status:', status)
       if status == 'completed':
           video_url = requests.get(f'https://api.heygen.com/v3/videos/{video_id}', headers=headers).json()['data']['video_url']
           break
       elif status == 'failed':
           raise Exception('Falha na geração do vídeo')
       time.sleep(10)
   # Download
   resp = requests.get(video_url)
   with open('apresentacao.mp4', 'wb') as f:
       f.write(resp.content)
   print('Vídeo salvo como apresentacao.mp4')
   EOFCopiar

   O que você deve ver: Arquivo video_heygen.py criado

10. Executar criação e download do vídeo

    Rode o script e aguarde o download do vídeo de apresentação.

    python video_heygen.pyCopiar

    O que você deve ver: Arquivo apresentacao.mp4 salvo localmente

11. Revisar vídeo gerado

    Abra o vídeo para verificar a apresentação automatizada.

    xdg-open apresentacao.mp4Copiar

    O que você deve ver: Vídeo de apresentação do produto exibido

Como saber que funcionou

Troubleshooting

Segurança e hardening

• Nunca exponha ou compartilhe chaves de API em código ou logs
• Armazene segredos apenas em variáveis de ambiente
• Remova arquivos temporários e segredos após uso
• Limite o acesso à VM ou notebook durante o laboratório
• Não use dados pessoais reais sem base legal

Checklist final

• Ambiente Python isolado criado
• Dependências instaladas sem erro
• Variáveis de ambiente setadas
• Prompt de sistema salvo e versionado
• Ferramenta de validação funcional
• Agente executando e gerando relatório
• Resumo extraído para vídeo
• Vídeo gerado e salvo localmente
• Revisão manual do vídeo concluída