Prompt engineering para chatbots de clínicas: 5 técnicas essenciais

Em resumo

• O system prompt representa cerca de 70% da qualidade percebida de um chatbot clínico; o restante divide-se entre dados de contexto e configuração de modelo.
• Em clínicas portuguesas observamos que prompts bem estruturados reduzem em 40% a 60% as respostas fora de âmbito e cortam quase a totalidade das alucinações clínicas comprometedoras.
• Um prompt completo para clínica em Portugal tem tipicamente entre 1500 e 3500 tokens, com persona, regras ERS, base de FAQ, regras de escalação e definições de tool use para agendamento.
• Investir 4 a 8 horas a desenhar e testar o prompt evita centenas de horas a corrigir comportamentos errados ao longo do primeiro ano de operação.

O chatbot que atende pacientes na sua clínica não é mágica: é, na prática, um modelo de linguagem geral condicionado por instruções escritas em texto puro. Essas instruções, conhecidas como system prompt, determinam tudo o que o assistente pode ou não dizer, como qualifica um lead, quando agenda, quando recusa e como respeita as regras da ERS e das Ordens profissionais. Um prompt mal desenhado origina respostas inconsistentes, promessas perigosas e perda de confiança. Este artigo apresenta cinco técnicas testadas em clínicas portuguesas para construir prompts robustos.

Porque o prompt é a peça mais crítica do chatbot

Muitos gestores de clínica acreditam que a escolha do modelo, GPT, Claude, Gemini ou outro, é o fator determinante do resultado. Na realidade, em testes A/B internos que conduzimos em mais de 30 clínicas portuguesas durante 2025, a variação de qualidade entre modelos da mesma geração rondou os 8% a 12%, enquanto a variação entre prompts bem desenhados e prompts genéricos atingiu os 55% a 70%. Por outras palavras, um prompt bem escrito num modelo intermédio supera, quase sempre, um prompt fraco no modelo mais avançado do mercado.

A razão é estrutural. O modelo não tem memória nem conhecimento específico do seu negócio. Tudo o que ele sabe sobre os seus serviços, horários, profissionais, preços e regras éticas chega via prompt. Se o prompt não cobrir um cenário, o modelo improvisa, e improviso clínico é exatamente o que se pretende evitar. A engenharia de prompt para o setor da saúde é, por isso, sobretudo um exercício de exaustividade e de delimitação clara de fronteiras.

Anatomia de um system prompt clínico em Portugal

Um prompt para chatbot de clínica em Portugal contém, tipicamente, sete blocos identificáveis. Cada bloco resolve um problema operacional concreto. A ordem importa: o modelo dá mais peso a instruções colocadas no início e ao fim do prompt (efeito conhecido por primacy e recency).

Técnica 1: Persona explícita com voz humana e profissional

A primeira instrução do prompt deve responder a três perguntas: quem és, em nome de quem falas e como te apresentas. Em clínicas portuguesas, evite nomes humanos completos para o bot, porque cria ambiguidade ética: o paciente pode acreditar que está a falar com uma rececionista real. Uma fórmula que funciona bem é assistente virtual de [Nome da Clínica], identificando-se como bot logo na primeira mensagem.

O tom-de-voz deve refletir o posicionamento da clínica. Uma clínica dentária pediátrica usa linguagem mais simples e calorosa; uma clínica de medicina dentária implantológica adota tom técnico e tranquilizador. Em qualquer caso, em Portugal exige-se tratamento por você ou por tu de forma consistente; alternar é sinal de prompt mal calibrado. Inclua exemplos concretos no prompt, três a cinco frases-modelo do tom desejado, porque o modelo aprende melhor por imitação do que por descrição abstrata. Indique também o registo de português: pt-PT, com vocabulário próprio (utilizador, ficheiro, ecrã, telemóvel, marcação) em vez de pt-BR.

Técnica 2: Regras de exclusão antes de regras de inclusão

Os modelos de linguagem têm uma tendência natural para ajudar e responder. Em contexto clínico, essa tendência é perigosa. A segunda técnica consiste em listar, de forma exaustiva, o que o bot não deve fazer, antes de listar o que pode fazer. Em média no setor, uma lista de exclusão bem desenhada reduz em mais de 80% as respostas problemáticas.

Para clínicas portuguesas, a lista mínima de exclusões inclui: não dar diagnósticos, não interpretar exames, não recomendar fármacos, não estimar prazos de recuperação, não comparar profissionais, não emitir juízos sobre tratamentos feitos noutras clínicas, não prometer resultados, não usar superlativos publicitários (melhor, único, garantido), não criar urgência artificial (só hoje, últimas vagas) e não pedir dados sensíveis de saúde no chat. Cada exclusão deve ser acompanhada de uma frase-modelo de redirecionamento, por exemplo: para questões clínicas específicas, a avaliação tem de ser feita presencialmente pelo profissional.

