メインコンテンツにスキップ

Heidiテンプレート改善:中級ガイド

基本に慣れたら、テンプレートをさらに調整しましょう。

Heidi Healthのテンプレートチュートリアルシリーズへようこそ。 テンプレート作成の基本に慣れてきたら、次はより高度なテクニックを見ていきましょう。 この記事では、テンプレートをさらに調整し、HeidiのAIを活用して、ご自身のニーズにより合う内容にする方法を詳しく説明します。

⚠️ Heidiのテンプレートを初めて使いますか? まずは基本から確認しましょう → Heidiでテンプレートを作成する:基本ガイド


このガイドの内容

主なセクション

学べること

テンプレートを調整する2つの方法

テンプレートビルダーと手動編集

形式と長さの変更

段落、箇条書き、簡潔な記載と詳しい記載

情報が不足している場合の対応

診察中に情報が言及されなかった場合の対応

リストと特殊な形式の作成

番号付きリスト、入れ子の箇条書き、混在形式

全体指示

テンプレート全体に適用される設定

トラブルシューティング

よくある問題と対処方法


動画チュートリアル


テンプレートを調整する2つの方法

テンプレートを改善するには、2つの方法があります。

方法

適している用途

難易度

テンプレートビルダー

簡単な変更、形式の微調整、ほとんどのユーザー

初心者にも使いやすい

手動編集

細かな制御、複雑な要件

構文の理解が必要

おすすめ:まずはテンプレートビルダーから始めましょう。 目的の内容をうまく反映できない場合は、手動で編集します。

このガイドでは各テクニックを詳しく説明するので、ご自身に合った方法を選べます。


簡単なおさらい:テンプレートを構成する4つの要素

本題に入る前に、構文を簡単におさらいしましょう。

要素

構文

セクション見出し

通常のテキスト

主観的情報:

プレースホルダー

[角括弧]

[主訴]

AIへの指示

(丸括弧)

(会話記録、背景情報メモ、または臨床記録に明示的に記載されている場合のみ含め、それ以外の場合はセクション全体を省略する。)

そのまま出力するテキスト

"引用符"

"山田医師"

括弧の使い方のルール

次のルールに従うことで、Heidiがテンプレートを正しく解釈しやすくなります。

おすすめ:

  • プレースホルダーは角括弧で囲む:[挿入する内容]

  • 指示は丸括弧で囲む:(形式の指定)

  • 指示は、対象のプレースホルダーの直後に置く

避けたいこと:

  • 括弧の中にさらに括弧を入れる

  • 括弧の種類を混在させる

  • プレースホルダー内に例を含める

💡 テンプレートを最大限活用するには、Heidiに対して明確かつ具体的に指示します。 指示が直接的であるほど、Heidiは必要な内容を理解しやすくなります。


形式と長さの変更

よく行われる調整のひとつが、Heidiによる出力形式の変更です。

形式指定コマンドの早見表

実現したいこと

テンプレートビルダー(入力する内容)

手動編集(追加する指示)

箇条書きではなく段落にする

「主観的所見セクションを箇条書きではなく、自然な段落で書いて」

(箇条書きは使用しない。 完全な文と段落形式で書く。)

箇条書きなしで1項目ずつ改行する

「各項目を箇条書きにせず、1行ずつ書いて」

(各項目を1行ずつ書く。 箇条書き形式や段落形式は使用しない。)

簡潔な出力

「主観的所見セクションをもっと簡潔にして」

(簡潔に書く。 短い記述を使用する。)

より詳しい出力

「治療計画セクションをもっと詳しくして」

(包括的な詳細を含める。)

番号付きリスト

「薬剤を番号付きリストで示して」

(各項目を新しい行に分け、番号付きリストとして書く。)

箇条書き

「既往歴には箇条書きを使用して」

(箇条書きとして書く。)

💡 AIへの指示には自然な言葉を使いましょう:明確で日常的な言葉ほど、良い結果につながります。 「このセクションを箇条書きではなく文章形式で書いて」のようなシンプルな指示は、専門的すぎる表現や曖昧な表現より効果的です。自然に、かつ具体的に書きましょう。

例1:箇条書きを段落に変換する

課題: Heidiが主観的所見セクションを箇条書きで出力しているが、自然な文章形式にしたい。

テンプレートビルダーでの解決方法:

チャットに入力:「主観的所見セクションを箇条書きではなく、自然な段落で書いて」

