# 語音助手

## 語音助手入口

### 門診，急診HIS作業

AI小助手右上方有語音助手按鈕，點選可切換開啟/關閉語音工具 (目前預設使用 ASUS 廠商語音功能)。

<figure><img src="https://1792893123-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdwFoogk3W80yJlNR060h%2Fuploads%2FtDbuRyBwG4nki1CdWvKo%2Fvoice3.jpg?alt=media&#x26;token=1f68f025-01d9-4c29-abd3-b7e9ae2bbfbd" alt=""><figcaption></figcaption></figure>

### 檢查報告，手術報告結構化2.0

可點選側邊欄的子視窗，調出AI小助手，小助手右上方有語音助手按鈕，點選可切換開啟/關閉語音工具。

<figure><img src="https://1792893123-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdwFoogk3W80yJlNR060h%2Fuploads%2FOANHw65a9vTiviC34oqn%2Fvoice2.jpg?alt=media&#x26;token=fc693f21-1093-4f42-afcc-8d0c7b22889e" alt=""><figcaption></figcaption></figure>

表單預設沒隱藏助手按鈕，開啟表單時也可使用表單右上角的語音助手 (目前預設使用 ASUS 廠商語音功能)。

<figure><img src="https://1792893123-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdwFoogk3W80yJlNR060h%2Fuploads%2FUH50qsgvDo0nMTzj5UOa%2Fvoice_set.jpg?alt=media&#x26;token=bf414a75-ba2c-4f48-a5d4-0d617d30162e" alt=""><figcaption></figcaption></figure>

### 住診HIS錄音操作

<figure><img src="https://1792893123-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdwFoogk3W80yJlNR060h%2Fuploads%2FBTUZRsiN6qMzEzAMQsKZ%2Fadmission%20voice%20note.jpg?alt=media&#x26;token=0a81833c-92b6-48dc-a757-c565089508a6" alt=""><figcaption></figcaption></figure>

## 一站式語音轉初診

目前在門診，住診 AI小助手 有開發一站式語音轉初診功能，透過 [語音轉錄函數](https://cgmh-kj.gitbook.io/strucmed/biao-dan-bian-ji/jin-jie-kong-zhi-xiang/han-shu-ju-ji-zhuan-yong/yu-yin-zhuan-lu-han-shu)，可提供指定語音API的語音逐字稿，逐字稿依照初診範本轉標準病歷紀錄。

點選  "語音轉初診" 頁籤，啟動一站式的語音轉結構化文字功能，可錄音後轉錄文字，並生成摘要病歷。

* 點選 "啟動錄音並轉錄逐字稿" ，會啟動 "醫科調教的語音API"，針對國語正確性較高，僅部分支持台語，可自動調整音量，並處理噪音，比較不會發生音量太小轉錄失敗的問題。
* 點選 "啟動錄音並轉錄逐字稿(ASUS)" ，會啟動 "ASUS語音API"，可支持國台客語，但因為試用版，暫無音量以及降噪調整，長時間錄音若音量太小，可能部分轉錄失敗，有待後續調整。

<figure><img src="https://1792893123-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdwFoogk3W80yJlNR060h%2Fuploads%2FyVCZdTp3kkQLCgT4PReg%2Fopdvoice.jpg?alt=media&#x26;token=1875b621-0060-4121-8dd9-dc8bbe502336" alt=""><figcaption></figcaption></figure>

```java
// 初診模板範例

# Major systemic disease:
. (1 diagnosis in 1 line)

# Important past history:
. (patient's personal past history)

# First visit: {TODAY'S DATE yyyy/mm/dd} {CHIEF COMPLAINT, if none, then return 'not mentioned'}
{ASSOCIATED SYMPTOMS}
{ADDITIONAL CONDITIONS MENTIONED IN CONVERSATION}

# {TODAY'S DATE yyyy/mm/dd} {DIAGNOSE AND TREATMENT PLAN AND PATIENT EDUCATION IN 1 SENTENCE according to the content of clinical problem}

# Race: {Taiwan/China/Philippine/Vietnam/Indonesia/other}; Language: {Chinese/Taiwanese/Hakka/English/Vietnamese/Indonesian/other}; Residence: {if specified}
# Allergy history:{if specified} ; # Adverse event: {if specified}
# Alcohol: {denied/specific type of alcohol, daily amount} ; Smoke: {denied/how much pack per day for how long} ; Betel-nut: {denied/how much TWD per day}
# Occupation: {if any}
# Marriage: {if any}
# Family history: {if any}
# Dependence: {nil/walker/wheelchair/bedridden}
```

{% hint style="info" %}
實際操作示範

1. 一般門診初診紀錄 <https://youtu.be/ScPrnvsRZ3w> (本範本由土城長庚醫院孫偉喬醫師 2025/10/01 開發)
2. 記憶門診紀錄 <https://youtu.be/1BI4EtYOU7s> (本範本與神經內科共同開發)
   {% endhint %}

## 錄音操作

開啟錄音控制面板後，每30秒會轉譯一段語音，停止錄音後，完成所有因檔轉錄後，會回川完整譯文，使用者可粘貼到表單的段落輸入框使用。

## 透過巨集啟動

除了透過按鈕啟動，手動餐做錄音，也可以設計巨集按鈕，添加語音轉錄函數，啟動錄音轉文字功能，接續其他函數，完成自動化作業。請參見 [語音轉錄函數](https://cgmh-kj.gitbook.io/strucmed/biao-dan-bian-ji/jin-jie-kong-zhi-xiang/han-shu-ju-ji-zhuan-yong/yu-yin-zhuan-lu-han-shu)。

## 注意事項

1. HIS 同時僅支持一個錄音控制視窗，開啟多個會導致結構化表單鎖住，語音輸入後，請記得關閉控制視窗。
2. 如果電腦設備不支援錄音，或是沒有麥克風設備，會出現錯誤訊息提示

<figure><img src="https://1792893123-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FdwFoogk3W80yJlNR060h%2Fuploads%2F3g4v6gr3wh6jqXbEKNwj%2Fvoice-error.jpg?alt=media&#x26;token=d70aa941-6d09-4330-b750-225f6f5491d1" alt=""><figcaption></figcaption></figure>

{% hint style="warning" %}

1. 音量太小會誤判停止錄音，請留意錄音音量設定。
2. 若同時開啟多個HIS作業，請留意切換開啟關閉面板，僅保留一個語音控制面板，才能正確使用錄音功能。
   {% endhint %}