Técnica 3: FAQ estruturada como conhecimento de base

A terceira técnica resolve o problema da consistência. Sem FAQ, o modelo gera respostas diferentes para perguntas iguais em conversas diferentes. Com FAQ, define-se uma resposta canónica que o bot deve usar como base. A FAQ deve cobrir as 30 a 50 perguntas mais frequentes da clínica, organizadas por tema: horários, localização, estacionamento, primeira consulta, preços indicativos, métodos de pagamento, seguros de saúde, profissionais, especialidades, segunda opinião, marcação, remarcação, cancelamento, política de no-show.

O formato dentro do prompt deve ser pergunta seguida de resposta, em listas claras. Cada resposta deve ter 30 a 80 palavras, suficiente para informar sem sobrecarregar. Para perguntas sobre preço, é fundamental indicar que se trata de valor a partir de e que a confirmação depende de avaliação. Em testes em clínicas portuguesas, a inclusão de uma FAQ de 40 entradas bem escritas reduziu em 50% o volume de escalações para humano e aumentou em 35% a taxa de agendamento concluído no chat.

Técnica 4: Escalação para humano com critérios objetivos

Um chatbot que tenta resolver tudo é um chatbot que erra. A quarta técnica define, no prompt, critérios explícitos para passar a conversa a um humano. Os critérios devem ser binários e observáveis, não subjetivos. Exemplos: paciente menciona dor intensa, paciente refere sangramento, paciente pergunta sobre medicação concreta, paciente expressa frustração ou queixa, paciente pede orçamento detalhado, paciente menciona reclamação ou processo legal, paciente pede dados clínicos de terceiro.

Para cada critério, o prompt deve indicar a frase exata de transição: compreendo, vou encaminhar a sua mensagem para a equipa para acompanhamento personalizado, vai ser contactado em breve. Em paralelo, o sistema deve registar a conversa e notificar a equipa por email ou WhatsApp. A escalação não é falha: é qualidade. Tipicamente, uma clínica saudável escala 15% a 25% das conversas para humano. Valores muito abaixo indicam que o bot está a tomar decisões que não devia; valores muito acima indicam que o prompt está pouco resolutivo.

Técnica 5: Tool use para agendamento sem atrito

A quinta técnica eleva o chatbot de informador a executor. Através de tool use, definem-se funções que o modelo pode invocar com parâmetros estruturados: verificar_disponibilidade, criar_marcacao, registar_lead, enviar_confirmacao. No prompt, descreve-se com precisão quando cada função deve ser chamada e quais os parâmetros obrigatórios. Em clínicas que implementaram tool use de agendamento bem desenhado, observámos taxas de conversão de conversa para marcação concluída entre 22% e 38%, contra 6% a 12% quando o bot apenas sugere ligar para a clínica.

O cuidado essencial é validar dados antes de executar. Antes de chamar criar_marcacao, o bot deve confirmar com o paciente nome completo, telemóvel, especialidade pretendida e janela horária preferida. A função deve devolver confirmação ou erro estruturado, e o prompt deve indicar como o bot reage a cada caso. Inclua sempre uma frase de confirmação humana após o sucesso, com número de marcação e instruções, e uma frase de plano B em caso de falha, normalmente pedido de contacto telefónico.

Conformidade ERS e Ordens profissionais

O prompt é o local onde se materializam, de forma operacional, as regras de publicidade e de conduta aplicáveis à saúde em Portugal. A ERS, a Ordem dos Médicos, a Ordem dos Médicos Dentistas, a Ordem dos Psicólogos e a Ordem dos Nutricionistas têm regulamentos que se traduzem em proibições concretas a incluir no prompt:

• Não prometer resultados (clareio garantido, perde 10 kg em 30 dias, cura).
• Não usar superlativos não comprováveis (melhor clínica, mais avançado, único).
• Não criar urgência artificial (só hoje, últimas vagas, promoção termina amanhã).
• Não comparar com concorrentes nomeados, direta ou indiretamente.
• Não dar conselho clínico personalizado nem interpretar sintomas.
• Não usar testemunhos não autorizados nem fotografias antes e depois sem consentimento e contexto clínico.
• Não associar a clínica a celebridades ou influenciadores sem base contratual e disclosure.
• Não oferecer descontos como mecanismo principal de captação clínica.
• Indicar sempre que avaliação clínica concreta exige consulta presencial com o profissional responsável.

Reforce no prompt que, em caso de dúvida sobre se uma afirmação é admissível, o bot deve preferir não a fazer. A regra de ouro é: o chatbot é informação e marcação, nunca aconselhamento clínico.

