Ti diamo nuovamente il benvenuto nella serie di tutorial sui modelli di Heidi Health. Ora che hai familiarità con le basi della creazione di modelli, è il momento di esplorare tecniche più avanzate. In questo articolo, approfondiremo il perfezionamento dei tuoi modelli, permettendoti di sfruttare ulteriormente la potenza dell'intelligenza artificiale di Heidi per soddisfare le tue esigenze specifiche.
⚠️ Nuovo ai modelli di Heidi? Inizia dalle basi prima → Creare modelli in Heidi: una guida di base
Cosa c'è in questa guida
Sezione chiave | Argomenti trattati |
Due metodi per affinare i modelli | Template Builder rispetto alla modifica manuale |
Modifica della formattazione e della lunghezza | Paragrafi, punti elenco, sintetico rispetto a dettagliato |
Gestione delle informazioni mancanti | Cosa fare quando le informazioni non sono menzionate durante una consultazione |
Creazione di elenchi e formati speciali | Elenchi numerati, sottopunti elenco, formati misti |
Istruzioni globali | Impostazioni che si applicano all'intero modello |
Risoluzione dei problemi | Problemi comuni e come risolverli |
Tutorial video
Due metodi per affinare i tuoi modelli
Esistono due approcci per migliorare i tuoi modelli:
Approccio | Ideale per | Livello di competenza |
Generatore di modelli | Modifiche rapide, ritocchi di formattazione, per la maggior parte degli utenti | Amichevole per i principianti |
Modifica manuale | Controllo preciso, requisiti complessi | Richiede la comprensione della sintassi |
La nostra raccomandazione: inizia con il Template Builder. Se non riesci a ottenere quello di cui hai bisogno, passa alla modifica manuale.
Questa guida copre ogni tecnica in dettaglio, quindi puoi scegliere cosa funziona meglio per te.
Riepilogo rapido: i 4 componenti del modello
Prima di addentrarci, ecco un rapido promemoria della sintassi:
Componente | Sintassi | Esempio |
Intestazione di sezione | Testo semplice |
|
Segnaposto |
|
|
Istruzione AI |
|
|
Verbatim |
|
|
Regole di igiene delle parentesi
Seguire queste regole garantisce che Heidi interpreti correttamente il tuo modello:
✅ Sì:
Metti i segnaposti tra parentesi quadre:
[Contenuto da inserire]Metti le istruzioni tra parentesi:
(Come formattarlo)Mantieni le istruzioni immediatamente dopo il loro segnaposto
❌ Evita:
Annidare le parentesi tra le parentesi
Mescolare i tipi di parentesi
Includere esempi all'interno dei segnaposti
💡 Per ottenere il massimo dai tuoi modelli, comunica con Heidi utilizzando istruzioni chiare e specifiche. Più diretto è il tuo linguaggio, meglio Heidi comprende ciò di cui hai bisogno.
Modifica della formattazione e della lunghezza
Uno dei perfezionamenti più comuni è modificare come Heidi formatta il tuo testo generato.
Riferimento rapido: comandi di formattazione
Cosa desideri | Template Builder (digita questo) | Modifica manuale (aggiungi questa istruzione) |
Paragrafi invece di punti elenco | "Scrivi la sezione soggettiva come un paragrafo fluido, non punti elenco" |
|
Riga dopo riga senza punti elenco | "Scrivi ogni elemento su una propria riga senza punti elenco" |
|
Testo generato breve/sintetico | "Rendi la sezione soggettiva più breve e sintetica" |
|
Testo generato più dettagliato | "Rendi la sezione del piano più dettagliata" |
|
Elenco numerato | "Presenta i farmaci come un elenco numerato" |
|
Elenchi puntati | "Usa punti elenco per la storia medica passata" |
|
💡 Usa il linguaggio naturale per le istruzioni AI: il linguaggio chiaro e quotidiano produce i migliori risultati. Istruzioni semplici come "Scrivi questa sezione come un racconto" sono più efficaci rispetto alla formulazione tecnica o vaga - quindi mantienilo naturale, ma mantienilo specifico.
Esempio 1: conversione di punti elenco in paragrafi
Il problema: Heidi restituisce la tua sezione soggettiva come punti elenco, ma preferisci il testo narrativo fluido.
Soluzione Template Builder:
Digita nella chat: "Scrivi la sezione soggettiva come un paragrafo fluido, non punti elenco"
Soluzione modifica manuale:
Vai alla scheda Struttura
Trova la sezione Soggettiva
Rimuovi i caratteri dei punti elenco (- o •) dal modello
Aggiungi questa istruzione dopo il tuo segnaposto:
[Lamentela principale e storia della malattia attuale] (Includi solo se esplicitamente menzionato nella trascrizione, nelle note contestuali o nelle note cliniche, altrimenti ometti interamente la sezione. Non usare mai punti elenco. Scrivi in frasi complete utilizzando il formato paragrafo.)
Prima
Soggettivo:
Maschio di 45 anni che si presenta con dolore toracico
Il dolore è iniziato 2 giorni fa
Descritto come una sensazione di pressione stretta
Si irradia al braccio sinistro
Dopo
Soggettiva: il signor Johnson è un maschio di 45 anni che si presenta con dolore toracico iniziato 2 giorni fa. Descrive il dolore come una sensazione di pressione stretta che si irradia al braccio sinistro.
Esempio 2: formato riga per riga senza punti elenco
Il problema: desideri che ogni informazione sia su una propria riga, ma senza punti elenco o formato paragrafo.
Soluzione Template Builder:
Digita: "Scrivi ogni elemento su una propria riga senza punti elenco o formato paragrafo"
Soluzione modifica manuale:
[Anamnesi medica] (Includi solo se esplicitamente menzionato nella trascrizione, nelle note contestuali o nelle note cliniche, altrimenti ometti interamente la sezione. Scrivi ogni condizione su una propria riga. Non usare punti elenco, trattini o formato paragrafo.)
Testo generato:
Anamnesi patologica remota:
Diabete mellito di tipo 2 (diagnosticato 2018)
Ipertensione
Ipercolesterolemia
Artrosi bilaterale delle ginocchia
Esempio 3: testo generato breve rispetto a dettagliato
Per una nota più concisa:
Metodo | Cosa fare |
Generatore di modelli | "Rendi l'intera nota più breve e sintetica" |
Modifica manuale | Aggiungi alla fine del tuo modello: |
Per una nota più dettagliata:
Metodo | Cosa fare |
Generatore di modelli | "Rendi la sezione del piano più completa e dettagliata" |
Modifica manuale | Aggiungi alla sezione specifica: |
💡 Non dimenticare l'impostazione Voce: Sintesi, Equilibrato, Dettagliato, Estremamente dettagliato. Questo controlla lo stile di testo generato su tutti i tuoi modelli, il che può farti risparmiare dall'aggiungere istruzioni di lunghezza a ogni sezione individualmente.
Vale la pena notare: 'Estremamente dettagliato' è progettato per includere citazioni dirette - quindi se non è quello che stai cercando, passa a Dettagliato. Otterrai esattamente lo stesso livello di dettaglio, solo senza le citazioni.
Gestione delle informazioni mancanti
Cosa dovrebbe fare Heidi quando le informazioni non sono menzionate nella consultazione? Hai diverse opzioni.
Comportamento desiderato | Generatore di modelli | Istruzione manuale |
Ometti interamente la sezione (istruzione standard) | "Se le allergie non sono menzionate, lascia fuori completamente quella sezione" |
|
Stampa "Non menzionato" | "Se le allergie non sono discusse, scrivi 'Non menzionato'" |
|
Stampa "Non discusso" | "Se la storia sociale non è affrontata, scrivi 'Non discusso'" |
|
Stampa "Nulla" | "Se non ci sono allergie, scrivi 'Nulla'" |
|
Stampa "NKDA" (allergie) | "Se le allergie non sono menzionate, impostazione predefinita su 'NKDA'" |
|
Stampa "Nulla di rilievo" | "Se nulla è discusso per la storia passata, scrivi 'Nulla di rilievo'" |
|
Creazione di elenchi e formati speciali
Elenchi numerati
Template Builder:
Digita nella chat: "Crea un elenco numerato dei farmaci con ognuno su una nuova riga"
Modifica manuale:
[Farmaci attuali con dosaggi e frequenza] (Includi solo se esplicitamente menzionato nella trascrizione, nelle note contestuali o nelle note cliniche, altrimenti ometti interamente la sezione. Scrivi come un elenco numerato con ogni farmaco su una nuova riga.)
Testo generato:
Farmaci:
Metformina 1000mg due volte al giorno
Lisinopril 10 mg una volta al giorno
Atorvastatina 20 mg di sera
Elenchi numerati con sottopunti elenco
Template Builder:
Digita nella chat: "Crea un piano di gestione con un elenco numerato con sottopunti per i dettagli sotto ogni elemento"
Modifica manuale:
[Piano di gestione] (Includi solo se esplicitamente menzionato nella trascrizione, nelle note contestuali o nelle note cliniche, altrimenti ometti interamente la sezione. Scrivi come un elenco numerato con ogni elemento principale come numero. Se un elemento ha sottopunti, scrivili come punti elenco rientrati sotto quel numero.)
Testo generato:
Piano:
1. Modifiche dello stile di vita
Ridurre l'assunzione di sodio
Aumentare l'attività fisica a 30 minuti al giorno
Obiettivo di perdita di peso di 5 kg in 3 mesi
2. Regolazione dei farmaci
Aumentare il lisinopril a 20 mg al giorno
Continuare la metformina invariata
3. Follow-up
Rivalutazione tra 4 settimane
Ripeti gli esami del sangue prima dell'appuntamento
Formato misto con intestazioni e punti elenco
Template Builder:
Digita nella chat: "Scrivi l'esame fisico con intestazioni di sistema in grassetto seguiti da i risultati come punti elenco sottostanti"
Modifica manuale:
[Risultati dell'esame fisico] (Includi solo se esplicitamente menzionato nella trascrizione, nelle note contestuali o nelle note cliniche, altrimenti ometti interamente la sezione. Scrivi con intestazioni di sistema in grassetto seguiti dai risultati rilevanti come punti elenco sotto ogni sistema.)
Testo generato:
Esame:
Cardiovascolare:
Frequenza cardiaca 78 bpm, regolare
Pressione sanguigna 145/92 mmHg
Suoni cardiaci doppi, nessun soffio
Respiratorio:
Torace chiaro bilateralmente
Nessun sibilo o crepitii
Frequenza respiratoria 16
Istruzioni globali
Le istruzioni globali si applicano all'intero modello piuttosto che a una sezione specifica. Posizionali all'inizio o alla fine del tuo modello.
Istruzioni globali comuni
Scopo | Generatore di modelli | Istruzione manuale (alla fine del modello) |
Usa il nome del paziente | "Fai sempre riferimento al paziente per il suo nome" |
|
Prospettiva in prima persona | "Scrivi la nota dalla mia prospettiva utilizzando 'io'" |
|
Ortografia britannica/australiana | "Usa l'ortografia britannica/australiana in tutto" |
|
Formato della data | "Usa il formato GG/MM/AAAA per tutte le date" |
|
Unità metriche | "Usa le unità metriche in tutto" |
|
Valuta | "Registra tutti i pagamenti in AUD" |
|
Tono formale | "Usa la terminologia medica formale in tutto" |
|
Linguaggio favorevole al paziente | "Usa un linguaggio semplice che un paziente potrebbe capire" |
|
Esempio: istruzione globale per lettere di invio
Per le lettere di invio, potresti desiderare un tono specifico:
Template Builder:
Digita nella chat: "Scrivi questa lettera in seconda persona, rivolgendoti direttamente allo specialista come 'tu'"
Modifica manuale (inserisci alla fine del tuo modello):
(Scrivi questa lettera in voce seconda persona, rivolgendoti direttamente al personale medico ricevente come 'tu' in tutto. Non fare mai riferimento a loro in terza persona come 'lo specialista' o 'il medico'. Mantieni un tono professionale e collegiale.)
Suggerimenti professionali per modelli efficaci
Sii specifico con i segnaposti
Invece di segnaposti vaghi, sii esplicito su cosa includere:
❌ Vago | ✅ Specifico |
|
|
|
|
|
|
Parole di istruzione forte
Per le istruzioni che devono essere seguite con precisione:
Più debole | Più forte |
"Prova a usare..." | "Usa sempre..." |
"Preferisci..." | "Non usare mai..." |
"Dovresti..." | "Devi..." |
"Scrivi..." | "Stampa..." (per testo fisso esatto) |
Testa i tuoi cambiamenti
Dopo aver apportato modifiche:
Salva il tuo modello
Rigenera una nota da una sessione esistente
Confronta i testi generati prima/dopo
Se non è corretto, affina e testa di nuovo
💡 I modelli migliorano con il perfezionamento. Dopo il test, rivedi il testo generato e regola le tue istruzioni secondo necessità.
Risoluzione dei problemi
Correzioni rapide
Problema | Causa probabile | Soluzione |
Il testo del segnaposto appare nel testo generato | Problema di igiene delle parentesi | Verifica che i segnaposti utilizzino |
Heidi inventa informazioni | Istruzione di sicurezza mancante | Aggiungi |
La formattazione non corrisponde alle istruzioni | Istruzioni in conflitto | Verifica la presenza di istruzioni altrove nel modello che contraddicono. Verifica le impostazioni Memory (Vedi: Memory) |
Citazioni indesiderate che appaiono | Voce impostata su "Estremamente dettagliato" | Cambia Voce in "Dettagliato" o aggiungi istruzione: |
Punti elenco che appaiono quando desideri paragrafi | Caratteri di punti elenco nel modello | Rimuovi i caratteri |
Il modello sembra ignorare i cambiamenti | Pagina non aggiornata | Salva il modello, aggiorna la pagina e rigenera. |
Testi generati incompleti o frammentari
Se le tue note escono incomplete o frammentarie:
Verifica la tua impostazione Scriba: Usa la modalità "Avanzata" o "Migliore" per modelli complessi
Verifica l'impostazione Voce: la modalità "Dettagliato" produce un testo generato più strutturato
Semplifica il tuo modello: troppe istruzioni possono causare problemi; rimuovi la complessità non necessaria
Verifica la posizione dell'istruzione: metti le istruzioni critiche all'inizio del tuo modello
Verifica la tua trascrizione: tutte le sezioni sono state effettivamente discusse?
Il modello non segue le istruzioni
Se Heidi sembra ignorare le tue istruzioni di formattazione:
Passaggio 1: verifica i conflitti
Cerca istruzioni contraddittorie altrove nel modello
Verifica se le impostazioni Memory sostituiscono il modello
Verifica le personalizzazioni per le preferenze in conflitto
Passaggio 2: rendi le istruzioni più esplicite
Invece di: (Usa il formato paragrafo)
Prova: (Non usare mai punti elenco, trattini o elenchi numerati. Scrivi in frasi complete utilizzando il formato paragrafo soltanto.)
Le tabelle non vengono visualizzate
⚠️ Heidi non è in grado di produrre tabelle in modo affidabile in questa fase - questa è una limitazione nota che stiamo lavorando per migliorare. Nel frattempo...
Se hai bisogno di dati tabulari:
Converti la struttura della tabella nel tuo modello in formato riga per riga con intestazioni
Genera la tua nota in Heidi
Copia il testo generato nel tuo sistema di gestione della pratica o Word
Riformatta in una tabella lì se necessario
Riepilogo best practice
✅ Sì:
Includi istruzioni di sicurezza su ogni segnaposto
Sii specifico con le descrizioni dei segnaposti
Usa la terminologia coerente in tutto
Testa i cambiamenti con sessioni reali
Inizia in semplicità e aggiungi complessità gradualmente
❌ Evita:
Annidamento di parentesi o miscelazione di tipi di parentesi
Includere esempi all'interno dei segnaposti
Istruzioni contraddittorie in diverse parti del modello
Apportare troppi cambiamenti contemporaneamente (difficili da eseguire il debug)
Cosa c'è dopo?
Hai padroneggiato le tecniche di modello intermedi! Pronto per le funzioni avanzate?
➡️ Padroneggiare i tuoi modelli di Heidi: una guida avanzata - Scopri la logica condizionale (dichiarazioni if-then), i macro clinici, l'integrazione del contesto storico e altro ancora.
⬅️ Creare modelli in Heidi: una guida di base - Rivedi le basi.
Hai bisogno di aiuto?
Se riscontri sfide con i tuoi modelli:
💬 Pulsante Aiuto - Chatta con il nostro team di supporto
🌐 Community dei modelli - Sfoglia i modelli da altri professionisti medici
Siamo qui per aiutarti a creare modelli che funzionano perfettamente per la tua pratica!