Przejdź do głównej zawartości

Ulepszanie szablonów Heidi: Przewodnik dla średniozaawansowanych

Dalej udoskonalaj szablony, gdy już zaznajomisz się z podstawami.

Witamy ponownie w serii poradników Heidi Health na temat szablonów. Po zapoznaniu się z podstawami tworzenia szablonów czas sięgnąć po bardziej zaawansowane techniki. W tym artykule omówimy bardziej szczegółowo doskonalenie szablonów, aby w pełni wykorzystać możliwości sztucznej inteligencji Heidi do zaspokojenia Twoich konkretnych potrzeb.

⚠️ Nowy w szablonach Heidi? Zacznij od podstaw → Tworzenie szablonów w Heidi: Przewodnik dla początkujących


Co znajduje się w tym przewodniku

Sekcja kluczowa

Co się dowiesz

Dwie metody doskonalenia szablonów

Konstruktor szablonów a edycja ręczna

Zmiana formatowania i długości

Akapity, wypunktowanie, zwięzłe vs. szczegółowe

Obsługa brakujących informacji

Co zrobić, gdy informacja nie jest wymieniona podczas konsultacji

Tworzenie list i formatów specjalnych

Listy numerowane, podpunkty, formaty mieszane

Instrukcje globalne

Ustawienia, które dotyczą całego szablonu

Rozwiązywanie problemów

Typowe problemy i sposoby ich rozwiązania


Poradnik wideo


Dwie metody doskonalenia szablonów

Istnieją dwa podejścia do ulepszania szablonów:

Podejście

Najlepsze dla

Poziom umiejętności

Kreator szablonów

Szybkie zmiany, poprawki formatowania, większość użytkowników

Przyjazny dla początkujących

Edycja ręczna

Precyjna kontrola, złożone wymagania

Wymaga zrozumienia składni

Nasze rekomendacja: zacznij od Konstruktora szablonów. Jeśli nie możesz osiągnąć tego, czego potrzebujesz, przejdź na edycję ręczną.

Ten przewodnik szczegółowo omawia każdą technikę, abyś mógł wybrać to, co sprawdza się najlepiej dla Ciebie.


Szybkie przypomnienie: 4 komponenty szablonu

Zanim przejdziemy dalej, oto szybkie przypomnienie składni:

Komponent

Składnia

Przykład

Nagłówek sekcji

Zwykły tekst

Dane subiektywne:

Symbol zastępczy

[Nawiasy kwadratowe]

[Główna skarga]

Instrukcja AI

(Nawiasy okrągłe)

(Uwzględnij tylko wtedy, gdy jest to wyraźnie wspomniane w transkrypcji, notatkach kontekstowych lub notatce klinicznej, w przeciwnym razie pominąć tę sekcję całkowicie.)

Dosłownie

"Cudzysłów"

"Dr Smith, GP"

Reguły higieny nawiasów

Przestrzeganie tych zasad zapewnia, że Heidi poprawnie interpretuje szablon:

Rób:

  • Umieść symbole zastępcze w nawiasach kwadratowych: [Zawartość do wstawienia]

  • Umieść instrukcje w nawiasach okrągłych: (Jak to sformatować)

  • Umieść instrukcje bezpośrednio po symbolu zastępczym

Unikaj:

  • Zagnieżdżania nawiasów w nawiasach

  • Mieszania typów nawiasów

  • Umieszczania przykładów wewnątrz symboli zastępczych

💡 Aby maksymalnie wykorzystać szablony, komunikuj się z Heidi za pomocą jasnych, konkretnych instrukcji. Im bezpośredniej sformułowanie, tym lepiej Heidi rozumie, czego potrzebujesz.


Zmiana formatowania i długości

Jedna z najczęstszych poprawek to zmiana sposobu formatowania danych wyjściowych przez Heidi.

Szybki przewodnik: Polecenia formatowania

Co chcesz

Konstruktor szablonów (wpisz to)

Edycja ręczna (dodaj tę instrukcję)

