Bem-vindo à parte final da nossa série de tutoriais de modelos. Esta sessão trata-se de levar as suas competências de criação de modelos para o próximo nível, utilizando comandos avançados de IA para personalizar completamente os seus modelos na Heidi Health. Quer necessite de formatos específicos, ajustes de conteúdo dinâmico ou integração contínua de dados clínicos anteriores, este guia ajudá-lo-á a aproveitar as capacidades avançadas da Heidi para produzir documentação precisa e eficiente.
Este Guia é Para Você?
Este guia é para si se:
Os seus modelos básicos estão a funcionar, mas precisa de comportamento dinâmico
Quer diferentes conteúdos gerados com base em dados do paciente (por exemplo, idade, condições, valores de análises)
Está a criar modelos que lidam com múltiplos cenários
Precisa de incorporar informações históricas de sessões anteriores
Quer criar "macros" que preenchem automaticamente planos de gestão
⚠️ Ainda não está pronto? Se ainda está a familiarizar-se com o básico, comece aqui:
O Que Contém Este Guia
Secção Principal | O Que Vai Aprender |
Lógica Condicional | Criar modelos dinâmicos que se adaptam com base em dados do paciente |
Criar Macros Clínicos | Gerar automaticamente planos de gestão com base em condições |
Integração de Contexto Histórico na Documentação Atual | Incorporar dados de sessões anteriores |
Compreender Memória vs. Modelos vs. Textos Predefinidos | Quando utilizar cada funcionalidade |
Estudo de Caso: Juntar Tudo | Um passo a passo completo de um modelo avançado |
Resolução de Problemas Avançada | Problemas complexos e soluções |
Tutorial em Vídeo
Resumo das Técnicas de Nível Intermédio
Antes de mergulhar nas estratégias avançadas, vamos rever rapidamente algumas das técnicas intermédias que discutimos no artigo anterior:
Reformatação de Modelos: Explorámos como modificar modelos utilizando instruções de IA para seguir diretrizes de formatação específicas, como escrever a secção "Subjetivo" em forma narrativa sem pontos de bala.
Tipos de Instruções de IA: Introduzimos instruções básicas de IA para controlar o estilo do conteúdo, como utilizar frases completas ou formatar informações linha a linha. As instruções de IA podem ser específicas de um espaço reservado particular ou de uma secção particular, ou podem ser instruções gerais adicionadas no topo ou rodapé do seu modelo, separadas das secções/espaços reservados do seu modelo.
Com base nesses conceitos, exploraremos agora comandos de IA mais avançados para personalizar ainda mais as suas notas clínicas.
Utilizar o Construtor de Modelos para Edições Avançadas
Embora este guia se concentre na edição manual de modelos para controlo preciso, também pode utilizar o construtor de modelos para efetuar alterações avançadas. Simplesmente descreva o que pretende em inglês simples - eis alguns exemplos:
"Adicione lógica condicional para que se o paciente tiver menos de 18 anos, inclua uma nota sobre consentimento do responsável no início da nota"
"Se não forem mencionadas alergias, imprima 'NKDA'"
"Adicione tratamento de notas históricas para que a informação da sessão anterior seja incorporada, mas apenas a transcrição de hoje represente as conclusões atuais"
O construtor de modelos gerará a sintaxe apropriada com base na sua entrada. Pode então ver e refinar o código subjacente se necessário.
Comandos Avançados de IA para Personalização
A Heidi fornece várias definições incorporadas para ajudar a gerar notas clínicas em estilos específicos. No entanto, pode necessitar de anular estas predefinições para atender a requisitos particulares. Eis como pode utilizar comandos avançados de IA para adaptar os seus modelos.
Lógica Condicional (Instruções Condicionais)
A lógica condicional permite-lhe criar modelos dinâmicos que se adaptam automaticamente com base em dados do paciente. Esta é uma das funcionalidades avançadas mais poderosas.
Como Funciona a Lógica Condicional
Estrutura básica:
(Se [condição], imprima "[texto]". Se [condição alternativa], imprima "[texto alternativo]".)
A condição pode ser baseada em qualquer coisa mencionada na transcrição, notas contextuais ou detalhes do paciente - idade, diagnósticos, valores de análises, medicações, etc.
Referência Rápida: Padrões de Lógica Condicional
Padrão | Construtor de Modelos | Sintaxe Manual |
Condicional Simples Se-Então | "Se o paciente é fumador, adicione uma linha sobre cessação tabágica, incluindo aconselhamento fornecido e recursos de Quitline partilhados" |
|
Se-Senão | "Se as alergias não forem mencionadas, escreva NKDA" |
|
Baseado em Idade | "Se o paciente tem menos de 18 anos, note consentimento do responsável" |
|
Baseado em Valor | "Se o IMC é superior a 30, recomende gestão de peso" |
|
Baseado em Condição | "Se a diabetes é mencionada, inclua seguimento da HbA1c" |
|
Exemplo 1: Condicional Simples
Cenário: Pretende incluir aconselhamento sobre cessação tabágica apenas para pacientes que fumam.
Construtor de Modelos: "Se o paciente é fumador, adicione cessação tabágica incluindo aconselhamento fornecido e recursos de Quitline partilhados"
Edição Manual:
(Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir completamente a secção. Se o paciente é fumador, imprima "Aconselhamento sobre cessação tabágica fornecido. Recursos de Quitline partilhados." Se o paciente é não-fumador, omita esta declaração completamente.)
Exemplo 2: Condicional Baseado em Idade
Cenário: Quer diferentes termos de consentimento para pacientes pediátricos vs adultos.
Construtor de Modelos: "Se o paciente tem menos de 18 anos, note que foi obtido consentimento do responsável"
Edição Manual:
[Consentimento] (Se o paciente tem menos de 18 anos, imprima "Consentimento do responsável/progenitor obtido para a consulta de hoje." Se o paciente tem 18 anos ou mais, imprima "Consentimento do paciente obtido para a consulta de hoje.")
Exemplo 3: Condicional de Valor de Análise
Cenário: Pretende fornecer diferentes recomendações com base em níveis de HbA1c.
Construtor de Modelos: "Adicione avaliação de controlo glicémico com base no nível de HbA1c"
Edição Manual:
[Avaliação glicémica] (Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir completamente a secção. Se HbA1c é superior a 8%, imprima "Controlo glicémico inadequado - intensificação do tratamento recomendada." Se HbA1c é entre 7% e 8%, imprima "Controlo glicémico subótimo - revise adesão medicamentosa e fatores de estilo de vida." Se HbA1c é 7% ou inferior, imprima "Controlo glicémico adequado - continue a gestão atual.")
Exemplo 4: Múltiplas Condições (E/OU)
Cenário: Quer recomendações de rastreio para grupos específicos de pacientes.
Construtor de Modelos: "Se a paciente é do sexo feminino E tem mais de 50 anos E não realizou uma mamografia recente, recomende rastreio mamográfico"
Edição Manual:
[Recomendações de rastreio] (Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir completamente a secção. Se a paciente é do sexo feminino E tem mais de 50 anos E não realizou uma mamografia recente, imprima "Recomende rastreio mamográfico - a paciente cumpre os critérios de rastreio do cancro da mama." Se estes critérios não forem todos cumpridos, omita esta recomendação completamente.)
Exemplo 5: Condicionais Aninhados
Cenário: Quer aconselhamento específico sobre diabetes, mas apenas quando a diabetes é relevante.
Construtor de Modelos: "Se a diabetes é mencionada, avalie o controlo glicémico com base na HbA1c"
Edição Manual:
[Gestão de diabetes] (Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir completamente a secção. Se a diabetes é mencionada, então: Se HbA1c é superior a 7%, imprima "Controlo glicémico inadequado - intensifique o tratamento." Se HbA1c é 7% ou inferior, imprima "Controlo glicémico adequado - continue a gestão atual." Se a diabetes não é mencionada, omita esta secção completamente.)
Tabela de Referência de Lógica Condicional
Tipo | Instrução de Exemplo |
Condicional Simples |
|
Múltiplas Condições (E) |
|
Múltiplas Condições (OU) |
|
Condicionais Aninhados |
|
Condicional + Formatação |
|
Condicional Verbatim |
|
Condicional do Modelo Geral |
|
Criar Macros Clínicos
As macros são blocos de texto pré-definidos que são automaticamente inseridos no conteúdo gerado do seu modelo quando certas condições são cumpridas. Isto torna as macros uma ferramenta excelente para planos de gestão padronizados.
Como Funcionam as Macros
Uma macro é uma combinação de lógica condicional com texto verbatim. Quando uma declaração de lógica condicional é cumprida, o texto verbatim subsequente será impresso.
Pode inserir múltiplas macros dentro de um modelo, para se preparar para múltiplos cenários.
Exemplo: Macro de Gestão de DRC
Cenário: Quer que diferentes planos de gestão apareçam automaticamente com base em níveis de creatinina.
Plano:
(Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir completamente a secção. Se a creatinina é superior a 1,5 mg/dL e inferior ou igual a 2,0 mg/dL, imprima:
"Plano de Gestão para DRC Estágio 1:
- Monitorizar testes de função renal (creatinina sérica, TFG) a cada 6-12 meses
- Recomendar modificações do estilo de vida: dieta pobre em sódio, atividade física regular
- Controlo da tensão arterial: Objetivo PA < 140/90 mmHg utilizando inibidores de ACE ou BRA
- Evitar fármacos nefrotóxicos (p. ex., AINEs), tabagismo e consumo de álcool")
(Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir completamente a secção. Se a creatinina é superior a 2,0 mg/dL, imprima:
"Plano de Gestão para DRC Estágio 2:
- Monitorizar testes de função renal (creatinina sérica, TFG) a cada 3-6 meses
- Dieta pobre em proteínas (0,8 g/kg de peso corporal por dia), continuar dieta pobre em sódio
- Controlo da tensão arterial: Objetivo PA < 130/80 mmHg com inibidores de ACE ou BRA
- Referenciação para um nefrologista para avaliação e cogestão
- Discutiu a possível necessidade de TRS se for antecipada progressão para Estágio 3 ou superior
- Encorajou vacinações (gripe, pneumocócica, hepatite B) conforme apropriado")
Compreenda este exemplo: se a creatinina do paciente é mencionada como 1,8 mg/dL durante a consulta, o plano de Estágio 1 aparece automaticamente. Se é 2,3 mg/dL, o plano de Estágio 2 aparece em seu lugar.
Mais Exemplos de Macros
Gestão da Hipertensão:
(Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir completamente a secção. Se a pressão arterial sistólica é superior a 160 mmHg, imprima:
"Gestão da Hipertensão - Grave:
- Iniciação/ajuste de medicação imediata necessária
- Considere terapia combinada - Revise em 2 semanas
- Monitorização da PA em casa recomendada")
(Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir completamente a secção. Se a pressão arterial sistólica está entre 140 e 160 mmHg, imprima:
"Gestão da Hipertensão - Moderada:
- Modificações no estilo de vida: dieta DASH, restrição de sódio, exercício
- Revisão de medicação
- considere iniciação se as medidas de estilo de vida forem insuficientes
- Revise em 4-6 semanas")
Aconselhamento Baseado em IMC:
(Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir completamente a secção. Se o IMC é maior que 30, imprima:
"Gestão de Peso:
- Discutiu riscos à saúde associados à obesidade
- Aconselhamento sobre modificação de estilo de vida fornecido
- Considere referenciação para um dietista
- Defina objetivo realista de perda de peso de 5-10% do peso corporal durante 6 meses
- Revise em 4 semanas")
Integração de Contexto Histórico na Documentação Atual
Muitas vezes, é necessário incorporar dados de sessões ou encontros anteriores para fornecer uma imagem clínica abrangente. Os modelos da Heidi podem extrair dinamicamente informações de notas contextuais (ou seja, notas adicionais incluindo encontros de saúde anteriores) que introduz no separador Contexto na Heidi.
Existem 2 formas de fazer isto na Heidi:
Sessões ligadas
Adicione manualmente contexto histórico no separador Contexto
1. Sessões Ligadas
As sessões ligadas permitem-lhe incorporar dados de pacientes históricos na sua documentação atual, permitindo cuidados mais abrangentes e contínuos ao paciente em vez de instantâneos isolados.
Como Ligar uma Sessão a um Paciente
Abra qualquer sessão e clique no campo de entrada "Adicionar Detalhes do Doente"
Selecione o paciente ao qual pretende ligar a sessão, ou crie um novo paciente se não estiver listado
A sessão será agora ligada a esse perfil de paciente
Como Incluir Sessões Anteriores no Contexto:
Para qualquer sessão ligada, pode escolher quais as sessões anteriores a incluir como contexto para a sua documentação. As sessões aparecem automaticamente com as três sessões anteriores mais recentes como predefinição se estiver a utilizar pacientes ligados.
Se você não deseja incluí-las, desmarque manualmente a caixa no canto inferior esquerdo da janela de transcrição.
Considerações Importantes para Sessões Ligadas
Limite de sessão: Limitado a 3 sessões anteriores nesta fase para manter a qualidade do conteúdo gerado elevada - isto é algo que estamos a procurar expandir em futuras atualizações.
Mudanças de contexto: Se alterar as sessões incluídas no seu contexto, um botão Sincronizar irá aparecer para atualizar o seu conteúdo gerado em conformidade.
Sessões eliminadas: Se eliminar as suas sessões, não conseguirá utilizar esta funcionalidade para essas sessões.
2. Utilizar Notas Contextuais para Visitas de Seguimento
Este cenário funciona melhor se preferir não ligar pacientes e preferir carregar manualmente a nota clínica anterior para a sessão cada vez. Isto dá-lhe maior controlo sobre qual historial gostaria de carregar.
Cenário de exemplo: suponha que está a documentar uma sessão de seguimento para um paciente com queimaduras e quer incluir informações relevantes da consulta inicial.
Incluir Contexto Anterior no Seu Modelo:
Primeiro, encontre e copie os detalhes relevantes da sessão inicial/anterior para a secção "Contexto", ou carregue um documento contendo informações de pacientes históricas diretamente para a secção "Contexto".
Adicione Instruções Contextuais ao seu modelo:
Inclua uma instrução de IA global como:
(As notas contextuais conterão notas clínicas ou resumos de encontros de saúde anteriores. Certifique-se de que estes são resumidos e incorporados nas notas clínicas atuais para o mesmo paciente.)ou
(As notas contextuais conterão notas clínicas ou resumos de encontros de saúde anteriores. A informação histórica deve ser incorporada onde relevante como informação de contexto. Apenas a informação da transcrição de hoje deve ser documentada como conclusões de hoje, resultados de exame ou estado atual. Distinga claramente entre informação histórica e conclusões atuais.)
Guardar, Atualizar e Regenerar:
Quando regenerar o conteúdo gerado, a Heidi extrairá automaticamente os dados históricos relevantes, como tratamentos anteriores, progresso ou resultados de diagnóstico, e incorporá-los-á na documentação atual.
Este método garante que as suas notas de seguimento sejam completas e reflitam com precisão o historial clínico do paciente. Isto reduz redundância e melhora a clareza.
Aproveitar Técnicas Avançadas para Controlo Melhorado
Para fazer uso completo destes comandos avançados, considere as seguintes estratégias:
Utilizar Linguagem e Terminologia Precisas:
A IA da Heidi responde melhor a termos específicos e vocabulário consistente. Por exemplo, utilize "registo de áudio" para referir-se às conversas entre o paciente e o profissional médico, ou "nota contextual" e "nota clínica" para denotar dados de encontros de saúde anteriores. Isto ajuda a Heidi a interpretar com precisão as suas instruções.
Experimentar com Colocação de Instruções:
As instruções gerais de IA às vezes funcionam melhor no início ou fim de um modelo. Se uma instrução não está funcionando como esperado, tente movê-la.
Utilizar Lógica Condicional para Automatizar Decisões:
As instruções condicionais podem tornar os seus modelos mais dinâmicos e adaptativos. Experimente vários cenários para automatizar decisões baseadas em dados de pacientes, como resultados de análises, sinais vitais ou diagnósticos anteriores.
Consulte o Glossário de Prompts para Comandos Precisos:
A Heidi utiliza termos específicos para rotular diferentes tipos de dados. Por exemplo:
"Registo de áudio" refere-se ao texto da conversa.
"Notas contextuais" são resumos de encontros de saúde anteriores.
"Detalhes do paciente" incluem informações pessoais como nome, idade ou pronomes.
"Nota clínica" é o documento principal do qual outros documentos são derivados.
Utilizar os termos corretos do glossário garante que a Heidi interpreta com precisão os seus comandos, resultando em conteúdos gerados mais precisos.
Compreender Memória vs. Modelos vs. Textos Predefinidos
Para utilizadores avançados de modelos, é importante compreender quando utilizar modelos versus outras funcionalidades da Heidi:
Funcionalidade | Melhor Para | Âmbito | Exemplos |
Memória | Preferências do profissional médico individual ou em toda a organização que se aplicam em toda a parte | Todos os modelos, todas as sessões | Formato de data (DD/MM/AAAA), ortografia (Inglês Australiano), abreviaturas aprovadas |
Modelos | Estrutura específica de notas e lógica condicional | Um tipo de modelo | Formato SOAP, estrutura de carta de referenciação, requisitos específicos de especialidade |
Textos predefinidos | Blocos de texto reutilizáveis que insere manualmente | Inserção sob demanda | Texto de educação de pacientes padrão, encerramentos de cartas de referenciação, aconselhamento de segurança |
Quando Utilizar Memória
✅ Utilizar Memória para:
Formatos de data e hora
Convenções de ortografia (Inglês RU/EUA/AU)
Abreviaturas padrão que você ou sua clínica utiliza
Unidades predefinidas (métrico/imperial)
Detalhes da sua clínica (nome, morada, contacto)
Quando Utilizar Modelos
✅ Utilizar Modelos para:
Estrutura de nota (SOAP, HOPC, baseado em problemas)
Lógica condicional (instruções condicionais)
Formatação específica da secção
Requisitos do tipo de documento (referenciação vs nota de progresso)
Quando Utilizar Textos Predefinidos
✅ Utilizar Textos Predefinidos para:
Materiais de educação de pacientes que partilha frequentemente
Redação de consentimento
Instruções de medicação
Encerramentos de cartas de referenciação
Aconselhamento de segurança
Estudo de Caso: Juntar Tudo
Vamos criar um modelo avançado completo para uma Revisão Diabética que inclua:
Lógica condicional para avaliação de controlo glicémico
Plano de gestão automática com base em HbA1c
Integração de contexto histórico
Recomendações de rastreio dinâmico
Modelo Completo: Revisão Diabética
Nota de Revisão Diabética
Data: [Data da consulta]
Paciente: [Nome do paciente], [Idade] anos
(Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir completamente a secção. Escreva como uma declaração breve.)
Motivo da Visita: [Razão para a revisão diabética de hoje]
(Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir completamente a secção. Escreva como uma declaração breve.)
Historial de Diabetes: [Resumo do historial de diabetes, incluindo tipo, duração e complicações anteriores] (Incorpore historial relevante das notas contextuais se fornecidas. Isto representa contexto histórico.)
Gestão Atual de Diabetes: [Medicações atuais de diabetes com doses] (Incluir apenas se explicitamente mencionado na transcrição, contexto ou nota clínica, caso contrário omitir a secção completamente. Escreva como uma lista com marcadores.)
Avaliação de Hoje:
Controlo Glicémico: [Resultado de HbA1c e interpretação] (Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir a secção completamente. Se HbA1c é superior a 8%, imprima "Avaliação: Controlo glicémico inadequado requerendo intensificação do tratamento." Se HbA1c está entre 7% e 8%, imprima "Avaliação: Controlo glicémico subótimo - revise adesão e fatores de estilo de vida." Se HbA1c é 7% ou inferior, imprima "Avaliação: Controlo glicémico adequado - continue a gestão atual.")
Pressão Arterial: [Leitura de pressão arterial] (Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir a secção completamente.)
Peso/IMC: [Peso e IMC se disponível] (Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir a secção completamente.)
Rastreio de Complicações: [Constatações do exame do pé] (Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário imprima "Exame do pé: Não realizado hoje")
[Estado de rastreio oftalmológico] (Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário imprima "Rastreio retiniano: Estado desconhecido - considere referenciação")
[Função renal] (Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir a secção completamente.)
Plano: (Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir a secção completamente. Se HbA1c é superior a 8%, imprima: "Plano de Gestão - Controlo Inadequado:
1. Ajuste de medicação: - [Mudanças específicas a serem determinadas pelo profissional médico] - Considere adição de segundo agente ou iniciação de insulina
2. Reforço do estilo de vida:- Revisão dietética - refira a um dietista
- Prescrição de exercício
- 150 minutos de atividade moderada por semana
3. Monitorização:
- Aumente a frequência de monitorização da glicose em casa
- Repetir HbA1c em 3 meses
4. Seguimento:
- Revise em 4 semanas para avaliar a resposta")
(Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir completamente a secção. Se HbA1c está entre 7% e 8%, imprima:
"Plano de Gestão - Controlo Subótimo:
1. Revise a adesão medicamentosa
2. Reforce medidas de estilo de vida
3. Repetir HbA1c em 3 meses
4. Seguimento em 6-8 semanas")
(Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir completamente a secção. Se HbA1c é 7% ou inferior, imprima:
"Plano de Gestão - Controlo Adequado:
1. Continue medicações atuais sem alterações
2. Rastreio anual de complicações devido
3. Repetir HbA1c em 6 meses
4. Seguimento rotineiro em 3-6 meses")
(Refira-se sempre ao paciente pelo seu nome, se disponível. Utilize ortografia do Inglês Australiano em toda a parte. Utilize formato DD/MM/AAAA para todas as datas.)
Como Funciona Este Modelo
Estrutura: Secções claras para historial, avaliação atual e plano
Contexto histórico: Historial de diabetes anterior extraído de notas contextuais
Avaliações condicionais: Controlo glicémico automaticamente interpretado com base em HbA1c
Macros dinâmicos: Diferentes planos de gestão aparecem com base no nível de controlo
Predefinições inteligentes: As secções de rastreio mostram "não realizado" se não mencionado
Instruções globais: Formatação consistente em toda a parte
Resolução de Problemas Avançada
Layout Complexo Não Está a Ser Renderizado Corretamente
Problema: O seu modelo tem múltiplas secções e lógica condicional, mas o conteúdo gerado é confuso ou incompleto.
Soluções:
Simplifique e isole - Remova temporariamente as secções para identificar qual está a causar problemas
Procure instruções conflituantes - Duas instruções que se contradizem podem causar comportamento imprevisível
Garanta que as condicionais estão adequadamente fechadas - Cada "Se" deve ter um resultado claro:
❌ (Se diabético, inclua HbA1c)
✅ (Se diabético, imprima "Monitorização de HbA1c recomendada." Se não diabético, omita completamente.)
Tente mover as instruções globais - Mova do final para o início do modelo (ou vice-versa)
Lógica Condicional Não Está a Ser Acionada
Problema: As suas declarações se-então não estão a produzir o conteúdo gerado esperado.
Soluções:
Faça corresponder a terminologia - Utilize termos que correspondam ao que está realmente na transcrição:
❌ (Se diabético...)
✅ (Se a diabetes ou diabético for mencionado...)
Seja mais explícito - Especifique exatamente o que dispara a condição:
❌ (Se HbA1c é alta...)
✅ (Se HbA1c é superior a 7%...)
Verifique a fonte de dados - Garanta que a informação em que a condição se baseia está realmente na transcrição ou nas notas contextuais
Contexto Histórico Está Sendo Confundido com as Conclusões de Hoje
Problema: A Heidi está a misturar informações históricas do contexto com conclusões atuais de hoje.
Solução: Adicione esta instrução global:
(As notas históricas de sessões anteriores são fornecidas nas notas contextuais e devem ser incorporadas onde relevante como informação de contexto. Apenas a informação da transcrição de hoje deve ser documentada como conclusões de hoje, resultados de exame ou estado atual. Não apresente informações históricas como conclusões atuais.)
Termos Sensíveis Estão Sendo Filtrados
Problema: Termos clinicamente relevantes (incluindo profanidade relatada pelo paciente) estão a ser removidos das notas.
Solução: Adicione esta instrução se for clinicamente relevante:
(Inclua verbatim qualquer linguagem clinicamente relevante utilizada pelo paciente, mesmo que inclua profanidade ou termos sensíveis, pois isto pode ser importante para documentação clínica precisa.)
Melhores Práticas para Modelos Avançados
Faça ✅
Comece com um modelo básico funcional antes de adicionar funcionalidades avançadas
Teste condicionais um de cada vez - adicione complexidade gradualmente
Utilize condições claras e específicas - "Se HbA1c > 8%" não "Se HbA1c é alta"
Inclua opções de contingência - o que acontece se a condição não for cumprida?
Evite ❌
Sobrecomplicar - se precisar de 10+ condicionais, considere usar múltiplos modelos em vez disso
Condições vagas - "Se relevante" ou "Se apropriado" não funcionará de forma fiável
Condicionais aninhados mais profundos que 3 níveis
Presumir que a Heidi pode calcular - Note que enquanto a Heidi lida bem com comparações de valor (por exemplo, "Se TA > 160"), cálculos aritméticos e aritmética de datas não são fiáveis.
Glossário de Prompts
Criámos um glossário de prompts com termos específicos comumente utilizados nos nossos prompts base. Utilizar estes termos nos seus modelos resultará em conteúdos gerados de qualidade superior.
Exemplo: Sempre refira-se à conversa entre o profissional médico e o paciente como "registo de áudio" em vez de "a conversa" ou outras variações.
Termo | Definição |
registo de áudio | 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. |
estrutura | A estrutura ou formato preferido para a nota clínica como especificado pelo profissional médico, essencialmente um modelo de nota. |
modelo | O formato predefinido ou estrutura a que a nota clínica ou documento deve aderir. |
voz | As preferências de voz e estilo únicos do profissional médico para escrever a nota. Breve, Padrão, Detalhado e Super Detalhado. |
idioma | O registo de áudio está em inglês americano e especificamente treinado em terminologia médica. Se quer utilizar inglês britânico ou australiano, utilize especificamente os termos Inglês Britânico. |
data de hoje | A data atual no formato dd/mm/aaaa, com instruções para reformatar para EUA/Canadá. |
encontro de saúde | Como nos referimos a todas as informações pertencentes à sessão, visita ou consulta de hoje, essencialmente o registo de áudio, as 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. |
espaço reservado | 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. |
palavra por palavra | Texto entre aspas que deve ser incluído exatamente como está no conteúdo gerado. |
instrução de segurança | Uma instrução de IA que garante que o conteúdo é incluído apenas se explicitamente mencionado, prevenindo que a IA infira ou assuma informações. |
instrução global | Uma instrução de IA colocada no início ou fim de um modelo que se aplica ao documento inteiro em vez de uma secção específica. |
lógica condicional | Instruções condicionais que criam modelos dinâmicos que se adaptam a diferentes cenários clínicos com base em dados do paciente. |
macro | Um bloco predefinido de texto ou instruções acionado por lógica condicional com base em critérios específicos. |
O Que Vem Depois?
🎉 Parabéns! Completou a série de tutoriais de modelos da Heidi.
Agora tem o conhecimento para criar modelos sofisticados e dinâmicos que podem:
Adaptar-se a diferentes cenários de pacientes
Gerar automaticamente planos de gestão
Integrar contexto histórico
Lidar com procedimentos clínicos complexos
Continuar a Aprender
🌐 Comunidade de Modelos - Partilhe os seus modelos e aprenda com outros
📖 Adicionar um Modelo à Comunidade - Contribua com as suas criações
💬 Suporte - Entre em contacto com a nossa equipa de suporte através do botão Ajuda
Ligações Rápidas
⬅️ Criar modelos na Heidi: um guia básico - Reveja os fundamentos
⬅️ Melhorar os seus modelos Heidi: um guia intermédio - Formatação e resolução de problemas

