Design de Prompts & Workflows

Em um sistema MCP-first, além de Tools e Resources, existe um terceiro componente: Prompts e Workflows. Um workflow é um fluxo pré-definido que guia um agente passo a passo por um processo complexo. Ele define quais tools são chamadas em que ordem, onde o ser humano precisa ser consultado e quais resultados são repassados.

Workflows não são scripts. Eles fornecem ao agente contexto, intenção e estrutura, sem retirar sua liberdade de decisão.

A melhor interface muitas vezes não é interface nenhuma

Muitas tarefas do dia a dia de trabalho não precisam mais de uma página. Elas são dialógicas, contextuais e baseadas em workflows. O humano pergunta, o agente trabalha:

• “Crie um resumo de todos os negócios em aberto.”
• “Quais clientes devo contatar hoje?”
• “Agende um follow-up com todos os envolvidos.”
• “Prepare um e-mail para este contato.”
• “Verifique se há documentos faltando para este colaborador.”
• “Crie um relatório sobre todos os projetos com risco.”
• “Compare os dois últimos ciclos de folha de pagamento.”

Sem navegação, sem filtros, sem modais. O agente reúne o contexto, combina as tools corretas e entrega um resultado, ou solicita aprovação antes de agir externamente.

Workflows em vez de navegação

Um webapp clássico conduz o usuário pela navegação: lista de clientes → página de detalhes → aba de comunicação → modal de lembrete. Isso é intuitivo para humanos. Para um agente, é overhead desnecessário, ele teria que clicar por uma interface que não foi construída para sua forma de trabalhar.

Um workflow resolve o mesmo problema de forma diferente: descreve o processo diretamente como uma sequência ordenada de Capabilities. O agente entende o que fazer sem precisar conhecer a interface.

Um workflow em detalhes

O exemplo a seguir mostra um workflow de Follow-up de Compradores para um software imobiliário. O agente deve verificar todos os projetos ativos, identificar compradores adequados e preparar uma comunicação de follow-up.

Como o workflow funciona:

1. projects.list_active, O agente lê todos os projetos ativos. Trata-se de um acesso de leitura de baixo risco que pode ser executado de forma autônoma.
2. contacts.search_buyers, Para cada projeto, são buscados contatos de compradores adequados. Também é um acesso de leitura, sem efeito externo.
3. contacts.get_purchase_profile, O agente carrega o perfil de compra de cada contato para verificar se um follow-up faz sentido.
4. exposes.generate_download_link, Para projetos relevantes, é gerado um link de download com prazo de validade para o exposé.
5. emails.create_project_draft, O agente cria um rascunho de e-mail com o texto personalizado e o link de download. Ainda sem envio.

Neste ponto, o workflow é pausado.

O humano é consultado. O sistema exibe o rascunho completo: destinatário, assunto, conteúdo, data de expiração do link, nível de risco critical. O usuário pode confirmar, editar ou rejeitar o rascunho. Somente após aprovação explícita emails.send_project_email é executado.

6. reminders.create_follow_up, Após o envio, o agente configura automaticamente um lembrete caso o contato não responda em sete dias.
7. deals.recommend_next_action, Por fim, o sistema calcula a próxima ação recomendada por negócio e a retorna como resultado estruturado.

Workflows compõem Tools

Um workflow é, em essência, uma composição de tools individuais com uma lógica clara:

• Acessos de leitura de baixo risco (list_active, search_buyers, get_purchase_profile) são executados de forma autônoma e sequencial, sem efeito externo, sem risco.
• Ações de escrita com efeito interno (create_project_draft, reminders.create_follow_up) são executadas, mas não geram efeito externo.
• Ações de escrita com efeito externo (emails.send_project_email) são protegidas por um Confirmation Gate. O agente prepara, o humano decide.

Esse padrão se aplica a qualquer workflow: leitura é barata, escrita exige contexto, ações externas exigem consentimento. Quem constrói workflows dessa forma mantém o sistema completamente controlável, sem paralisá-lo.