Bem-vindo à série de tutoriais da Heidi Health sobre modelos. Neste primeiro artigo, iremos guiá-lo através dos conceitos básicos de criação e utilização de modelos na Heidi, garantindo que o seu processo de documentação clínica seja simplificado e eficiente.
Início Rápido (60 Segundos)
Procura pular direto para o início? Aqui está o caminho mais rápido para o seu primeiro modelo:
Na barra lateral esquerda, selecione 'Meus Modelos'
No canto superior direito da página, clique em "+ Criar modelo"
Selecione a opção "Nota ou documento" - isso gera um modelo baseado nas suas instruções de texto
Digite o que você precisa, por exemplo, "Criar uma nota SOAP para consultas de médico geral"
Clique na seta 'para cima' → Heidi gera seu modelo
Revise o 'exemplo' e ajuste a 'estrutura' conforme necessário
Clique em "Salvar" no canto superior direito
Pronto! Seu modelo está pronto para usar.
Para etapas mais detalhadas sobre personalização, continue lendo o artigo abaixo.
💡 Curioso sobre a opção 'Preenchedor de PDF de Formulário'? Veja nosso artigo de Formulários aqui.
Tutorial em Vídeo
O que são 'Modelos' na Heidi?
Os modelos são ferramentas poderosas concebidas para o ajudar a criar notas clínicas estruturadas e consistentes, bem como documentos. Funcionam como um enquadramento, orientando a IA da Heidi na criação de conteúdos no formato e estilo que prefere.
Quer seja um utilizador principiante ou experiente, criar um modelo básico é direto e extremamente útil.
💡 Pense em um modelo como uma receita: os modelos indicam à Heidi quais ingredientes incluir (histórico do paciente, achados do exame, plano) e como apresentá-los (pontos, parágrafos, títulos específicos).
Sob o Capot: Os 4 Componentes do Modelo
Antes de começar, pode ser útil compreender os quatro blocos de construção que compõem cada modelo Heidi. Você não precisa memorizar esses componentes, pois o construtor de modelos lida com a maioria deles automaticamente, mas estar ciente deles o ajudará a personalizar seus modelos de forma mais eficaz.
Os Componentes em Resumo:
Componente | Como Se Parece | O que faz |
Títulos de Secção | Texto simples | Organiza seu modelo com títulos como "Subjetivo" ou "Plano" |
[Marcadores de Posição] |
| Diz à Heidi qual informação incluir |
(Instruções de IA) |
| Diz à Heidi como lidar com essas informações |
“Texto Textual” |
| Texto que aparece exatamente igual a cada vez |
1. Títulos de Secção
Os títulos de secção organizam o seu modelo e fornecem estrutura. Estes títulos são definidos em texto simples.
Por exemplo, numa nota clínica seguindo o modelo SOAP (Subjetivo, Objetivo, Avaliação, Plano), pode incluir títulos como:
**Subjetivo**
**Objetivo**
**Avaliação**
Plano
Estes títulos de secção ajudam a Heidi a compreender que tipo de informação deve ser incluída ao longo do modelo.
2. [Marcadores de Posição]
Os marcadores de posição indicam à Heidi onde inserir informações específicas. Estão envolvidos em colchetes quadrados e descrevem o tipo de conteúdo a incluir. Estas não devem incluir exemplos específicos.
Exemplos:
[Nome do paciente]→ Será substituído pelo nome real do paciente[Queixa principal e história da doença atual]→ Será preenchido a partir da consulta[Medicamentos atuais]→ Listará medicamentos discutidos
✅ Bom exemplo: [Histórico médico passado]
❌ O que não fazer: [Histórico médico passado, ex. diabetes, hipertensão] ← Não inclua exemplos dentro dos marcadores de posição
Por predefinição, todos os marcadores de posição devem ser seguidos de uma instrução de IA.
3. (Instruções de IA)
As instruções de IA guiam a Heidi sobre como lidar com informações. Estão envolvidas em parênteses redondos, e normalmente seguem um marcador de posição.
A instrução de IA mais importante é a seguinte instrução de segurança padrão, que impede que a Heidi invente informações. Isto deve ser inserido após cada marcador de posição:
(Inclua apenas se mencionado explicitamente na transcrição, contexto ou nota clínica, caso contrário, omita a secção inteiramente.)
As instruções de IA também podem ser adicionadas no início ou fim do seu modelo para orientação geral (ver: Instruções Globais), ou imediatamente após um marcador de posição para fornecer instruções específicas.
Exemplo após marcador de posição:
[Histórico Médico Passado] **(Inclua apenas se mencionado explicitamente na transcrição, contexto ou nota clínica; caso contrário, omita a secção inteiramente)**
As instruções de IA também podem ser usadas para solicitar maior detalhe contextual, bem como sua formatação.
Exemplo solicitando contexto adicional:
[Histórico médico passado] (**Inclua qualquer histórico médico passado relevante, diagnósticos, cirurgias, visitas a especialistas.** **Inclua apenas se mencionado explicitamente na transcrição, contexto ou nota clínica; caso contrário, omita a secção inteiramente. Escreva como um parágrafo de frases completas.**)
Instruções globais no topo ou fundo do seu modelo:
Conteúdo desejado | Instrução Global de IA |
Nota breve/concisa | (Seja conciso e use afirmações breves ao longo da nota.) |
Terminologia médica formal | (Use terminologia médica formal em todo este documento. Evite coloquialismos e garanta que todos os termos clínicos sejam precisos e profissionalmente apropriados.) |
4. “Texto Textual”
O texto verbatim aparece exatamente igual em todas as notas geradas a partir do seu modelo. Está envolvido em aspas e é útil para:
Seus detalhes de prática
Encerramento padrão
Frases fixas que você sempre inclui
Exemplo em uma carta de referência:
"Obrigado pela sua gentil referência.
Dra. Sarah Doe
Clínica Geral
Centro Médico Sunrise Ph:
03 1234 5678"
Este texto aparecerá palavra por palavra em cada carta de referência que você gera usando o modelo relevante.
Juntando Tudo: Um Exemplo Completo
Eis como uma secção de modelo simples fica com todos os quatro componentes:
Subjetivo: [Queixa principal e história da doença atual] (Inclua apenas se mencionado explicitamente na transcrição, contexto ou nota clínica, caso contrário, omita a secção inteiramente. Escreva como um parágrafo fluente.) [Histórico médico passado] (Inclua apenas se mencionado explicitamente na transcrição, contexto ou nota clínica, caso contrário, omita a secção inteiramente. Escreva como uma lista com marcadores.) [Medicamentos atuais incluindo dosagens] (Inclua apenas se mencionado explicitamente na transcrição, contexto ou nota clínica, caso contrário, omita a secção inteiramente. Escreva como uma lista com marcadores.) [Alergias] (Inclua apenas se mencionado explicitamente na transcrição, contexto ou nota clínica, caso contrário, omita a secção inteiramente.) "O paciente consentiu que a consulta de hoje fosse registada para fins de documentação."
O que isto gera:
Subjetivo: A Sra. Thompson apresenta-se hoje com um histórico de 3 dias de piora de dor nas costas, que começou após levantar caixas pesadas enquanto se mudava. Ela descreve a dor como uma dor surda constante, classificada em 6/10, localizada na região lombar sem irradiação para as pernas.
Diabetes Tipo 2 (diagnosticada em 2018)
Hipertensão
Osteoartrite bilateral dos joelhos
Metformina 1000mg duas vezes ao dia
Lisinopril 10mg diariamente
Paracetamol conforme necessário
Sem alergias conhecidas
O paciente consentiu que a consulta de hoje fosse registada para fins de documentação.
Iniciando: O Construtor de Modelos
Agora que você compreende os blocos de construção, vamos criar seu primeiro modelo. O construtor de modelos da Heidi é uma ferramenta intuitiva, alimentada por IA, que permite criar modelos usando linguagem natural simples - nenhuma sintaxe especial necessária para começar.
Passo 1: Criar um Novo Modelo
Navegue para a Secção de Modelos: Aceda a Minha Biblioteca > Meus modelos no seu painel da Heidi. Aqui, encontrará a opção para criar um novo modelo, clicando em "Criar modelo" no canto superior direito da janela.
Selecione 'Nota ou documento' para iniciar o processo de criação do modelo.
A Heidi oferece duas opções para gerar um modelo, veja as opções A e B abaixo.
Opção A: Digite uma Descrição Manualmente (Recomendado)
Na caixa de entrada de texto, digite uma descrição do modelo que deseja criar (veja abaixo para exemplos).
Quando estiver pronto, selecione a seta no canto inferior direito.
A Heidi gerará um modelo completo baseado na sua descrição.
Ao escrever seu prompt, seja específico sobre:
O tipo de nota (por exemplo, SOAP, carta de referência, nota de progresso)
Sua especialidade ou contexto
Qualquer preferência de formatação
Exemplos de prompts:
"Criar uma nota SOAP para uma consulta de médico geral"
"Gerar uma nota de sessão de psicologia com exame do estado mental"
"Criar um modelo de carta de referência para referências ortopédicas, escrito em parágrafos"
Opção B: Carregar documentos de exemplo
Selecione o ícone de 'clipe de papel' no canto inferior esquerdo
Procure seus arquivos e localize o(s) documento(s) de exemplo
Selecione 'Abrir', o que solicitará à plataforma que anexe seu(s) documento(s)
Quando estiver pronto, selecione a seta no canto inferior direito
Quando usar: Se você já tiver notas clínicas que usa frequentemente, pode carregar até 5 documentos de exemplo. Usando estes, a Heidi irá:
Analisar a estrutura dos seus exemplos
Extrair o formato e as secções
Criar um modelo generalizado (removendo detalhes específicos do paciente, como nomes ou diagnósticos)
Isto é perfeito se você quiser que a Heidi corresponda exatamente ao seu estilo de documentação existente.
Com base na sua opção e entrada escolhidas, a Heidi gerará a estrutura do modelo, bem como um exemplo para mostrar-lhe qual será o conteúdo gerado potencial.
Passo 2: Revise Seu Modelo
Depois que a Heidi gera seu modelo, você vê duas visualizações:
Separador | O Que Mostra |
Exemplo | Uma nota de exemplo mostrando como seu conteúdo gerado ficará |
Estrutura | O modelo subjacente com marcadores de posição e instruções |
Exemplo:
Estrutura:
Revise o separador Exemplo primeiro - isso mostra exatamente o que a Heidi produzirá. Se parecer bom, você está pronto para salvar!
Editando Seu Modelo
Seu modelo não está ficando exatamente correto? Você tem várias maneiras de refinar seu modelo.
Opção A: Peça à Heidi para Fazer Alterações (Mais Fácil)
Na barra de entrada de texto na parte inferior do seu modelo, digite o que deseja alterar em inglês simples:
"Adicione uma secção de História Social em Subjetivo"
"Faça a secção Plano usar pontos com números"
"Altere o formato da data para DD/MM/AAAA"
A Heidi lida com toda a formatação técnica nos bastidores e fará a alteração para você. Você verá as alterações refletidas na visualização de Exemplo.
Opção B: Formatar Diretamente no Exemplo
Você pode colocar em negrito, itálico e sublinhar o texto diretamente na visualização de Exemplo:
Destaque o texto que deseja formatar
Use a barra de ferramentas de formatação que aparece
As alterações sincronizam automaticamente com a Estrutura
Isto é útil para colocar os títulos de secção em negrito ou enfatizar o texto chave.
Controle de Versão: Desfaça Qualquer Alteração
Se você fez uma alteração de que não gosta, a Heidi salva automaticamente cada versão do seu modelo.
Clique no menu suspenso Versão (topo do editor) para ver seu histórico de versão e restaurar qualquer versão anterior.
💡 Os modelos muitas vezes melhoram com refinamento. Após sua primeira sessão, revise o conteúdo gerado e ajuste seus marcadores de posição ou instruções conforme necessário.
Aplicar o seu modelo
Seu modelo está pronto - agora vamos usá-lo!
Como os Modelos Funcionam com Suas Sessões
Quando você aplica um modelo a uma sessão, a Heidi combina informações de:
A transcrição: O que foi dito durante a consulta
Notas contextuais: Quaisquer notas que você adicionou antes ou durante a sessão
Detalhes do paciente: Nome, idade, pronomes do registos do paciente
A Heidi mapeia essas informações na sua estrutura de modelo, produzindo uma nota clínica completa.
Usando Seu Modelo
Conclua uma sessão com um paciente
Aceda à sessão no seu painel da Heidi
Selecione seu modelo no menu suspenso de modelo
A Heidi gera a nota
Revise e faça as edições finais
Copie para seu sistema de gestão de prática, imprima ou envie por e-mail a nota.
Dica profissional: Defina um modelo como padrão padrão (alternar nas configurações de modelo) para ser selecionado automaticamente para novas sessões.
Dicas para o Sucesso
Faça ✅
Comece simples: Comece com um modelo básico e refine ao longo do tempo
Teste com sessões reais: Veja como o modelo funciona com consultas reais
Use a Comunidade de Modelos: Adapte modelos existentes, não há necessidade de reinventar a roda
Seja específico com marcadores de posição:
[Alergias incluindo gravidade e reações]funciona melhor do que[Alergias]
Evite ❌
Não inclua exemplos em marcadores de posição: Escreva
[Medicamentos]não[Medicamentos, ex. Metformina, Lisinopril]Não pule instruções de segurança: Sempre inclua "Inclua apenas se mencionado explicitamente..." para impedir que a Heidi invente informações
Não complique: Um modelo simples que funciona é melhor do que um complexo que confunde
Recursos Úteis
Está a ter dificuldade em compreender os modelos? Consulte a nossa comunidade de modelos para ver se já existe um para o seu caso. Tem à disposição recursos adicionais:
Guia escrito passo a passo: Guias - Construir Modelos [ Principiante ]
Tutorial em vídeo: Tutorial em vídeo sobre criar modelos
O Que Vem Depois?
Criar e utilizar modelos na Heidi é uma forma simples mas poderosa de melhorar o seu processo de documentação clínica. Com o novo construtor de modelos, você pode criar modelos usando linguagem simples sem precisar aprender nenhuma sintaxe especial. Para aqueles que desejam mais controle, compreender os 4 componentes permite que você ajuste seus modelos à perfeição.
Pronto para evoluir? Continue para nosso próximo tutorial:
Glossário de termos
Termo | Definição |
transcrição | O registo de áudio da conversa entre o profissional médico e o paciente |
notas contextuais | As notas contextuais feitas pelo profissional médico, que devem ser integradas na nota clínica fundadora |
detalhes do paciente | Detalhes específicos sobre o paciente que devem ser incluídos no documento |
modelo | O formato predefinido ou estrutura a que a nota clínica ou documento deve aderir |
voz | A voz e preferências de estilo únicas do profissional médico para escrever a nota: Breve, Padrão, Detalhado e Super Detalhado (ver: O que significam os diferentes Estilos de Voz?) |
linguagem | A transcrição está em inglês americano e treinada em terminologia médica. Se quiser alterar a ortografia, pode atualizar em Memória |
data hoje | A data atual no formato dd/mm/aaaa; pode definir seu formato de data em Memória |
encontro clínico | Toda informação pertencente à sessão, visita ou consulta de hoje - a transcrição, notas contextuais, detalhes do paciente, data de hoje, etc. |
requisitos | Requisitos e instruções específicas para escrever a nota clínica |
nota clínica | A nota clínica fundadora que precisa ser mapeada para o modelo |
marcador de posição | Texto entre parênteses retos descrevendo o tipo de informação médica que deve ser exibida |
instruções de IA | Texto entre parênteses guiando como tratar ou manipular informações |
texto literal | Texto entre aspas que deve ser incluído exatamente como está no conteúdo gerado |