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

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

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

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

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


このガイドの内容

主なセクション

このガイドで学べること

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

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

形式と長さの変更

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

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

診察中に情報が出てこなかった場合の対応

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

番号付きリスト、階層付きの箇条書き、混在形式

全体指示

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

トラブルシューティング

よくある問題と対処方法


動画チュートリアル


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

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

方法

適している用途

難易度

テンプレートビルダー

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

初心者にも使いやすい

手動編集

細かな制御、複雑な要件

構文の理解が必要

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

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


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

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

要素

構文

セクション見出し

通常のテキスト

主観的所見:

プレースホルダー

[角括弧]

[主訴]

AIへの指示

(丸括弧)

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

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

"引用符"

"山田医師(一般内科医)"

括弧の使い方のルール

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

推奨されること:

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

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

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

避けること:

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

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

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

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


形式と長さの変更

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

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

実現したいこと

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

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

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

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

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

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

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

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

簡潔な出力

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

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

より詳しい出力

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

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

番号付きリスト

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

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

箇条書き

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

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

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

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

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

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

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

手動編集での解決方法:

  1. 構成タブに移動する

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

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

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

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

変更前

主観的所見:

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

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

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

  • 左腕へ放散する

変更後

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

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

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

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

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

手動編集での解決方法:

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

出力:

既往歴:

2型糖尿病(2018年診断)

高血圧

脂質異常症

両膝変形性関節症

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

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

方法

推奨される対応

テンプレートビルダー

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

手動編集

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

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

方法

推奨される対応

テンプレートビルダー

「治療計画のセクションを、もう少し詳しく充実させて」

手動編集

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

💡 文体の設定も忘れずに:「簡潔」「標準」「詳細」「非常に詳細」の4段階から選べます。 この設定はすべてのテンプレートの出力スタイルを制御するため、各セクションに長さの指示を個別に追加する手間を省けます。

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


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

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

希望する動作

テンプレートビルダー

手動での指示

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

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

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

「言及なし」と記載する

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

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

「聴取なし」と記載する

「社会歴について話されていなければ、『聴取なし』と記載して」

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

「なし」と記載する

「アレルギーがなければ、『なし』と記載して」

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

「既知の薬剤アレルギーなし」と記載する(アレルギー)

「アレルギーについて言及がなければ、『既知の薬剤アレルギーなし』と記載して」

(文字起こし、補足情報、または臨床記録に明示的に記載されている場合のみ含め、それ以外の場合は "既知の薬剤アレルギーなし" と記載する)

「特記事項なし」と記載する

「既往歴について何も話されていなければ、『特記事項なし』と記載して」

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


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

番号付きリスト

テンプレートビルダー:

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

手動編集:

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

出力:

薬剤:

  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"。)

日付形式

「すべての日付を日日/月月/年年年年形式で記載して」

(すべての日付を日日/月月/年年年年形式で記載する。)

メートル法の単位

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

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

通貨

「すべての支払いをAUDで記録して」

(支払いは常にAUDで記録する。)

フォーマルなトーン

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

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

患者にわかりやすい言葉

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

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

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

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

テンプレートビルダー:

チャットに入力:「この紹介状は二人称で書き、紹介先の先生に『先生』と直接呼びかけて」

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

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


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

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

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

曖昧

具体的

[アレルギー]

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

[薬剤]

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

[病歴]

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

強い指示語

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

弱い表現

強い表現

「できれば…を使って」

「必ず…を使って」

「…を優先して」

「決して…しないで」

「…するべき」

「必ず…する」

「…を書いて」

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

変更をテストする

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

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

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

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

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

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


トラブルシューティング

クイック修正

問題

考えられる原因

解決方法

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

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

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

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

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

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

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

指示が矛盾している

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

不要な直接引用が表示される

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  • 表が表示されない

⚠️ 現時点では、Heidiは表を安定して出力できません。これは既知の制限であり、現在改善に取り組んでいます。 それまでは、次の方法をお試しください。

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

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

  2. Heidiで記録原稿を作成する

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

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


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

推奨されること:

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

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

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

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

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

避けること:

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

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

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

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


次に進む

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

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


サポートが必要ですか?

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

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

  • 🌐 テンプレートコミュニティ - 他の臨床家のテンプレートを閲覧できます

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

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