Akapity zamiast wypunktowania

"Napisz sekcję subiektywną jako płynny akapit, a nie wypunktowanie"

(Nigdy nie używaj wypunktowania. Napisz pełnymi zdaniami w formacie akapitu.)

Wiersz po wierszu bez wypunktowania

"Napisz każdy element w osobnym wierszu bez wypunktowania"

(Napisz każdy element w osobnym wierszu. Nie używaj wypunktowania ani formatu akapitu.)

Zwięzłe dane wyjściowe

"Uczyń sekcję subiektywną bardziej zwięzłą i zwarta"

(Bądź zwięzły. Używaj zwięzłych stwierdzeń.)

Bardziej szczegółowe dane wyjściowe

"Uczyń sekcję planu bardziej szczegółową"

(Zapewnij kompleksowe szczegóły.)

Lista numerowana

"Przedstaw leki jako listę numerowaną"

(Napisz jako listę numerowaną, każdy element w nowym wierszu.)

Wypunktowanie

"Użyj wypunktowania dla historii chorób"

(Napisz jako listę punktowaną.)

💡 Używaj naturalnego języka dla instrukcji AI: Jasny, codzienny język daje najlepsze wyniki. Proste instrukcje, takie jak "Napisz tę sekcję jako narrację", są bardziej efektywne niż sformułowania techniczne lub niejasne - więc zachowaj naturalność, ale bądź konkretny.

Przykład 1: Konwersja wypunktowania na akapity

Problem: Heidi generuje sekcję subiektywną jako wypunktowanie, ale wolisz płynny tekst narracyjny.

Rozwiązanie Konstruktora szablonów:

Wpisz w czacie: "Napisz sekcję subiektywną jako płynny akapit, a nie wypunktowanie"

Rozwiązanie edycji ręcznej:

  1. Przejdź do karty Struktura

  2. Znajdź sekcję subiektywną

  3. Usuń znaki wypunktowania (- lub •) ze szablonu

  4. Dodaj tę instrukcję po symbolu zastępczym:

[Główna skarga i historia choroby będącej przedmiotem konsultacji] (Uwzględnij tylko wtedy, gdy jest to wyraźnie wspomniane w transkrypcji, notatkach kontekstowych lub notatce klinicznej, w przeciwnym razie pominąć tę sekcję całkowicie. Nigdy nie używaj wypunktowania. Napisz pełnymi zdaniami w formacie akapitu.)

Przed

Dane subiektywne:

  • 45-letni mężczyzna z bólem w klatce piersiowej

  • Ból rozpoczął się 2 dni temu

  • Opisuje jako ostre, ciśnieniowe uczucie

  • Promieniuje do lewej ręki

Po

Subiektywne: Pan Johnson to 45-letni mężczyzna z bólem w klatce piersiowej, który rozpoczął się 2 dni temu. Opisuje ból jako ostre, ciśnieniowe uczucie, które promieniuje do jego lewej ręki.

Przykład 2: Format wiersz po wierszu bez wypunktowania

Problem: Chcesz, aby każda informacja znalazła się w osobnym wierszu, ale bez wypunktowania ani formatu akapitu.

Rozwiązanie Konstruktora szablonów:

Wpisz: "Napisz każdy element w osobnym wierszu bez wypunktowania ani formatu akapitu"

Rozwiązanie edycji ręcznej:

[Historia chorób przeszłych] (Uwzględnij tylko wtedy, gdy jest to wyraźnie wspomniane w transkrypcji, notatkach kontekstowych lub notatce klinicznej, w przeciwnym razie pominąć tę sekcję całkowicie. Napisz każdy warunek w osobnym wierszu. Nie używaj wypunktowania, myślników ani formatu akapitu.)

Dane wyjściowe:

Historia chorób przebytych:

Cukrzyca typu 2 (rozpoznana w 2018 r.)

Nadciśnienie tętnicze

Hiperlipidemii

Artroza obustronna kolan