手動編集での解決方法:

  1. 構成タブに移動する

  2. 主観的所見セクションを見つける

  3. テンプレートから箇条書きの記号(- または •)を削除する

  4. プレースホルダーの後に次の指示を追加する:

[主訴および現病歴] (会話記録、補足情報、または臨床記録に明示的に記載されている場合のみ含め、それ以外の場合はセクション全体を省略する。 箇条書きは使用しない。 完全な文を使い、段落形式で書く。)

変更前

Subjective:

  • 45歳男性、胸痛を主訴に受診

  • 痛みは2日前に始まった

  • 締め付けられるような圧迫感と表現

  • 左腕へ放散する

変更後

Subjective:Johnson氏は45歳男性で、2日前から始まった胸痛を主訴に受診しています。 痛みは締め付けられるような圧迫感で、左腕へ放散すると述べています。

例2:箇条書きなしで1行ずつ書く

課題: 各情報を1行ずつ表示したいが、箇条書きや段落形式にはしたくない。

テンプレートビルダーでの解決方法:

入力:「各項目を箇条書きや段落形式にせず、1行ずつ書いて」

手動編集での解決方法:

[既往歴] (会話記録、補足情報、または臨床記録に明示的に記載されている場合のみ含め、それ以外の場合はセクション全体を省略する。 各疾患を1行ずつ書く。 箇条書き、ダッシュ、段落形式は使用しない。)

出力:

既往歴:

2型糖尿病(2018年診断)

高血圧

脂質異常症

両膝変形性関節症

例3:簡潔な出力と詳しい出力

より簡潔な記録にする場合:

方法

行うこと

テンプレートビルダー

「記録全体をもっと簡潔にして」

手動編集

テンプレートの末尾に追加:(全体を通して簡潔に書く。 不要な詳述は避け、短い記述を使用する。)

より詳しい記録にする場合:

方法

行うこと

テンプレートビルダー

「治療計画セクションをより包括的かつ詳しくして」

手動編集

特定のセクションに追加:(判断の根拠を含め、包括的な詳細を記載する。)

💡 Voice設定も忘れずに:Brief、Goldilocks、Detailed、Super Detailed。 この設定はすべてのテンプレートの出力スタイルを制御するため、各セクションに長さの指示を個別に追加する手間を省けます。

補足:「非常に詳細」は直接引用を含めるよう設計されています。直接引用が不要な場合は、「詳細」に切り替えてください。 そうすると、同じ詳細度で、引用なしの出力になります。


情報が不足している場合の扱い

診察中に情報が言及されなかった場合、Heidiにはどう処理させるべきでしょうか。 いくつかの選択肢があります。

希望する動作

テンプレートビルダー

手動での指示

セクション全体を省略する(標準的な指示)

「アレルギーについて言及がなければ、そのセクションは完全に省略して」

(会話記録、補足情報、または臨床記録に明示的に記載されている場合のみ含め、それ以外の場合はセクション全体を省略する。)

“言及なし“と記載する

「アレルギーについて話されていなければ、"言及なし"と記載して」

(会話記録、文脈メモ、または臨床記録に明示的に記載されている場合のみ含め、それ以外の場合は "言及なし" と記載する)

「Not discussed」と出力する

「社会歴について扱われていなければ、 "言及なし"と記載して」

(会話記録、補足情報、または臨床記録に明示的に記載されている場合のみ含め、それ以外の場合は"言及なし"と記載する)

"なし"と出力する

「アレルギーがなければ、"なし"と書いて」

(会話記録、補足情報、または臨床記録に明示的に記載されている場合のみ含め、それ以外の場合は "なし" と記載する)

「NKDA」と出力する(アレルギー)

「アレルギーについて言及がなければ、既定で『NKDA』にして」

(会話記録、文脈メモ、または臨床記録に明示的に記載されている場合のみ含め、それ以外の場合は "NKDA" と出力する)

「Nil of note」と出力する

「既往歴について何も話されていなければ、『Nil of note』と書いて」

(会話記録、文脈メモ、または臨床記録に明示的に記載されている場合のみ含め、それ以外の場合は "Nil of note" と出力する)


リストと特殊な形式の作成

番号付きリスト

テンプレートビルダー:

チャットに入力:「薬剤を、各項目を新しい行にした番号付きリストにして」

手動編集:

[現在の薬剤、用量、頻度] (会話記録、文脈メモ、または臨床記録に明示的に記載されている場合のみ含め、それ以外の場合はセクション全体を省略する。 各薬剤を新しい行に分け、番号付きリストとして書く。)

出力:

薬剤:

  1. メトホルミン1000mg 1日2回

  2. リシノプリル10mg 1日1回

  3. アトルバスタチン20mg 夜間

階層付きの箇条書きを含む番号付きリスト

テンプレートビルダー:

チャットに入力:「管理計画を番号付きリストにし、各項目の詳細は階層付きの箇条書きで書いて」

手動編集:

[管理計画] (会話記録、文脈メモ、または臨床記録に明示的に記載されている場合のみ含め、それ以外の場合はセクション全体を省略する。 主要項目を番号付きリストとして書く。 項目の中にさらに副項目がある場合は、その番号の下にインデントした箇条書きとして書く。)

出力:

計画:

1. 生活習慣の改善

  • 食塩摂取量を減らす

  • 身体活動を1日30分に増やす

  • 3か月で5kgの減量を目標とする

2. 薬剤の調整

  • リシノプリルを20mg 1日1回に増量

  • メトホルミンは変更なく継続

3. フォローアップ

  • 4週間後に再評価

  • 予約前に血液検査を再実施

見出しと箇条書きを組み合わせた形式

テンプレートビルダー:

チャットに入力:「身体診察所見を、太字の系統別見出しの下に所見を箇条書きで書いて」

手動編集:

[身体診察所見] (会話記録、文脈メモ、または臨床記録に明示的に記載されている場合のみ含め、それ以外の場合はセクション全体を省略する。 太字の系統別見出しを使用し、その下に関連する所見を箇条書きで書く。)

出力:

診察所見:

循環器:

  • 心拍数78 bpm、整

  • 血圧145/92 mmHg

  • 心音はI音・II音聴取、雑音なし

呼吸器:

  • 両側胸部清明

  • 喘鳴・捻髪音なし

  • 呼吸数16回/分


全体指示

全体指示は、特定のセクションではなくテンプレート全体に適用されます。 テンプレートの一番最初または一番最後に配置します。

よく使う全体指示

目的

テンプレートビルダー

手動での指示(テンプレート末尾)

患者名を使う

「患者は常にさん付けで言及して」

(可能な場合は常に患者の実際の名前で言及する。 名前がない場合のみ「患者」を使用する。)

一人称視点

「私の視点で、"私"を使って記録を書いて」

(この記録は臨床家の視点から一人称で書き、全体を通して "私" を使用する。)

英国/オーストラリア式の綴り

「全体を通してオーストラリア英語の綴りを使って」

(全体を通して英国/オーストラリア英語の綴りを使用する。例:"color" ではなく "colour"、"organization" ではなく "organisation"。)

日付形式

「すべての日付にDD/MM/YYYY形式を使用して」

(すべての日付にDD/MM/YYYY形式を使用する。)

メートル法の単位

「全体を通してメートル法の単位を使って」

(全体を通してメートル法の単位を使用する。 ヤード・ポンド法の測定値はメートル法に換算する。)

通貨

「すべての支払いを日本円で記録して」

(支払いは常に日本円で記録する。)

フォーマルなトーン

「全体を通して正式な医学用語を使って」

(全体を通して正式な医学用語を使用する。 口語表現を避ける。)

患者にわかりやすい言葉

「患者が理解できる簡単な言葉を使って」

(患者が理解しやすい、明確で簡単な言葉で書く。 可能な限り医学用語を避ける。)

例:紹介状のための全体指示

紹介状では、特定のトーンにしたい場合があります。

テンプレートビルダー:

チャットに入力:「この手紙は二人称で書き、専門医に直接『苗字+先生』で呼びかけて」

手動編集(テンプレートの末尾に挿入):

(この手紙は二人称で書き、受け取る臨床家に対して全体を通して '苗字+先生' と直接呼びかける。 その相手を '専門医' や '医師' のように三人称で呼ばない。 専門職として礼節ある、協働的なトーンを維持する。)


効果的なテンプレート作成のコツ

プレースホルダーは具体的にする

曖昧なプレースホルダーではなく、含める内容を具体的に書きます。

曖昧

具体的

[アレルギー]

[アレルギー(アレルゲン、反応の種類、重症度、最終反応日がわかる場合はその日付を含む)]

[薬剤]

[現在の薬剤(薬剤名、用量、頻度、投与経路を含む)]

[病歴]

[現病歴(発症時期、持続期間、重症度、増悪因子、軽快因子を含む)]

強い指示語

厳密に従う必要がある指示には、次のような表現を使います。

弱い表現

強い表現

「できれば使用して…」

「必ず使用して…」

「優先して…」

「決して使用しないで…」

