> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/work/meeting-records/summary.md).

# AI 會議摘要與問答

AI 會議摘要與問答：用預設範本或自訂 Agent 產生摘要、摘要版本管理、複製與朗讀、針對會議內容提問，以及串接 Agent 自動開單。

會議摘要會在背景處理，因此長時間會議也不必一直停留在摘要頁等待。產生期間可以離開頁面，稍後回來查看進度；完成後，摘要會直接成為一個新版本。

## 使用情境 <a href="#summary-scenario" id="summary-scenario"></a>

專案經理剛結束一場長時間的季度會議，想在下班前整理決議。她進入該場會議的 <mark style="color:blue;">會議摘要</mark> 分頁，使用預設範本開始產生摘要；看到系統正在分析逐字稿後，她先離開頁面處理其他工作。稍後回到同一場會議時，畫面會接續顯示進度；處理完成後，她便能從新建立的摘要版本檢查決議與待辦事項。

## 自訂摘要 Agent <a href="#custom-summary-agent" id="custom-summary-agent"></a>

會議記錄的摘要功能讓你選擇自訂的 Agent 來產生摘要。不同的 Agent 可以有不同的角色指令，產出不同風格的摘要：

* **通用摘要 Agent**：整理會議重點、決議、待辦事項
* **技術會議 Agent**：著重技術決策、架構討論、技術債項目
* **業務會議 Agent**：著重客戶需求、銷售進度、商機追蹤

## 產生摘要 <a href="#auto-generate-summary" id="auto-generate-summary"></a>

1. 進入會議詳情頁面
2. 切換到 <mark style="color:blue;">會議摘要</mark> 分頁
3. 點擊 <mark style="color:blue;">生成摘要</mark>，在彈出的視窗設定這次要怎麼摘要（都可以留預設）
4. 點擊 <mark style="color:blue;">開始生成</mark>

### 「生成摘要」視窗的欄位 <a href="#generate-summary-options" id="generate-summary-options"></a>