Przykład 3: Dane wyjściowe zwięzłe vs. szczegółowe

Aby otrzymać bardziej zwięzłą notatkę:

Metoda

Co zrobić

Kreator szablonów

"Uczyń całą notatkę bardziej zwięzłą i zwartą"

Edycja ręczna

Dodaj na koniec szablonu: (Bądź zwięzły wszędzie. Używaj zwięzłych stwierdzeń bez niepotrzebnego rozwinięcia.)

Aby otrzymać bardziej szczegółową notatkę:

Metoda

Co zrobić

Kreator szablonów

"Uczyń sekcję planu bardziej kompleksową i szczegółową"

Edycja ręczna

Dodaj do konkretnej sekcji: (Zapewnij kompleksowe szczegóły, w tym uzasadnienie decyzji.)

💡 Nie zapomnij ustawienia Voice: Zwięzły, Zrównoważony, Szczegółowy, Bardzo szczegółowy. To steruje stylem danych wyjściowych we wszystkich szablonach, co może zaoszczędzić ci dodawania instrukcji dotyczących długości do każdej sekcji indywidualnie.

Warto zauważyć: "Bardzo szczegółowy" jest przeznaczony do uwzględniania bezpośrednich cytatów - więc jeśli to nie to, czego szukasz, przełącz się na Szczegółowy. Uzyskasz dokładnie ten sam poziom szczegółowości, po prostu bez cytatów.


Obsługa brakujących informacji

Co powinna zrobić Heidi, gdy informacja nie jest wymieniona podczas konsultacji? Masz kilka opcji.

Pożądane zachowanie

Kreator szablonów

Instrukcja ręczna

Pominąć sekcję całkowicie (instrukcja standardowa)

"Jeśli alergie nie są wymienione, pomiń tę sekcję całkowicie"

(Uwzględnij tylko wtedy, gdy jest to wyraźnie wspomniane w transkrypcji, notatkach kontekstowych lub notatce klinicznej, w przeciwnym razie pominąć tę sekcję całkowicie.)

Wypisz "Nie wymienione"

"Jeśli alergie nie są omawiane, napisz 'Nie wymienione'"

(Uwzględnij tylko wtedy, gdy jest to wyraźnie wspomniane w transkrypcji, notatkach kontekstowych lub notatce klinicznej, w przeciwnym razie wypisz "Nie wymienione")

Wypisz "Nie omawiane"

"Jeśli historia społeczna nie jest omawiana, napisz 'Nie omawiane'"

(Uwzględnij tylko wtedy, gdy jest to wyraźnie wspomniane w transkrypcji, notatkach kontekstowych lub notatce klinicznej, w przeciwnym razie wypisz "Nie omawiane")

Wypisz "Nic"

"Jeśli nie ma alergii, napisz 'Nic'"

(Uwzględnij tylko wtedy, gdy jest to wyraźnie wspomniane w transkrypcji, notatkach kontekstowych lub notatce klinicznej, w przeciwnym razie wypisz "Nic")

Wypisz "NKDA" (alergie)

"Jeśli alergie nie są wymienione, domyślnie ustaw 'NKDA'"

(Uwzględnij tylko wtedy, gdy jest to wyraźnie wspomniane w transkrypcji, notatkach kontekstowych lub notatce klinicznej, w przeciwnym razie wypisz "NKDA")

Wypisz "Bez istotnych przypadków"

"Jeśli nic nie jest omawiane dla historii przeszłej, napisz 'Bez istotnych przypadków'"

(Uwzględnij tylko wtedy, gdy jest to wyraźnie wspomniane w transkrypcji, notatkach kontekstowych lub notatce klinicznej, w przeciwnym razie wypisz "Bez istotnych przypadków")


Tworzenie list i formatów specjalnych

Listy numerowane

Konstruktor szablonów:

Wpisz w czacie: "Uczyń leki listą numerowaną, każdy w nowym wierszu"

Edycja ręczna:

