Ir para conteúdo principal

Dominar os seus Modelos da Heidi: Um Guia Avançado

Para profissionais que desejam modelos dinâmicos e inteligentes que se adaptem a diferentes cenários clínicos.

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"

(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."**)

Se-Senão

"Se as alergias não forem mencionadas, escreva NKDA"

[Alergias](Incluir apenas alergias se explicitamente mencionado na transcrição, notas contextuais ou nota clínica. **Se não mencionado, imprima "NKDA"**)

Baseado em Idade

"Se o paciente tem menos de 18 anos, note consentimento do responsável"

[Consentimento do responsável] (**Se o paciente tem menos de 18 anos, imprima "Consentimento do responsável obtido." Se 18 anos ou mais, omita esta linha.**)

Baseado em Valor

"Se o IMC é superior a 30, recomende gestão de peso"

(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 discutida."**)

Baseado em Condição

"Se a diabetes é mencionada, inclua seguimento da HbA1c"

(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, imprima "Monitorização de HbA1c recomendada."**)

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

(Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir completamente a secção. Se [condição], imprima "[texto]". Se [alternativa], imprima "[texto alternativo]".)

Múltiplas Condições (E)

(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." Se nem todos os critérios forem cumpridos, omita completamente.)

Múltiplas Condições (OU)

(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 masculino OU tem menos de 50 anos OU realizou uma mamografia recente, omita esta recomendação completamente.)

Condicionais Aninhados

(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 é maior que 7%, imprima "Controlo inadequado." Se HbA1c menor ou igual a 7%, imprima "Controlo adequado." Se a diabetes não é mencionada, omita a secção.)

Condicional + Formatação

(Incluir apenas se explicitamente mencionado na transcrição, notas contextuais ou nota clínica, caso contrário omitir completamente a secção. Se múltiplas medicações são prescritas, liste cada uma numa nova linha com dosagem. Se apenas uma medicação, escreva numa única frase. Se nenhuma, imprima "Nenhuma medicação prescrita.")

Condicional Verbatim

(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 não-fumador, omita.)

Condicional do Modelo Geral

(Se esta é uma visita de seguimento, inclua a secção "Progresso Desde a Última Visita". Se esta é uma consulta inicial, omita essa secção completamente.)


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:

  1. Sessões ligadas

  2. 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

  1. Abra qualquer sessão e clique no campo de entrada "Adicionar Detalhes do Doente"

  2. Selecione o paciente ao qual pretende ligar a sessão, ou crie um novo paciente se não estiver listado

  3. 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.

  1. 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".

  2. 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.)

  3. 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:

  1. 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.

  2. 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.

  3. 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.

  4. 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

  1. Estrutura: Secções claras para historial, avaliação atual e plano

  2. Contexto histórico: Historial de diabetes anterior extraído de notas contextuais

  3. Avaliações condicionais: Controlo glicémico automaticamente interpretado com base em HbA1c

  4. Macros dinâmicos: Diferentes planos de gestão aparecem com base no nível de controlo

  5. Predefinições inteligentes: As secções de rastreio mostram "não realizado" se não mencionado

  6. 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

Isto respondeu à sua pergunta?