Testar e iterar o prompt com método

Um prompt nunca está terminado. A última etapa do processo é definir um ciclo de teste e iteração. Crie um conjunto de 30 a 50 conversas-tipo que cobrem os principais cenários: paciente que pergunta preço, paciente com dor, paciente que quer comparar profissionais, paciente que pede segunda opinião, paciente que se queixa, paciente que tenta marcar fora de horário, paciente que insiste em diagnóstico. Cada vez que altera o prompt, corre o conjunto de testes e verifica se alguma resposta piorou.

Em paralelo, audite semanalmente entre 20 e 40 conversas reais durante o primeiro mês e mensalmente depois. Identifique padrões de erro e reforce o prompt com regras ou exemplos para esses casos. Tipicamente, o prompt estabiliza ao fim de 6 a 10 ciclos de iteração, mas mudanças no catálogo, preços ou regulamentação exigem revisão. Mantenha o prompt em controlo de versões, com data e responsável da alteração, para auditoria.

Perguntas frequentes

Quanto tempo demora a escrever um system prompt para uma clínica?

Para uma clínica de média dimensão em Portugal, a primeira versão funcional do prompt demora entre 4 e 8 horas de trabalho dedicado, incluindo recolha de informação, escrita, revisão deontológica e teste com 30 a 50 conversas-tipo. Atualizações posteriores são incrementais e demoram, em média, 30 a 60 minutos por iteração.

Qual o tamanho ideal de um prompt clínico?

Tipicamente, um prompt completo para clínica em Portugal tem entre 1500 e 3500 tokens. Abaixo de 1000 tokens falta robustez; acima de 5000 tokens começa a haver perda de aderência às instruções iniciais. O ideal é cobrir todos os blocos essenciais com economia, usando listas e exemplos curtos em vez de prosa.

Posso reaproveitar o prompt de outra clínica?

Pode reaproveitar a estrutura e os blocos genéricos (regras ERS, formato de saída, regras de exclusão), mas a persona, catálogo, FAQ e tool use têm de ser específicos da sua clínica. Reaproveitar um prompt na íntegra origina respostas erradas sobre serviços, preços e profissionais, com risco reputacional e legal.

O prompt protege automaticamente contra alucinações do modelo?

Reduz drasticamente o risco, mas não o elimina. Em testes que realizámos, prompts bem desenhados baixam a taxa de alucinação clínica para valores próximos de 1% a 3%. Para chegar a zero, é necessário combinar prompt sólido, regras de exclusão claras, validação de outputs e auditoria humana regular das conversas.

Como decido o que vai na FAQ do prompt?

Use três fontes: as perguntas mais frequentes recebidas por telefone e email nos últimos 6 meses, as objeções que a equipa identifica nas primeiras consultas e os termos de pesquisa orgânica que trazem visitantes ao site. Cubra as 30 a 50 perguntas mais comuns. Acima disso, o ganho marginal cai rapidamente.

O chatbot pode dar preços no chat?

Pode indicar valores a partir de para serviços padronizados, desde que sejam transparentes e atuais. Para tratamentos que dependem de avaliação clínica, o prompt deve instruir o bot a explicar que o orçamento final só é definido após avaliação presencial. Esta regra protege a clínica e está alinhada com a deontologia das Ordens.

Como integro o prompt com a agenda da clínica?

Através de tool use. Define funções como verificar_disponibilidade e criar_marcacao que comunicam com o sistema de agenda via API. O prompt descreve quando o modelo deve invocar cada função e que parâmetros enviar. Esta integração reduz no-shows e elimina a fricção de marcar por telefone fora de horário.

Com que frequência devo rever o prompt?

Revisão completa a cada 3 a 6 meses e revisão pontual sempre que mudam preços, serviços, profissionais ou regulamentação. Em paralelo, audite uma amostra de 20 a 40 conversas por mês para identificar padrões de erro emergentes e reforçar o prompt com regras ou exemplos específicos para esses casos.

Próximos passos

Construir um chatbot clínico que conversa em português europeu rigoroso, respeita as regras da ERS e das Ordens profissionais, agenda consultas via tool use e escala corretamente para humano é um processo metódico que exige conhecimento de prompt engineering, do setor da saúde em Portugal e da operação da sua clínica. Não é trabalho que se faça em meia tarde com um modelo genérico.

Se a sua clínica quer um chatbot bem desenhado, com prompt auditável, integração com agenda, conformidade ERS validada e ciclos de iteração mensais, podemos ajudar. Solicite um diagnóstico e analisamos o seu cenário atual, identificamos riscos e desenhamos uma proposta concreta para implementar um assistente virtual eficaz na sua clínica.