[Bieżące leki z dawkami i częstotliwością] (Uwzględnij tylko wtedy, gdy jest to wyraźnie wspomniane w transkrypcji, notatkach kontekstowych lub notatce klinicznej, w przeciwnym razie pominąć tę sekcję całkowicie. Napisz jako listę numerowaną, każdy lek w nowym wierszu.)

Dane wyjściowe:

Leki:

  1. Metformina 1000 mg dwa razy dziennie

  2. Lisinopril 10 mg raz dziennie

  3. Atorwastyna 20 mg na noc

Listy numerowane z podpunktami

Konstruktor szablonów:

Wpisz w czacie: "Uczyń plan zarządzania listą numerowaną z podpunktami dla szczegółów pod każdą pozycją"

Edycja ręczna:

[Plan zarządzania] (Uwzględnij tylko wtedy, gdy jest to wyraźnie wspomniane w transkrypcji, notatkach kontekstowych lub notatce klinicznej, w przeciwnym razie pominąć tę sekcję całkowicie. Napisz jako listę numerowaną, każdy główny element jako numer. Jeśli element ma podpunkty, napisz je jako wypunktowanie wcięte pod tym numerem.)

Dane wyjściowe:

Plan:

1. Modyfikacje stylu życia

  • Zmniejsz spożycie sodu

  • Zwiększ aktywność fizyczną do 30 minut dziennie

  • Cel utraty wagi 5 kg w ciągu 3 miesięcy

2. Zmiana leków

  • Zwiększ lisinopril do 20 mg dziennie

  • Kontynuuj metforminę bez zmian

3. Kontrola

  • Przegląd za 4 tygodnie

  • Powtórz badania krwi przed wizytą

Format mieszany z nagłówkami i wypunktowaniem

Konstruktor szablonów:

Wpisz w czacie: "Napisz badanie fizykalne z pogrubionymi nagłówkami systemu, a następnie wyniki jako wypunktowanie poniżej"

Edycja ręczna:

[Wyniki badania fizykalnego] (Uwzględnij tylko wtedy, gdy jest to wyraźnie wspomniane w transkrypcji, notatkach kontekstowych lub notatce klinicznej, w przeciwnym razie pominąć tę sekcję całkowicie. Napisz z pogrubionymi nagłówkami systemu, a następnie odpowiednie wyniki jako punkty poniżej każdego systemu.)

Dane wyjściowe:

Badanie:

Układ sercowo-naczyniowy:

  • Częstotliwość serca 78 uderzeń/min, regularny

  • Ciśnienie krwi 145/92 mmHg

  • Serca bije głośno, bez szumów

Oddechowy:

  • Klatka piersiowa czysta dwustronnie

  • Bez świszczenia lub trzasków

  • Częstotliwość oddechów 16


Instrukcje globalne

Instrukcje globalne dotyczą całego szablonu, a nie określonej sekcji. Umieść je na samym początku lub samym końcu szablonu.

Typowe instrukcje globalne

Cel

Kreator szablonów

Instrukcja ręczna (na koniec szablonu)

Użyj imienia pacjenta

"Zawsze odnoś się do pacjenta po imieniu"

(Zawsze odnoś się do pacjenta po imieniu, jeśli jest znane. Użyj 'pacjenta' tylko wtedy, gdy imię nie jest dostępne.)

Perspektywa pierwszej osoby

"Napisz notatkę z mojej perspektywy, używając 'ja'"

(Napisz tę notatkę w pierwszej osobie z perspektywy lekarza, używając "ja" wszędzie.)

Angielski brytyjski/australijski

"Używaj australijskiego angielskiego wszędzie"

(Używaj angielskiego brytyjskiego/australijskiego wszędzie, np. "colour" nie "color", "organisation" nie "organization".)

Format daty

"Używaj formatu DD/MM/RRRR dla wszystkich dat"

(Używaj formatu DD/MM/RRRR dla wszystkich dat.)

Jednostki metryczne

"Używaj jednostek metrycznych wszędzie"