| 欄位                                        | 說明                                                                                                                                                                                                               |
| ----------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">逐字稿來源</mark>    | 用這場會議自己的逐字稿；有備援逐字稿時可改選備援版本，兩者時間軸不同，見 [會議記錄備援音檔](/work/meeting-records/backup-audio.md)                                                                                                                           |
| <mark style="color:blue;">摘要 Agent</mark> | 留空用預設範本；要自訂風格就選一個 Agent（見下方[自訂摘要 Agent](#custom-summary-agent)）。選了 Agent 後，下面兩欄會改為沿用該 Agent 自身的模型與提示詞                                                                                                            |
| <mark style="color:blue;">語言模型</mark>     | 預設範本要用哪個模型產生摘要；留空為預設模型。清單載入失敗時會顯示「語言模型清單載入失敗，將以預設模型生成」                                                                                                                                                           |
| <mark style="color:blue;">摘要指示</mark>     | 選填。給預設範本的額外要求，例如聚焦某個主題或指定輸出格式。下方有三個範例可一鍵帶入：<mark style="color:blue;">會議紀錄</mark>（條列重點、討論與決議，標註負責人與期限）、<mark style="color:blue;">行動項目</mark>（只列待辦，含負責人、期限與資源）、<mark style="color:blue;">主管摘要</mark>（300 字以內的執行摘要） |

AI 會根據完整的逐字稿內容，整理出會議的重點、決議和待辦事項。使用預設範本時，畫面會依序顯示 <mark style="color:blue;">分析逐字稿 N/M</mark> 與彙整摘要的處理狀態，其中 N 代表已完成的分段數，M 代表總分段數。選擇自訂 Agent 時，Agent 會直接處理逐字稿，不會顯示分段 N/M 進度。

不論使用預設範本或自訂 Agent，你都可以離開頁面，工作仍會在背景繼續。重新整理或稍後回到這場會議時，系統會接續顯示目前狀態。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-61d8c4726b9e278842929b724ea85d69c6faa538%2Fmeeting-summary-progress.png?alt=media" alt="長會議的會議摘要分頁顯示分析逐字稿 0/3 與進度條"><figcaption><p>離開頁面再回來，仍可看到預設範本的分段進度</p></figcaption></figure>

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-cbcb02b8196e7519846ac89827588c029712f6b4%2Fmeeting-detail-summary.png?alt=media" alt="長會議摘要完成後顯示最新版本與共三個版本"><figcaption><p>摘要完成後，新版本會出現在版本清單</p></figcaption></figure>

{% hint style="info" %}
摘要完成後會直接建立一個新版本，不需要另外儲存。若產生失敗，畫面會提示重試；確認逐字稿可用後，再點一次 <mark style="color:blue;">重新生成</mark> 即可。
{% endhint %}

## 摘要版本管理 <a href="#summary-version-management" id="summary-version-management"></a>

每次產生或編輯摘要，系統都會保留完整的版本紀錄：

* **新增摘要**：每次產生摘要都會建立一個新版本
* **編輯摘要**：可修改現有摘要內容
* **版本歷史**：查看所有摘要版本及其建立時間
* **刪除摘要**：移除不需要的摘要版本

## 複製摘要 <a href="#copy-summary" id="copy-summary"></a>

檢視已儲存的摘要時，摘要上方的工具列會出現 <mark style="color:blue;">複製摘要</mark> 按鈕，一鍵即可將整份摘要複製到剪貼簿，不必再手動拖曳選取全文，方便直接貼到郵件、文件或通訊軟體。

1. 進入會議詳情頁面，切換到「會議摘要」分頁
2. 選擇一筆已儲存的摘要
3. 點擊 <mark style="color:blue;">複製摘要</mark>
4. 出現「複製成功」提示後，即可貼到其他應用程式

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-558d2684a9c9471306571d306d3a3e3d7e4663cd%2Fmeeting-summary-copy.png?alt=media" alt="會議摘要分頁工具列上的複製摘要按鈕"><figcaption><p>「會議摘要」分頁的工具列</p></figcaption></figure>

複製的是摘要的原始文字，會保留原本的段落結構。

{% hint style="info" %} <mark style="color:blue;">複製摘要</mark> 只在檢視已儲存的摘要時可用。編輯摘要或預覽尚未儲存的草稿時，工具列不會出現；摘要內容為空時，按鈕則呈現停用狀態。
{% endhint %}

若畫面顯示「複製失敗」，通常是瀏覽器阻擋了剪貼簿權限，請改以手動選取的方式複製。

## 匯出摘要與寄送 Email <a href="#export-summary" id="export-summary"></a>

要把摘要存成檔案或直接寄出，用 <mark style="color:blue;">複製摘要</mark> 旁的 <mark style="color:blue;">匯出</mark> 下拉選單：

| 選項                                            | 得到什麼                                                                                        |
| --------------------------------------------- | ------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">匯出為 Markdown</mark> | `.md` 檔，保留標題、條列等格式，適合貼進 Notion、GitHub 等支援 Markdown 的工具                                      |
| <mark style="color:blue;">匯出為 PDF</mark>      | 版面與畫面一致的 PDF，適合直接轉寄或歸檔                                                                      |
| <mark style="color:blue;">匯出為 docx</mark>     | Word 檔，適合還要再編輯                                                                              |
| <mark style="color:blue;">匯出為純文字</mark>       | `.txt`，不含任何格式符號                                                                             |
| <mark style="color:blue;">寄送 Email</mark>     | 開啟你電腦上的郵件軟體，主旨為「{會議名稱} 會議摘要」、內文帶入摘要；收件人自己填。摘要太長塞不進郵件時，內文會附註「（內容過長，完整摘要請使用匯出）」，請改用上面的匯出再夾帶附件 |

匯出的是**目前檢視的這個版本**。檔案會由瀏覽器下載，完成後顯示「匯出成功」；逐字稿與音檔的下載在詳情頁標題列，見 [下載與知識庫整合](/work/meeting-records/download-and-export.md)。

## 朗讀摘要 <a href="#read-aloud-summary" id="read-aloud-summary"></a>

不方便閱讀時，可以讓系統把摘要唸出來。檢視已儲存的摘要時，工具列會出現 <mark style="color:blue;">朗讀</mark> 按鈕，點擊後即以語音播報摘要內容。

1. 進入會議詳情頁面，切換到「會議摘要」分頁
2. 選擇一筆已儲存的摘要
3. 點擊 <mark style="color:blue;">朗讀</mark>，按鈕顯示「準備中…」，稍候即開始播報
4. 播報中可點 <mark style="color:blue;">暫停</mark> 暫停、<mark style="color:blue;">繼續</mark> 接續，或 <mark style="color:blue;">停止</mark> 結束

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-dbbc0c6b9faadebe54b82a231fe8b5291fc9d906%2Fmeeting-summary-read-aloud.png?alt=media" alt="播報中的暫停與停止按鈕"><figcaption><p>播報中，「朗讀」會換成「暫停」與「停止」</p></figcaption></figure>

朗讀前系統會自動移除摘要中的 Markdown 符號（`#`、`*`、`-` 等），不會把符號唸出來。

### 朗讀語音與支援語言 <a href="#read-aloud-languages" id="read-aloud-languages"></a>

朗讀語音依**這場會議的語音或目標翻譯語言**決定，不是依摘要的實際內容判斷。目前支援下列七種語言：

| 語言       | 語言代碼    |
| -------- | ------- |
| 繁體中文（台灣） | `zh-TW` |
| 英文（美國）   | `en-US` |
| 日文       | `ja-JP` |
| 韓文       | `ko-KR` |
| 泰文       | `th-TH` |
| 印尼文      | `id-ID` |
| 越南文      | `vi-VN` |

{% hint style="warning" %}
會議語言若不在上述清單中（例如簡體中文 `zh-CN`、粵語 `zh-HK`），工具列會出現「目前不支援⋯⋯，會以預設語言朗讀」的提示。此時仍可朗讀，但會改用繁體中文語音。
{% endhint %}

### 使用限制 <a href="#read-aloud-limits" id="read-aloud-limits"></a>

* <mark style="color:blue;">朗讀</mark> 只在檢視已儲存的摘要時可用；編輯摘要或預覽尚未儲存的草稿時不會出現
* 摘要內容為空時，按鈕呈現停用狀態
* 切換摘要版本或離開「會議摘要」分頁時會自動停止播報，不會留下背景聲音
* 瀏覽器不支援語音播放時，按鈕不會顯示
* 播報失敗時會顯示「語音朗讀失敗，請稍後再試」，可稍後再試一次

## AI 問答 <a href="#ai-qa" id="ai-qa"></a>

除了摘要功能，你也可以直接對逐字稿內容提問：

1. 切換到「AI 問答」分頁
2. 選擇要使用的 Agent
3. 輸入問題（例如：「這場會議做了哪些決定？」「下一步的 action items 有哪些？」）
4. AI 會從逐字稿中找出相關內容並回答

這個功能特別適合快速回顧長時間會議的特定內容，不需要重新閱讀整份逐字稿。

## 串接 Agent 開單 <a href="#connect-agent-ticket-creation" id="connect-agent-ticket-creation"></a>

會議結束後，待辦事項與決議通常還要有人手動搬進專案管理或工單系統。你可以讓 Agent 接手這一步：在 <mark style="color:blue;">AI 問答</mark> 分頁中，請它把會議裡談定的事項直接建立成任務或工單。

{% hint style="info" %}
會議記錄本身沒有獨立的「開單」按鈕。<mark style="color:blue;">AI 問答</mark> 使用的是完整的 Agent 對話，因此**只要所選的 Agent 配置了能建立工單的工具，就能在對話中請它開單**——開單能力來自 Agent，不是來自會議記錄。
{% endhint %}

### 運作方式 <a href="#ticket-how-it-works" id="ticket-how-it-works"></a>

| 環節               | 內容                                                            |
| ---------------- | ------------------------------------------------------------- |
| **① 會議逐字稿**      | 會議轉錄完成，逐字稿已上傳至知識庫並解析完成                                        |
| **② 選擇 Agent**   | 在 <mark style="color:blue;">AI 問答</mark> 分頁選擇一個已配置開單工具的 Agent |
| **③ 下達開單指令**     | 例如「把這場會議的待辦事項整理出來，每一項幫我建立一張工單」                                |
| **④ Agent 呼叫工具** | Agent 依角色指令中的欄位對應與開單規則，呼叫 API 工具或 MCP 工具                      |
| **⑤ 建立工單**       | 工單寫入貴公司的工單或專案管理系統                                             |
| **⑥ 回報結果**       | Agent 在對話中回報每張工單的編號與連結                                        |

### 前置條件 <a href="#ticket-prerequisites" id="ticket-prerequisites"></a>

| 條件                    | 說明                                                                                                                                                                                                                                                                           |
| --------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **會議已關聯知識庫，且逐字稿解析完成** | <mark style="color:blue;">AI 問答</mark> 需要逐字稿進入知識庫後才能使用。[建立會議](/work/meeting-records/create-meeting.md)時即可關聯知識庫；若當時未設定，也能在 <mark style="color:blue;">AI 問答</mark> 分頁選擇知識庫後點 <mark style="color:blue;">上傳逐字稿</mark>，詳見[下載與知識庫整合](/work/meeting-records/download-and-export.md) |
| **有一個配置了開單工具的 Agent** | 實際呼叫工單系統的是工具，不是會議記錄。設定方式見下方步驟                                                                                                                                                                                                                                                |
| **工單系統提供可呼叫的 API**    | MaiAgent 透過 API 工具或 MCP 工具與外部系統溝通，不限定特定廠牌；只要對方開放建立工單的 API 即可串接                                                                                                                                                                                                               |

### 設定步驟 <a href="#ticket-setup" id="ticket-setup"></a>

1. **建立開單工具**：於 <mark style="color:blue;">工具</mark> 頁面點選 <mark style="color:blue;">新增 API 工具</mark>，將貴公司工單系統的「建立工單」API 設定進去（可直接貼上 cURL 指令，系統會自動解析 URL、標頭與 HTTP 方法），詳見[建立 API 工具](/build/tools/setup_api_tool.md)。若對方提供 MCP server，也可改用 [MCP 工具](/build/tools/mcp-setup.md)。
2. **把工具配置給 Agent**：將剛建立的工具加入該 Agent 的可用工具清單，見[為 Agent 配置工具](/build/tools/configure_tools.md)。
3. **在角色指令中寫清楚開單規則**：AI 是否在正確時機呼叫工具、欄位怎麼填，取決於角色指令。可參考下方範例，撰寫原則見[角色指令設計指南](/build/agent/system-prompt.md)。
4. **在會議中使用**：進入會議詳情頁的 <mark style="color:blue;">AI 問答</mark> 分頁，選擇這個 Agent 後直接下指令，例如「把這場會議的待辦事項整理出來，每一項幫我建立一張工單」。

{% hint style="warning" %}
開單是會寫入外部系統的動作。建議先以測試專案或測試環境驗證欄位對應無誤，再切換到正式工單系統。
{% endhint %}

### 角色指令範例 <a href="#ticket-prompt-example" id="ticket-prompt-example"></a>

```
# 角色
你是會議行動事項的開單助理。

# 任務
使用者會請你根據會議逐字稿建立工單，請依下列流程處理：

1. 從逐字稿中找出明確的待辦事項與決議，忽略純討論、尚未拍板的內容
2. 每一項待辦整理成一張工單，欄位對應如下：
   - 標題：一句話描述要做什麼，30 字以內
   - 內容：補上會議中提到的背景與判斷依據
   - 負責人：逐字稿中明確指派的人
   - 到期日：逐字稿中明確提到的日期
3. 呼叫工具前，先將整理好的工單清單列給使用者確認，取得同意後才建立
4. 建立完成後，回報每張工單的編號與連結

# 限制
- 只依據逐字稿內容開單，不要自行補充未討論過的任務
- 負責人或到期日無法從逐字稿判斷時，留空並在回覆中標註，不要猜測
- 同一件事在會議中被多次提及時，合併為一張工單
```

### 驗證與疑難排解 <a href="#ticket-troubleshooting" id="ticket-troubleshooting"></a>

工具實際收到的參數與回傳結果，可到 AgentOps 的[工具執行記錄](/build/agent-ops/tool-execution-records.md)查看，這是排查開單問題最快的方式。

| 問題                                          | 原因與處理                                             |
| ------------------------------------------- | ------------------------------------------------- |
| <mark style="color:blue;">AI 問答</mark> 無法使用 | 會議尚未關聯知識庫，或逐字稿仍在解析中。可在該分頁選擇知識庫並上傳逐字稿，待解析完成後再試     |
| AI 列出了待辦清單，但沒有真的開單                          | 工具未加入該 Agent 的工具清單，或角色指令沒有明確要求呼叫工具。檢查步驟 2 與步驟 3   |
| 工單建立失敗                                      | 查看工具執行記錄中的錯誤訊息，常見原因為必填欄位缺漏、認證失效或權限不足              |
| 工單欄位內容不正確                                   | 在角色指令中把欄位對應規則寫得更具體，並明確指示無法判斷時留空而非猜測               |
| AI 的回答與這場會議無關                               | 目前選用的 Agent 可能未關聯此會議的知識庫，介面會出現提醒；切換到已關聯的 Agent 即可 |


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.maiagent.ai/work/meeting-records/summary.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
