Caso de Estudo:
Agente Secretário.

Apenas Duas Ferramentas

Fluxo de Trabalho Básico

1. Fala com o Chat Claude → obtém uma especificação de "o que construir"
2. O Chat Claude transforma essa especificação numa folha de instruções (TASK.md)
3. Entrega o TASK.md ao Claude Code no VS Code → ele constrói efetivamente
4. Reporta o resultado de volta ao Chat Claude → obtém a folha de instruções seguinte
5. Repete os passos 1–4 até estar concluído

Fazer o Levantamento do Trabalho de Secretariado (um Ponto de Partida para a Entrevista)

"Quero um secretário" é fácil de dizer, mas pôr em palavras o que realmente quer entregar é surpreendentemente difícil. Com base no que a função abrange na prática, aqui fica um ponto de partida para a entrevista.

Agenda

• Adicionar, alterar e cancelar eventos (diz em voz alta e fica no calendário)
• Detetar sobreposições e manter intervalos realistas que contemplem o tempo de deslocação
• Ler em voz alta a agenda do dia a uma hora definida — logo de manhã, na noite anterior
• Eventos recorrentes, e ter em conta feriados e dias de encerramento

Notas de Despesa

• Ler a data, o montante, o beneficiário e os itens discriminados a partir de fotografias de recibos e faturas
• Separar por categorias contabilísticas e fiscais (assumindo que é um humano que faz a verificação final)
• Somatórios mensais e exportação para o formato que entregas
• Um lembrete quando os recibos por processar se estão a acumular

Email

• Classificar o correio recebido (precisa de resposta / apenas informativo / sem ação) e definir prioridades
• Redigir rascunhos de resposta (por regra, é um humano que decide sobre o envio)
• Aplicar modelos a pedidos de rotina
• Apanhar respostas esquecidas (assinalar tópicos sem resposta ao fim de um tempo definido)

Atas de Reunião a Partir de Áudio

• Entrega-lhe uma gravação e ele executa transcrição, pontos-chave e relatório como um único trabalho contínuo — traduzido para a língua que quiser, se necessário
• Pode ser construído sem acrescentar uma única API. A transcrição reutiliza um modelo Whisper local, e tanto o resumo como a tradução são feitos pelo próprio LLM do agente
• Isto compensa com reuniões noutra língua: uma discussão realizada numa língua volta como um relatório noutra, sem o vaivém de "ouvir outra vez e só depois traduzir"

Arrumar as notas de reunião, redigir formulários e requerimentos e fazer uma pré-seleção de voos e hotéis também podem ser cobertos. Os preparativos de viagem não são uma funcionalidade obrigatória — se viajar for raro na sua área de atividade, deixe isso de fora desde o início.

Porquê Dividir por Vários Agentes em Vez de Um Só

Quando se ouve falar de "agente secretário", tende a imaginar-se um único agente que faz tudo. Este caso de estudo recomenda antes dividir por tarefa.

Porque o Julgamento que Cada Tarefa Exige É Diferente

• A agenda exige a cautela de não encher demasiado o calendário; a triagem de email exige a abrangência de não deixar escapar nada importante; o trabalho de despesas coloca o rigor absoluto sobre os números acima de tudo o resto. Mete tudo isso numa só personalidade e o critério muda de uma instrução para a seguinte

Porque Pode Separar o Âmbito da Autoridade

• O agente de email precisa de acesso de leitura à sua caixa de entrada; o agente de despesas não. Separe-os e cada um recebe apenas o mínimo de que precisa. Se algo correr mal, o raio de impacto mantém-se dentro do território desse agente

Porque É Mais Fácil Isolar Quando Algo Se Parte

• Quando o somatório das despesas parece errado e as funções estão separadas, sabe imediatamente onde procurar. Com tudo num só agente, descobrir que instrução interferiu demora tempo

Enviar Instruções por Voz, Receber Relatórios por Voz

O cerne deste caso de estudo é que o seu secretário continua a trabalhar durante as horas em que está longe do computador. Para isso, transforma o Discord numa porta que transporta áudio nos dois sentidos.

Entrada (o utilizador → o agente)

• O áudio que gravas com a funcionalidade de mensagem de voz do Discord é transcrito pelo agente e assumido como uma instrução
• A transcrição corre sobre um modelo Whisper local, por isso o áudio nunca é enviado para lado nenhum e não há qualquer custo de utilização de API. Quando o áudio inclui agendas, nomes de clientes e montantes, é sobre esta configuração que deve construir

Saída (o agente → o utilizador)

• Os relatórios voltam em áudio e em texto — deixe o áudio correr enquanto se desloca, e siga o texto quando quiser verificar alguma coisa mais tarde
• O motor de síntese de voz a usar depende da língua, e de se alguma coisa pode sair da sua máquina. A abordagem não é fixar um motor, mas ouvir vários e escolher
• O critério é que não pode soar mecânico. Os montantes e as datas em particular vão diretamente para o seu trabalho, por isso teste sempre os formatos que vai efetivamente usar

Cronograma Geral (Seis Fases)

O que cada pessoa quer entregar difere por completo de pessoa para pessoa, por isso não existe nenhum TASK.md pronto que lhe permita saltar a entrevista. Comece sempre pela entrevista de requisitos da Phase 0.

Começa Agora: o Prompt de Arranque da Phase 0

Basta colares este prompt tal como está numa nova conversa com o "Chat Claude" (claude.ai) para dar início à entrevista de requisitos da Phase 0.

Aviso Legal e Notas Importantes