(Używaj jednostek metrycznych wszędzie. Konwertuj wszelkie pomiary imperialne na metryczne.)

Waluta

"Rejestruj wszystkie płatności w AUD"

(Zawsze rejestruj płatności w AUD.)

Ton formalny

"Używaj formalnej terminologii medycznej wszędzie"

(Używaj formalnej terminologii medycznej wszędzie. Unikaj potoczności.)

Język przyjazny pacjentowi

"Używaj prostego języka, który pacjent może zrozumieć"

(Napisz jasnym, prostym językiem odpowiednim dla zrozumienia pacjenta. Unikaj żargonu medycznego, jeśli to możliwe.)

Przykład: Instrukcja globalna dla pism polecających

W przypadku pism polecających możesz chcieć określonego tonu:

Konstruktor szablonów:

Wpisz w czacie: "Napisz to pismo w drugiej osobie, zwracając się bezpośrednio do specjalisty jako 'ty'"

Edycja ręczna (wstaw na koniec szablonu):

(Napisz to pismo w drugiej osobie, zwracając się bezpośrednio do lekarza odbierającego jako 'ty' wszędzie. Nigdy nie odnoś się do niego w trzeciej osobie jako 'specjalista' lub 'lekarz'. Zachowaj profesjonalny, kolegialny ton.)


Profesjonalne porady dla efektywnych szablonów

Bądź konkretny ze symbolami zastępczymi

Zamiast niejasnych symboli zastępczych, bądź jawny na temat tego, co należy uwzględnić:

Niejasny

Konkretny

[Alergie]

[Alergie, w tym alergen, typ reakcji, nasilenie i data ostatniej reakcji, jeśli jest znana]

[Leki]

[Bieżące leki, w tym nazwę leku, dawkę, częstotliwość i drogę podania]

[Historia]

[Historia choroby będącej przedmiotem konsultacji, w tym początek, czas trwania, nasilenie, czynniki zaostrzające i łagodzące]

Słowa instrukcji mocne

Dla instrukcji, które muszą być dokładnie przestrzegane:

Słabszy

Silniejszy

"Spróbuj używać..."

"Zawsze używaj..."

"Wolisz..."

"Nigdy nie używaj..."

"Powinieneś..."

"Musisz..."

"Napisz..."

"Wypisz..." (dla dokładnego tekstu stałego)

Przetestuj swoje zmiany

Po dokonaniu zmian:

  1. Zapisz szablon

  2. Wygeneruj ponownie notatkę z istniejącej sesji

  3. Porównaj dane wyjściowe przed/po

  4. Jeśli to nie jest dobre, dopracuj i testuj ponownie

💡 Szablony ulepsza się poprzez dopracowanie. Po przetestowaniu przejrzyj dane wyjściowe i dostosuj instrukcje w razie potrzeby.


Rozwiązywanie problemów

Szybkie naprawy

Problem

Prawdopodobna przyczyna

Rozwiązanie

Tekst symbolu zastępczego pojawia się w danych wyjściowych

Problem z higieną nawiasów

Sprawdź, czy symbole zastępcze używają [nawiasów kwadratowych], a instrukcje używają (nawiasów okrągłych). Nie zagnieżdżaj ani nie mieszaj nawiasów.

Heidi wymyślająca informacje

Brakująca instrukcja bezpieczeństwa

Dodaj (Uwzględnij tylko wtedy, gdy jest to wyraźnie wspomniane w transkrypcji, notatkach kontekstowych lub notatce klinicznej, w przeciwnym razie pominąć tę sekcję całkowicie.) do każdego symbolu zastępczego.

Formatowanie niezgodne z instrukcjami

Sprzeczne instrukcje

Sprawdź, czy gdzie indziej w szablonie znajdują się instrukcje, które się sprzeczają. Sprawdź ustawienia Pamięć (patrz: Pamięć)

Niechciane cytaty się pojawiają

Voice ustawiony na "Bardzo szczegółowy"