「…するべき」

「必ず…する」

「書いて…」

「出力して…」(固定テキストを正確に出す場合)

変更をテストする

編集後は、次の手順を行います。

  1. テンプレートを保存する

  2. 既存の診察から記録を再生成する

  3. 変更前後の出力を比較する

  4. 期待どおりでない場合は、調整して再度テストする

💡 テンプレートは調整を重ねることで改善します。 テスト後は出力を確認し、必要に応じて指示を調整します。


トラブルシューティング

クイック修正

問題

考えられる原因

解決方法

プレースホルダーのテキストが出力に表示される

括弧の使い方に問題がある

プレースホルダーには[角括弧]を、指示には(丸括弧)を使用しているか確認します。 括弧の入れ子や混在は避けてください。

Heidiが情報を作り出してしまう

安全性のための指示が不足している

各プレースホルダーに(会話記録、補足情報、または臨床記録に明示的に記載されている場合のみ含め、それ以外の場合はセクション全体を省略する。)を追加します。

形式が指示どおりにならない

指示が矛盾している

テンプレート内の別の場所に矛盾する指示がないか確認します。 「カスタムルール」設定を確認します(参照:カスタムルール

不要な引用が表示される

文体が「非常に詳細」に設定されている

文体を「詳細」に変更するか、次の指示を追加します:(直接引用は決して含めない。 常に言い換えて記載する。)

段落にしたいのに箇条書きになる

テンプレートに箇条書き記号が含まれている

構成ビューから-の文字を削除します。 箇条書きを使用しないという明示的な指示を追加します。

テンプレートの変更が反映されないように見える

ページが更新されていない

テンプレートを保存し、ページを更新してから再生成します。

  • 不完全または断片的な出力

記録が不完全または断片的に出力される場合:

  1. 記録自動作成の設定を確認する:複雑なテンプレートでは「Advanced」または「Best」モードを使用します

  2. 「文体」の設定を確認する:「詳細」モードでは、より構造化された出力になります

  3. テンプレートを簡略化する:指示が多すぎると問題が起きる場合があります。不要な複雑さを取り除きます

  4. 指示の配置を確認する:重要な指示はテンプレートの上部に置きます

  5. 文字起こしを確認する:すべてのセクションは実際に話されていた内容ですか?

  • テンプレートが指示に従わない

Heidiが形式指定の指示を無視しているように見える場合:

ステップ1:矛盾を確認する

  • テンプレート内の別の場所に矛盾する指示がないか確認します

  • 「カスタムルール」設定がテンプレートを上書きしていないか確認します

  • 「パーソナライズ」に矛盾する設定がないか確認します

ステップ2:指示をより明確にする

例:(段落形式を使用する)の代わりに

次を試してください:(箇条書き、ダッシュ、番号付きリストは決して使用しない。 完全な文を使い、段落形式のみで書く。)

  • 表が表示されない

⚠️ 現時点では、Heidiは表を安定して作成することができません。現在改善に向けて取り組んでいます。 改善されるまでは以下をお試しください。

表形式のデータが必要な場合:

  1. テンプレート内の表構造を、見出し付きの1行ずつの形式に変換する

  2. Heidiで記録を生成する

  3. 出力を診療管理システムまたはWordにコピーする

  4. 必要に応じて、そこで表に整える


ベストプラクティスのまとめ

おすすめ:

  • 各プレースホルダーに安全性のための指示を含める

  • プレースホルダーの説明を具体的にする

  • 全体を通して用語を統一する

  • 実際の診察で変更をテストする

  • シンプルに始めて、段階的に複雑さを追加する

避けたいこと:

  • 括弧を入れ子にする、または括弧の種類を混在させる

  • プレースホルダー内に例を含める

  • テンプレートの別々の箇所で矛盾する指示を書く

  • 一度に多くの変更を加えすぎる(問題の切り分けが難しくなるため)


次のステップ

中級レベルのテンプレートテクニックを習得しました。 高度な機能に進む準備はできましたか?

➡️ Heidiテンプレートを使いこなす:上級ガイド - 条件分岐(if-then文)、臨床マクロ、過去の文脈の統合などについて学びます。


サポートが必要ですか?

テンプレートで困ったことがある場合:

  • 💬 ヘルプボタン - サポートチームまでご連絡ください

  • 🌐 テンプレート掲示板 - 他の臨床家のテンプレートを閲覧できます

ご自身の診療にぴったり合うテンプレートを作成できるよう、私たちがお手伝いします。

こちらの回答で解決しましたか?