> 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/maigpt/chat/conversation-handoff.md).

# 對話交接

對話太長時，讓 Agent 整理一份交接摘要，再開一個新對話接著做，不必重新交代前情

同一個對話聊得越久，Agent 要記住的內容就越多。內容多到接近上限時，Agent 會開始記不清楚最早談過的事。

「對話交接」讓你在這個時候請 Agent 把目前的進度整理成一份**交接摘要**，然後一鍵開一個新對話接著做。新對話裡的 Agent 會先讀這份摘要，你不用重新說明背景，原本的對話也會保留，隨時可以回去看。

{% hint style="info" %}
對話交接需由 MaiAgent 開啟系統的全域對話交接功能後才能使用。這個全域開關不在後台，客戶管理員無法自行設定，需要洽 MaiAgent。全域開啟後，對話交接可以在 **MaiGPT** 與 **Web Chat** 使用；其中 Web Chat 還需要管理員在對話平台開啟「啟用對話交接」（見[在 Web Chat 開啟](#enable-on-web-chat)）。LINE、Facebook Messenger、Microsoft Teams 等其他對話平台不支援。
{% endhint %}

***

## 使用情境 <a href="#use-case" id="use-case"></a>

行銷專員在 MaiGPT 規劃秋季新品發表會，已經和 Agent 來回討論了一整個下午：場地、來賓人數、預算分配、兩款主打新品的介紹稿都談過了。她注意到輸入框下方的「上下文使用量」來到 82%，輸入框上方也出現提示條，建議她整理交接。

她按下「整理交接」，Agent 整理出一份交接摘要，列出活動目標、已決定的場地與預算、還在進行的介紹稿，以及剩下的待辦。她看過摘要沒問題，按「接續到新對話」。畫面切到新對話，Agent 先說明「已接續，目前待辦是……」，她直接接著請 Agent 寫邀請函，不必再貼一次前面的討論。

***

## 在哪裡可以使用 <a href="#where-available" id="where-available"></a>

| 入口           | 誰會用到      | 說明                                                                       |
| ------------ | --------- | ------------------------------------------------------------------------ |
| **MaiGPT**   | 組織成員      | MaiGPT 的對話頁，無論你使用哪一種版面，操作方式都相同。全域對話交接功能開啟後即可使用，不需要另外設定平台開關               |
| **Web Chat** | 網站訪客、組織成員 | 嵌入在網站上的 Web Chat 對話視窗，未登入的訪客也能使用。全域對話交接功能開啟後，還需管理員在該對話平台開啟「啟用對話交接」（預設關閉） |

{% hint style="warning" %}
**Web Chat 的 Agent 需使用 Agent 模式**

交接摘要是由 Agent 整理產出的。Web Chat 串接的 Agent 若不是使用「Agent 模式」（或 Agent Teams），Agent 無法產生交接摘要。MaiGPT 不受影響。
{% endhint %}

### 在 Web Chat 開啟 <a href="#enable-on-web-chat" id="enable-on-web-chat"></a>

Web Chat 的對話交接與上下文使用量是**兩個獨立的開關**，都掛在各個對話平台上、預設關閉。客戶對外嵌入的 Web Chat 在管理員開啟前，訪客看不到任何交接提示，也看不到上下文使用量。「顯示上下文使用量」開啟後就會生效；「啟用對話交接」則要在 MaiAgent 已開啟全域對話交接功能時才有作用。

一家電商的客服主管發現，網站訪客常在同一個對話裡連續問好幾張訂單，聊到後來 Agent 記不清一開始提過的訂單編號。她想先讓訪客看得到對話已經用了多少空間，於是打開官網 Web Chat 對話平台的 <mark style="color:blue;">功能設定</mark>，只開啟 <mark style="color:blue;">顯示上下文使用量</mark> 並儲存。訪客重新打開對話視窗、收到 Agent 第一則回覆後，輸入框下方就出現「上下文使用量」與百分比。

#### 1. 進入對話平台的功能設定 <a href="#open-function-settings" id="open-function-settings"></a>

在後台進入 <mark style="color:blue;">客服對話</mark> → <mark style="color:blue;">對話平台</mark>，編輯要開啟的 Web Chat 平台，在左側選單點 <mark style="color:blue;">功能設定</mark>。

#### 2. 開啟需要的開關並儲存 <a href="#turn-on-switches" id="turn-on-switches"></a>

「基本功能」區塊有兩個開關，可以只開其中一個，也可以都開：

| 開關                                        | 開啟後 Web Chat 的效果                                                                    |
| ----------------------------------------- | ----------------------------------------------------------------------------------- |
| <mark style="color:blue;">啟用對話交接</mark>   | 全域對話交接功能開啟時，上下文使用量達 80% 起顯示交接提示條，Agent 可產生交接摘要卡，訪客可以交接到新對話。全域功能未開啟時，打開這個開關不會有任何可見變化 |
| <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-0c70e66268aa842a00483f1b0317c79433f6d409%2Fplatform-function-settings-handoff-context-usage.png?alt=media" alt="對話平台功能設定的基本功能區塊，最後一列為啟用對話交接與顯示上下文使用量兩個開關"><figcaption><p>「功能設定」→「基本功能」的「啟用對話交接」與「顯示上下文使用量」</p></figcaption></figure>

{% hint style="info" %}

* **兩個開關互相獨立**：只開「顯示上下文使用量」時，只會顯示百分比，不會出現交接提示條；只開「啟用對話交接」時，輸入框下方不顯示使用量；交接提示條仍會在使用量達 80%、90%、100% 門檻時出現（需全域對話交接功能開啟）。
* **對話交接另受全域開關管制**：全域對話交接開關由 MaiAgent 控制，後台沒有這個設定，客戶管理員無法自行開啟，需要洽 MaiAgent。全域開關關閉時，所有平台（含 MaiGPT）都不會出現交接功能，打開「啟用對話交接」也看不出任何變化。「顯示上下文使用量」不受全域開關影響。
* 內部平台的設定頁不顯示這兩個開關。各開關在設定頁的位置請見[功能設定](/build/conversation-settings/platform-settings/function-settings.md)。
  {% endhint %}

***

## 查看上下文使用量 <a href="#context-usage" id="context-usage"></a>

對話輸入框下方會顯示一行「<mark style="color:blue;">上下文使用量</mark>」，包含一條短進度條與百分比，代表這個對話已經用掉多少 Agent 能記住的空間。

* **MaiGPT**：一律顯示，不需要設定。
* **Web Chat**：管理員在該對話平台開啟 <mark style="color:blue;">顯示上下文使用量</mark> 後才顯示（見[在 Web Chat 開啟](#enable-on-web-chat)）。這個開關與「啟用對話交接」互相獨立。

顯示規則：

* 新對話在 Agent 第一次回覆後才會出現這一行。
* 每次 Agent 回覆完成後更新。
* 最高顯示到 100%。

使用量越接近 100%，越建議交接到新對話。達到 100% 之後，Agent 會開始無法參考最早的對話內容。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-a28fe8dd2dc5291b307b4665268f15f1df1d879f%2Fconversation-handoff-context-usage.png?alt=media" alt="MaiGPT 輸入框下方顯示上下文使用量進度條與百分比"><figcaption><p>輸入框下方的「上下文使用量」會在每次 Agent 回覆後更新</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-62279bf41255a0b107f261a899541c9fc38d8e2b%2Fplatform-webchat-context-usage-bar.png?alt=media" alt="Web Chat 輸入框下方顯示上下文使用量進度條與 0%"><figcaption><p>Web Chat 開啟「顯示上下文使用量」後，輸入框下方出現「上下文使用量」與百分比</p></figcaption></figure>

***

## 三種開始交接的方式 <a href="#how-to-start" id="how-to-start"></a>

### 1. 直接請 Agent 交接 <a href="#ask-directly" id="ask-directly"></a>

任何時候都可以在輸入框輸入類似下面的句子並送出：

> 把這個對話交接到新對話

Agent 會整理出一份交接摘要（見下方「[交接摘要](#handoff-summary)」）。不需要等到使用量變高才能交接。

### 2. 使用提示條 <a href="#prompt-bar" id="prompt-bar"></a>

上下文使用量達到 **80%** 時，輸入框上方會出現一條提示：

> 此對話上下文將到達上限，建議整理摘要並交接至新對話再繼續

提示條右側有兩個按鈕：

* <mark style="color:blue;">整理交接</mark>：自動幫你送出「把這個對話交接到新對話」，Agent 隨即整理交接摘要。
* <mark style="color:blue;">關閉</mark>：先收起提示條，繼續在原對話聊天。

關閉後，提示條會在使用量跨過下一個門檻（**90%**、**100%**）時再出現一次。達到 100% 時，提示文字會改為：

> 此對話上下文已達上限，為維持對話內容的完整性，建議進行摘要並交接到新對話再繼續

{% hint style="info" %}
關閉提示條的設定只在目前開著的頁面有效。重新整理頁面後，如果使用量仍在門檻以上，提示條會再出現。
{% endhint %}

### 3. 回應 Agent 的主動詢問 <a href="#assistant-asks" id="assistant-asks"></a>

上下文使用量達到 80% 時，Agent 會在該次回覆的最後多問一句，例如：

> 這個對話已經蠻長了，要不要我整理重點、交接到新對話繼續？

* 回答「好」「可以」之類表示同意的話，Agent 就會整理交接摘要。
* 回答「不用」或不理會，Agent 會照常繼續，不會每一次都重複問。
* 使用量達到 90% 與 100% 時，Agent 會再各提醒一次。

Agent 的詢問和提示條會同時出現，選哪一種方式交接都可以。

***

## 交接摘要 <a href="#handoff-summary" id="handoff-summary"></a>

Agent 整理好的交接摘要會以一張「<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-e2cd9c3c00f4894f679b9fdeddab12d32735c0c8%2Fconversation-handoff-summary-card.png?alt=media" alt="MaiGPT 對話中的交接摘要卡片，含目標、已決定、進行中、待辦、關鍵引用五個區塊與接續到新對話按鈕"><figcaption><p>輸入交接指令後，Agent 在原對話留下一張交接摘要卡片</p></figcaption></figure>

{% hint style="warning" %}
**系統不會自動跳轉**

產生交接摘要後，你仍然留在原對話。請先看過摘要內容，確認無誤再按「接續到新對話」。如果摘要漏了重要資訊，可以直接在原對話請 Agent 補充，或再要求交接一次。
{% endhint %}

同一個對話可以交接不只一次。每次都會產生一份新的交接摘要，只有**最新一份**摘要上會出現按鈕。

***

## 接續到新對話 <a href="#continue-in-new-conversation" id="continue-in-new-conversation"></a>

{% stepper %}
{% step %}

### 按下「接續到新對話」 <a href="#click-continue" id="click-continue"></a>

在交接摘要卡片底部點擊 <mark style="color:blue;">接續到新對話</mark>。建立期間按鈕會顯示「建立新對話…」。
{% endstep %}

{% step %}

### 進入新對話 <a href="#enter-new-conversation" id="enter-new-conversation"></a>

畫面切換到新對話，標題是原對話標題後面加上「（續）」。新對話的第一則訊息由系統代你送出，內容為「接續自〈原對話標題〉的交接」，訊息旁標示「系統代送」。
{% endstep %}

{% step %}

### Agent 確認接續狀態 <a href="#assistant-confirms" id="assistant-confirms"></a>

Agent 讀取交接摘要後，會先用一句話說明接續的狀態，例如「已接續，目前待辦是……」。接著你就可以照常對話。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-bd08fd6bcf6ad1364e3e57186ffb1c719b0fc762%2Fconversation-handoff-new-conversation.png?alt=media" alt="新對話第一則為標示系統代送的接續訊息，Agent 回覆已接續並列出待辦"><figcaption><p>新對話由系統代送接續訊息，Agent 讀回摘要後確認接續狀態</p></figcaption></figure>
{% endstep %}
{% endstepper %}

交接完成後，對話清單會標示兩個對話的關係：原對話標示「已交接至」，新對話標示「接續自原對話」。原對話的按鈕會變成「<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-066b9a3bef1bbf431932dc0edd2a7e2734fd90ff%2Fconversation-handoff-list-badges.png?alt=media" alt="對話清單中新對話標示接續自原對話、原對話標示已交接至"><figcaption><p>對話清單會標示兩個對話的交接關係</p></figcaption></figure>

如果建立新對話失敗，畫面會顯示「建立新對話失敗，請再試一次」，按鈕恢復為可以再按一次。

***

## 新對話接續後可以做什麼 <a href="#after-handoff" id="after-handoff"></a>

* **直接接著做**：Agent 已經知道交接摘要裡的目標、決策與待辦，你可以直接交代下一步。
* **同一個 Agent**：新對話使用和原對話相同的 Agent，模型、知識庫與工具設定都相同。
* **回頭查看原對話**：原對話完整保留在對話清單中，需要時可以打開回看。
* **再次交接**：新對話聊久了，一樣可以再交接到下一個新對話，使用量會從新對話重新計算。

新對話裡的 Agent 只看得到交接摘要，看不到原對話的其他訊息。以下內容不會帶進新對話：

* 原對話上傳的檔案、圖片（摘要只會列出檔名）
* 原對話產出的檔案與 Canvas 內容
* 摘要以外的對話細節

如果新對話需要用到這些內容，請重新上傳檔案，或把需要的段落貼進新對話。

{% hint style="info" %}
如果原對話或交接摘要在接續前已被刪除，Agent 會告訴你「找不到原對話的交接摘要，請直接告訴我要繼續什麼」。這時請直接說明你要繼續的事即可。
{% endhint %}

***

## Web Chat 訪客使用說明 <a href="#web-chat-visitors" id="web-chat-visitors"></a>

未登入的 Web Chat 訪客也可以交接，操作方式與上方相同。要注意的是：

* 新對話和原對話只保存在訪客目前使用的瀏覽器中，換一個瀏覽器或裝置就看不到。
* 訪客的對話紀錄過期後，原對話無法再打開，但已建立的新對話可以繼續使用。

***

## 不支援的情境 <a href="#not-supported" id="not-supported"></a>

| 情境                                                    | 說明                          |
| ----------------------------------------------------- | --------------------------- |
| LINE、Facebook Messenger、Microsoft Teams、Slack 等其他對話平台 | 不會顯示使用量、提示條，Agent 也不會主動詢問交接 |
| 自動跳轉到新對話                                              | 不支援。一定要由你按下「接續到新對話」         |
| 交接給不同的 Agent                                          | 不支援。新對話固定使用原對話的 Agent       |
| 把原對話的附件、產出檔案帶到新對話                                     | 不支援。請在新對話重新上傳               |
| 在同一個對話內壓縮內容後繼續聊                                       | 不支援。交接一定會開一個新對話             |

***

## 常見問題 <a href="#faq" id="faq"></a>

**使用量還很低，可以交接嗎？**

可以。直接輸入「把這個對話交接到新對話」即可，不需要等提示條出現。

**不小心關掉提示條，還能交接嗎？**

可以。直接在輸入框請 Agent 交接就好。

**上下文使用量是怎麼算的？**

百分比代表這個對話目前占用了多少 Agent 能記住的空間，依對話內容與 Agent 使用的模型估算。不同模型能記住的量不同，所以同樣長度的對話，使用量可能不一樣。

**原對話交接後還能繼續聊嗎？**

可以。原對話不會被鎖定，但使用量已經偏高，建議改在新對話繼續。

**相關功能**

* [AI 對話](/work/maigpt/chat.md)
* [功能設定](/build/conversation-settings/platform-settings/function-settings.md)：Web Chat 的「啟用對話交接」與「顯示上下文使用量」開關
* [對話交接與接續對話 API](https://docs.maiagent.ai/tech/serve/conversation-handoff-continuation)（技術手冊）：自建前端或以 API 串接時，如何用交接摘要建立接續對話


---

# 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/maigpt/chat/conversation-handoff.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.