Zmień Voice na "Szczegółowy" lub dodaj instrukcję: (Nigdy nie umieszczaj bezpośrednich cytatów. Zawsze parafrazuj.)

Wypunktowanie pojawia się, gdy chcesz akapitów

Znaki wypunktowania w szablonie

Usuń znaki - lub z widoku Struktura. Dodaj wyraźną instrukcję, aby nie używać wypunktowania.

Szablon wydaje się ignorować zmiany

Strona nie odświeżona

Zapisz szablon, odśwież stronę i wygeneruj ponownie.

  • Niekompletne lub fragmentaryczne dane wyjściowe

Jeśli notatki są niekompletne lub fragmentaryczne:

  1. Sprawdź ustawienie Scribe: Użyj trybu "Zaawansowany" lub "Najlepszy" dla złożonych szablonów

  2. Sprawdź ustawienie Voice: Tryb "Szczegółowy" generuje bardziej strukturalne dane wyjściowe

  3. Uprość szablon: Zbyt wiele instrukcji może powodować problemy; usuń niepotrzebną złożoność

  4. Sprawdź umieszczenie instrukcji: Umieść krytyczne instrukcje na początku szablonu

  5. Sprawdź transkrypcję: Czy wszystkie sekcje były faktycznie omawiane?

  • Szablon nie przestrzega instrukcji

Jeśli Heidi wydaje się ignorować instrukcje formatowania:

Krok 1: Sprawdź konflikty

  • Poszukaj sprzecznych instrukcji gdzie indziej w szablonie

  • Sprawdź, czy ustawienia Pamięć przesłaniają szablon

  • Sprawdź Personalizacje dla sprzecznych preferencji

Krok 2: Uczyń instrukcje bardziej wyraźnymi

Zamiast: (Użyj formatu akapitu)

Spróbuj: (Nigdy nie używaj wypunktowania, myślników ani list numerowanych. Napisz pełnymi zdaniami, używając tylko formatu akapitu.)

  • Tabele się nie renderują

⚠️ Heidi nie potrafi niezawodnie tworzyć tabel na tym etapie - to znane ograniczenie, nad którym pracujemy. W międzyczasie...

Jeśli potrzebujesz danych tabelarycznych:

  1. Konwertuj strukturę tabeli w szablonie do formatu wiersz po wierszu z nagłówkami

  2. Wygeneruj notatkę w Heidi

  3. Skopiuj dane wyjściowe do systemu zarządzania przychodnia lub Word

  4. W razie potrzeby przeformatuj w formę tabeli


Podsumowanie najlepszych praktyk

Rób:

  • Uwzględnij instrukcje bezpieczeństwa na każdym symbolu zastępczym

  • Bądź konkretny w opisach symboli zastępczych

  • Używaj spójnej terminologii wszędzie

  • Przetestuj zmiany w rzeczywistych sesjach

  • Zacznij prosto i stopniowo dodawaj złożoność

Unikaj:

  • Zagnieżdżanie nawiasów lub mieszanie typów nawiasów

  • Umieszczanie przykładów wewnątrz symboli zastępczych

  • Sprzeczne instrukcje w różnych częściach szablonu

  • Wprowadzanie zbyt wielu zmian naraz (trudne do debugowania)


Co dalej?

Opanowałeś pośrednie techniki szablonów! Gotowy na zaawansowane funkcje?

➡️ Opanowanie szablonów Heidi: Zaawansowany przewodnik - Poznaj logikę warunkową (instrukcje jeśli-to), kliniczne makra, integrację kontekstu historycznego i inne.


Potrzebujesz pomocy?

Jeśli napotkasz problemy ze swoimi szablonami:

  • 💬 Przycisk Pomoc - Porozmawiaj z naszym zespołem wsparcia

  • 🌐 Społeczność szablonów - Przeglądaj szablony od innych lekarzy

Jesteśmy tutaj, aby pomóc ci stworzyć szablony, które doskonale działają dla twojej przychodni!

Czy to odpowiedziało na twoje pytanie?