> 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/build/conversation-settings/platform-settings/function-settings.md).

# 功能設定

對話平台的功能設定：基本功能、AI 互動功能、Hook 處理標記、提問集選項顯示模式，以及 AI 感知設定（使用系統時間、傳送者名稱、位置資訊回答）與時區規則。

<mark style="color:blue;">功能設定</mark> 是對話平台設定頁裡開關最多的一個分類，決定使用者在對話中「能做什麼、看得到什麼」，以及 AI 回答時「知道什麼」。網頁與 API 平台有完整五個區塊，內部平台沒有「提問集選項顯示模式」；LINE、Microsoft Teams 等通訊平台只有「AI 互動功能」（<mark style="color:blue;">啟用 OCR</mark>、<mark style="color:blue;">@ 提及才回覆</mark> 與 [各平台專屬開關](#messaging-platform-switches)）與「AI 感知設定」。

{% hint style="info" %}
**方案導覽**：本頁是對話平台設定的其中一步，文字客服的完整上線流程見 [文字客服：從零到上線](/serve/text-service.md)。
{% endhint %}

{% hint style="warning" %}
這些設定**掛在每一個對話平台上，不是掛在 Agent 上**。同一個 Agent 接了網頁與 LINE，就要分別在兩個平台設定。設定頁的整體結構與進入方式請見[對話平台設定總覽](/build/conversation-settings/platform-settings.md)。
{% endhint %}

## 一、什麼時候會用到 <a href="#when-to-use" id="when-to-use"></a>

一家診所用 Agent 在 LINE 上回答掛號問題。病患問「今天下午還能掛號嗎」，Agent 卻反問「請問今天是幾月幾日」。負責的行政人員打開 LINE 平台的 <mark style="color:blue;">功能設定</mark>，把 <mark style="color:blue;">使用系統時間回答</mark> 打開，時區維持 Asia/Taipei，按下 <mark style="color:blue;">儲存</mark>。再問一次，Agent 直接回答「今天是星期五，下午門診 14:00 開始，目前還可以掛號」，Agent 的角色指令一個字都沒改。

## 二、基本功能 <a href="#basic-functions" id="basic-functions"></a>

<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>

| 開關           | 說明                                                                                                                                                                                            |
| ------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **是否啟用**     | 關閉後這個平台停止對外服務，使用者打開對話頁無法送出訊息                                                                                                                                                                  |
| **允許上傳檔案**   | 使用者可以在對話中上傳圖片或檔案給 AI 分析                                                                                                                                                                       |
| **允許分享對話**   | 使用者可以產生對話的分享連結                                                                                                                                                                                |
| **允許切換字級大小** | 對話視窗提供字級切換                                                                                                                                                                                    |
| **啟用對話交接**   | MaiAgent 已開啟全域對話交接功能時，此平台的 Web Chat 會在上下文使用量達 80% 起顯示交接提示條，並可產生交接摘要卡。全域開關不在後台，需洽 MaiAgent；全域未開啟時，打開這個開關不會有任何可見變化。預設關閉。說明見[對話交接](/work/maigpt/chat/conversation-handoff.md#enable-on-web-chat) |
| **顯示上下文使用量** | 此平台的 Web Chat 在輸入框下方顯示上下文使用量百分比。與對話交接互相獨立，可以只開其中一個。預設關閉                                                                                                                                       |

{% hint style="info" %} <mark style="color:blue;">啟用對話交接</mark> 與 <mark style="color:blue;">顯示上下文使用量</mark> 只出現在網頁與 API 平台，內部平台的設定頁不顯示這兩個開關。MaiGPT 不需要設定：上下文使用量一律顯示，對話交接只看全域開關。兩個功能在對話中的實際效果請見[對話交接](/work/maigpt/chat/conversation-handoff.md)。
{% endhint %}

### 「是否啟用」的預設值與切換權限 <a href="#activation-default-and-permission" id="activation-default-and-permission"></a>

* **誰可以切換**：能編輯這個對話平台的成員就能切換 <mark style="color:blue;">是否啟用</mark>，也就是角色具備 <mark style="color:blue;">對話平台權限</mark>，且在 <mark style="color:blue;">分配對話平台</mark> 中對此平台有 <mark style="color:blue;">編輯</mark> 權限；只有讀取權限的成員無法切換。設定方式見 [角色權限管理](/org/roles/role-permission.md#assign-inboxes) 與 [角色資源可見性控制](/org/roles/group-resource-visibility.md)。
* **新 Agent 的預設狀態**：建立 Agent 時，可以在建立視窗的 [對話平台啟用](/build/agent/setup.md#channel-activation) 決定網頁與 API 平台要不要啟用，開關的初始值跟著組織設定。複製 Agent 等其他方式產生的新 Agent 則直接套用組織設定。平台預設是新 Agent 只啟用內部平台，網頁與 API 平台先停用；具備「組織概覽權限」的成員可以在 [編輯組織](/org/overview/organization-overview.md#new-agent-channel-default) 改為預設啟用。調整只影響之後新建或複製的 Agent，既有 Agent 的狀態不變；內部平台一律啟用。
* **停用時訪客看到什麼**：Web Chat 會直接顯示「此頁面暫時不提供服務」，不會先要求登入或填寫對話前表單。

## 三、AI 互動功能 <a href="#ai-interaction" id="ai-interaction"></a>

| 開關                    | 說明                                                                                                                                                                                                                          |
| --------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **顯示引用文件**            | AI 回答時列出參考的知識庫來源，使用者點引用節點可看到文件片段                                                                                                                                                                                            |
| **允許下載引用文件**          | 使用者可以下載被引用的檔案                                                                                                                                                                                                               |
| **啟用 OCR**            | 辨識上傳圖片中的文字，讓 AI 讀得到截圖或掃描件的內容                                                                                                                                                                                                |
| **顯示思考過程**            | 對話中顯示 AI 的推理過程                                                                                                                                                                                                              |
| **允許使用者調整思考力度**       | 使用者可以在對話視窗自行調整 AI 的思考深度。要讓對話視窗出現思考力度按鈕，必須**同時開啟「顯示思考過程」**，且 Agent 使用的模型支援思考；Agent 的預設等級在 [建立 Agent：設定思考力度](/build/agent/setup.md#thinking-effort) 設定，使用者端選單中「預設」的實際行為見 [MaiGPT 對話：思考力度](/work/maigpt/chat.md#deep-thinking) |
| **顯示知識庫檔案及 FAQ 選取列表** | 只有內部平台有這個開關，預設開啟。開啟後，成員在內部對話中可以從 Agent 關聯的知識庫檔案與 FAQ 清單勾選本次要查詢的範圍，Agent 只在選取的範圍內檢索；關閉則不顯示清單，一律檢索全部關聯的知識庫                                                                                                                    |

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-cf55d79da78aa33d7ff99449439a86bc807ccced%2F%E4%B8%8B%E8%BC%89%E6%96%87%E4%BB%B6display.png?alt=media" alt="對話視窗顯示引用文件與下載按鈕"><figcaption><p>開啟「顯示引用文件」與「允許下載引用文件」後的對話畫面</p></figcaption></figure>

依使用情境決定是否公開引用資訊：公開客服顯示所有引用建立信任感；內部支援可關閉下載保護機密文件；教育機構顯示學習資源方便學生查閱。

### Web Chat 的思考力度按鈕 <a href="#web-chat-thinking-effort" id="web-chat-thinking-effort"></a>

Web Chat 要同時符合三個條件，輸入框下方才會出現思考力度按鈕：開啟 <mark style="color:blue;">顯示思考過程</mark>、開啟 <mark style="color:blue;">允許使用者調整思考力度</mark>，且 Agent 使用的模型支援思考。

按鈕上顯示這段對話目前套用的等級。點開後，上方是 <mark style="color:blue;">預設</mark> 與 <mark style="color:blue;">關閉</mark>（只在模型可以關閉思考時出現），下方是 Agent 所用模型支援的等級；訪客選好後，這段對話之後的回覆都依該等級思考。Agent 本身的預設等級在 [建立 Agent：設定思考力度](/build/agent/setup.md#thinking-effort) 設定。

Agent 已設定預設等級時，選單的 <mark style="color:blue;">預設</mark> 下方顯示「跟隨助理設定」；Agent 沒有設定等級時，<mark style="color:blue;">預設</mark> 會依模型實際行為標示為 <mark style="color:blue;">預設（不思考・最快）</mark> 或 <mark style="color:blue;">預設（模型會自行思考）</mark>，說明見 [MaiGPT 對話：思考力度](/work/maigpt/chat.md#deep-thinking)。各思考等級的說明都是「開啟思考：每次模型呼叫約多 1–3 秒，依模型而異」。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-8996a41a29e59f76f010f4d0f5ca4f5c196551ea%2Fwebchat-thinking-effort-menu.png?alt=media" alt="Web Chat 的思考力度選單：預設（跟隨助理設定）、關閉（不進行思考），以及低、中、高、極高、最高，各附「開啟思考：每次模型呼叫約多 1–3 秒，依模型而異」，目前選中低"><figcaption><p>Web Chat 的思考力度選單：Agent 已設定等級時，「預設」顯示跟隨助理設定</p></figcaption></figure>

### 通訊平台專屬開關 <a href="#messaging-platform-switches" id="messaging-platform-switches"></a>

LINE、Telegram、Microsoft Teams、Slack、Viber 等通訊平台的 <mark style="color:blue;">功能設定</mark> 分頁，「AI 互動功能」區除了 <mark style="color:blue;">啟用 OCR</mark>，還有依平台能力提供的開關：

| 開關                                          | 哪些平台                                                 | 說明                                                                                                                                                                                          |
| ------------------------------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">@ 提及才回覆</mark>    | 有群組聊天的平台（LINE、Telegram 等；Slack、LINE WORKS 在建立時的對應選項） | 在群組中只有被 @ 提及時才回覆；一對一對話不受影響                                                                                                                                                                  |
| <mark style="color:blue;">AI 助理思考中動畫</mark> | LINE                                                 | 預設開啟。使用者送出訊息後，AI 產生回覆期間在 LINE 顯示「思考中」的載入動畫。只在一對一聊天室生效，群組不會顯示。LINE 的這個開關在 <mark style="color:blue;">基本設定</mark> 分頁，見 [LINE：AI 助理思考中動畫](/build/choose-channel/line.md#line-loading-animation) |
| <mark style="color:blue;">啟用輸入中提示</mark>    | Telegram                                             | 機器人處理回覆時顯示 Telegram 原生的「輸入中…」提示                                                                                                                                                             |
| <mark style="color:blue;">等待提示訊息</mark>     | Microsoft Teams、Slack、Telegram、Viber                 | AI 還在處理時先送一則文字提示，見下表                                                                                                                                                                        |

**等待提示訊息**的欄位：

| 欄位                                              | 說明                                                                      |
| ----------------------------------------------- | ----------------------------------------------------------------------- |
| <mark style="color:blue;">啟用等待提示訊息</mark>       | 使用者傳訊息後，AI 還在處理時先送一則提示訊息                                                |
| <mark style="color:blue;">提示訊息文字</mark>         | 啟用後必填，例如「AI 處理中，請稍候...」                                                 |
| <mark style="color:blue;">首次提示延遲秒數</mark>       | 等幾秒才送出第一則提示，建議 1–3 秒；太短的話 AI 若很快回覆，提示會顯得多餘                              |
| <mark style="color:blue;">提示重複間隔秒數</mark>       | AI 仍在處理時，每隔幾秒更新一次提示文字，並附上已經過的秒數                                         |
| <mark style="color:blue;">AI 回覆後自動刪除提示訊息</mark> | AI 回覆送出後刪掉先前的提示訊息，只在支援刪除訊息的平台（Teams、Slack、Telegram）有效；Viber 的提示訊息會留在對話中 |

{% hint style="info" %}
網頁平台沒有這些開關：Web Chat 的等待體驗由 [回覆等待樣式](/build/conversation-settings/platform-settings/loading-display.md) 控制。
{% endhint %}

## 四、Hook 處理標記 <a href="#hook-markers" id="hook-markers"></a>

開啟 <mark style="color:blue;">顯示 Hook 處理標記</mark> 後，訊息經過 Hook 處理（例如敏感資訊遮蔽）時，對話中會顯示標記，標記文字可自訂。Hook 本身的設定請見 [Hook 訊息攔截](/build/hook.md)。

## 五、工具顯示模式（已移到回覆等待樣式） <a href="#tool-display-mode" id="tool-display-mode"></a>

工具顯示模式（AI 呼叫工具時，工具卡顯示完整、精簡或隱藏）在同一設定頁的 <mark style="color:blue;">回覆等待樣式</mark> → <mark style="color:blue;">調用工具時</mark> 設定，和工具執行文案、品牌動畫的「調用工具中」素材放在一起，操作方式見[回覆等待樣式：調用工具時](/build/conversation-settings/platform-settings/loading-display.md#narrative-tool-display)。

## 六、提問集選項顯示模式 <a href="#ask-option-display-mode" id="ask-option-display-mode"></a>

Agent 配置了內建的 <mark style="color:blue;">Agent UI 提問工具</mark> 後，可以在對話中向使用者「出題」：例如先問「想了解哪個主題？」並附上幾個選項，使用者點選後 Agent 再依答案往下回覆。這一區決定這些選項在 Web Chat 上怎麼呈現，兩張卡片二選一，點選後隨整頁 <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-89bc073d6c90a1c02a4292b0f0477b4ea8c904ee%2Fplatform-settings-ask-option-display-mode.png?alt=media" alt="功能設定的提問集選項顯示模式：浮動按鈕與選項面板兩張卡片並列"><figcaption><p>「提問集選項顯示模式」：兩張卡片附縮圖預覽，點選後隨整頁儲存</p></figcaption></figure>

客服主管的 Agent 在對話開頭會先請訪客選擇「產品功能」「價格方案」「技術支援」三個主題。上線後有訪客反映：「我想直接打字問問題，可是選項面板擋住了輸入框。」她打開該網頁平台的 <mark style="color:blue;">功能設定</mark>，在「提問集選項顯示模式」點選 <mark style="color:blue;">浮動按鈕</mark> 並按 <mark style="color:blue;">儲存</mark>。訪客重新開啟對話視窗後，選項改成浮在輸入框上方的按鈕列，想點選就點、想打字就打，不用再先關掉面板。

{% hint style="info" %}
預設為「選項面板」，新建與既有的平台都一樣；要改用浮動按鈕請自行切換。這個設定只影響網頁與 API 平台的 Web Chat 呈現；內部平台的測試對話固定使用選項面板，因此設定頁不會出現這一區。
{% endhint %}

### 讓 Agent 出題：角色指令範例 <a href="#ask-prompt-examples" id="ask-prompt-examples"></a>

要讓 Agent 在對話中出題，先到 <mark style="color:blue;">AI 功能</mark> → <mark style="color:blue;">AI 助理</mark> 的 <mark style="color:blue;">工具</mark> 分頁配置內建的 <mark style="color:blue;">Agent UI 提問工具</mark>。工具本身會告訴 AI 每一題有哪些欄位，角色指令只需要寫清楚三件事：**什麼時候問、問什麼、要不要開放自由輸入**。後台沒有「是否開放其他」的開關，這些都由角色指令決定、AI 每次出題時自己帶上。

每一題可用的欄位：

| 欄位             | 用途                                                 | 沒寫時    |
| -------------- | -------------------------------------------------- | ------ |
| `label`        | 題目文字                                               | 必填     |
| `options`      | 選項清單，建議 2 到 5 個                                    | 必填     |
| `multi_select` | 允許複選                                               | 單選     |
| `allow_other`  | 開放「其他」自由輸入：選項面板多一個「其他」輸入框，浮動按鈕模式則把輸入框提示字改成「輸入其他答案」 | 只能從選項挑 |
| `skippable`    | 設為 false 表示這題必答：選項面板不顯示「略過」鈕、Esc 鍵無效               | 可略過    |

**範例一：需求不明確時先釐清（單選）**

{% code title="角色指令片段" overflow="wrap" %}

```
當使用者的問題可能對應多種方案、你無法判斷該回答哪一種時，先呼叫 Agent UI 提問工具確認，不要直接猜。
例如使用者說「想了解方案」，出一題「想了解哪個方案？」，選項：入門版、專業版、企業版。
一次最多出 2 題，每題 2 到 5 個選項。收到答案後直接回答，不要再重複出同一題。
```

{% endcode %}

**範例二：開放「其他」與複選**

{% code title="角色指令片段" overflow="wrap" %}

```
詢問使用者的產業別時，選項給「金融、零售、製造」，並開放「其他」讓使用者自行輸入（allow_other 設為 true）。
詢問想了解的功能時允許複選（multi_select 設為 true），選項：知識庫、工作流、多語系、API 串接。
```

{% endcode %}

**範例三：只在對話開頭出一次**

{% code title="角色指令片段" overflow="wrap" %}

```
對話的第一則回覆先呼叫 Agent UI 提問工具問「想了解哪個主題？」，選項：產品功能、價格方案、技術支援。
之後不再主動出題，除非使用者說「重新選擇」。
```

{% endcode %}

**範例四：必答題（不可略過）**

{% code title="角色指令片段" overflow="wrap" %}

```
測驗的每一題都必須作答（skippable 設為 false）。
如果使用者沒有點選選項、而是直接打字或關閉題目，請用一句話說明這題必須作答，然後重新出同一題。
```

{% endcode %}

{% hint style="warning" %}
`skippable: false` 只影響選項面板的「略過」鈕與 Esc 鍵。使用者仍然可以按 ✕ 關閉面板；浮動按鈕模式沒有略過鈕，直接打字就等於忽略選項。所以「必答」要成立，角色指令一定要像範例四那樣寫明「沒作答就重新出題」，由 Agent 把關。
{% endhint %}

AI 依上述指令產生的題目長這樣（由 AI 自動組成，供對照用，不需要寫進角色指令）：

{% code title="範例二的第一題" %}

```json
{ "id": "industry", "label": "您的產業別？", "options": ["金融", "零售", "製造"], "allow_other": true }
```

{% endcode %}

使用者作答後，Web Chat 會以「Q: 題目」「A: 答案」的格式送出，複選以「、」相接，自由輸入的「其他」答案也走同一格式。角色指令若要依答案分流，就用這個格式判斷。

{% hint style="warning" %}
不要在角色指令或題目文字裡寫「按略過」「關閉面板」：浮動按鈕模式沒有這兩個按鈕。使用者直接打字送出就代表忽略選項；題目有開 `allow_other` 時，打字送出的內容會當作「其他」答案。
{% endhint %}

## 七、AI 感知設定 <a href="#ai-awareness" id="ai-awareness"></a>

AI 感知設定讓 Agent 在回答時知道「現在幾點」「在跟誰說話」「對方在哪裡」。開啟後，系統會在每一次回覆前，自動把對應資訊補進 AI 的上下文，您不需要修改角色指令、也不需要另外串接工具。三個開關各平台獨立設定。<mark style="color:blue;">使用系統時間回答</mark> 在新建立的對話平台預設為開啟（包含建立 Agent 時自動產生的網頁、內部、API 平台，以及從「串接對話平台」新增的 LINE、Messenger 等所有通路），不需要就在建立表單或設定頁關閉；既有平台維持原本的設定。<mark style="color:blue;">使用傳送者名稱回答</mark> 與 <mark style="color:blue;">使用位置資訊回答</mark> 預設為關閉。

| 開關            | AI 會知道什麼       | 適合的情境                          | 哪些平台有          |
| ------------- | -------------- | ------------------------------ | -------------- |
| **使用系統時間回答**  | 目前的日期、時間、星期與時區 | 「今天幾號」「現在幾點」「現在還有營業嗎」「三天後是星期幾」 | 所有平台           |
| **使用傳送者名稱回答** | 對方的名稱          | 用名字稱呼客戶、個人化問候                  | 所有平台           |
| **使用位置資訊回答**  | 使用者分享的座標       | 「離我最近的門市」「這附近有沒有服務據點」          | 網頁、內部、API、LINE |

### 使用系統時間回答 <a href="#system-time" id="system-time"></a>

捲到 <mark style="color:blue;">AI 感知設定</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-e98c22467e67fcfedfdefa0ca159f3038d031e37%2Fplatform-settings-ai-awareness-web.png?alt=media" alt="網頁平台的 AI 感知設定，開啟使用系統時間回答後顯示「自動時間偵測」提示"><figcaption><p>網頁平台：開啟後顯示「自動時間偵測」，時區取自使用者瀏覽器</p></figcaption></figure>

API 平台與 LINE 等通訊平台開啟後，會多出 <mark style="color:blue;">時區</mark> 下拉選單，下方即時顯示該時區的 <mark style="color:blue;">目前時間</mark> 方便確認。預設為 Asia/Taipei（台北時間 UTC+8），可搜尋切換成其他時區。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-124cdad343b0272ab7d84843a4f858c16f4a29d1%2Fplatform-settings-ai-awareness-api.png?alt=media" alt="API 平台的 AI 感知設定，開啟使用系統時間回答後顯示時區下拉選單與目前時間"><figcaption><p>API 平台：需手動選擇時區，下方顯示該時區的目前時間</p></figcaption></figure>

#### 時區怎麼決定 <a href="#timezone-resolution" id="timezone-resolution"></a>

注入的時間會換算成使用者所在的時區，時區來源依平台不同：

| 平台                                     | 時區來源                                                                                                       | 需不需要手動設定             |
| -------------------------------------- | ---------------------------------------------------------------------------------------------------------- | -------------------- |
| 網頁、內部                                  | 自動取使用者瀏覽器的時區，每則訊息隨附                                                                                        | 不需要，畫面會顯示「自動時間偵測」    |
| API                                    | 呼叫端在訊息 metadata 帶 `timezone`（IANA 格式，例如 `America/New_York`）；沒帶就用平台的 <mark style="color:blue;">時區</mark> 設定 | 建議設定，作為沒帶時區時的預設值     |
| LINE、Microsoft Teams、Slack、Email 等通訊平台 | 一律使用平台的 <mark style="color:blue;">時區</mark> 設定                                                             | 需要；海外使用者為主的平台請改成對應時區 |

{% hint style="info" %}
通訊平台拿不到使用者的所在時區，所以同一個 LINE 平台服務多國使用者時，AI 只能用一個固定時區回答。若有多個地區的使用者，建議依地區分別建立平台。
{% endhint %}

API 串接時在訊息帶時區的範例：

```json
{
  "message": {
    "content": "現在幾點？",
    "metadata": { "timezone": "America/New_York" }
  }
}
```

時區字串無效時，API 會拒絕該請求並回傳驗證錯誤。

### 使用傳送者名稱回答 <a href="#sender-name" id="sender-name"></a>

開啟後 AI 會知道對方的名稱，並在合適的時候用名字稱呼。名稱取自這筆對話的聯絡人名稱，也就是 <mark style="color:blue;">客服對話</mark> → <mark style="color:blue;">聯絡人</mark> 裡看到的名稱：通訊平台由該平台的使用者顯示名稱自動建立，網頁平台則來自登入使用者或[對話前表單](/build/choose-channel/web-chat.md#pre-chat-form)填寫的資料。聯絡人沒有名稱時，AI 就照一般方式回答。

### 使用位置資訊回答 <a href="#gps-location" id="gps-location"></a>

開啟後，AI 會依使用者的座標提供在地化回答，例如推薦最近的門市。位置來源：網頁對話視窗向瀏覽器取得定位授權後隨訊息帶入；API 平台由呼叫端在訊息 metadata 帶入 `latitude`、`longitude`。目前網頁、內部、API 與 LINE 平台提供這個開關。

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

### Q：開了「使用系統時間回答」，AI 還是答錯日期？ <a href="#faq-still-wrong" id="faq-still-wrong"></a>

先確認開的是使用者實際在用的那個平台（例如問題發生在 LINE，就要開 LINE 平台的開關，不是網頁平台）。再確認通訊平台的 <mark style="color:blue;">時區</mark> 是否正確。

### Q：需要在角色指令裡加「今天是 ○月○日」嗎？ <a href="#faq-prompt" id="faq-prompt"></a>

不需要，也不建議。時間由系統每次自動帶入；在角色指令寫死日期反而會讓 AI 拿到兩個互相矛盾的日期。

### Q：AI 會不會去呼叫外部服務查時間？ <a href="#faq-external" id="faq-external"></a>

不會。時間來自平台伺服器的時鐘，換算成對應時區後直接提供給 AI，不呼叫任何外部 API。

### Q：夏令時間會自動處理嗎？ <a href="#faq-dst" id="faq-dst"></a>

會。時區用 IANA 名稱（例如 `America/New_York`）設定，夏令時間切換由系統自動換算。

### Q：這個時區和「客服轉真人設定」裡服務時間的時區一樣嗎？ <a href="#faq-service-hours" id="faq-service-hours"></a>

是兩個獨立的設定。這裡的時區給 AI 回答用；[客服轉真人設定](/build/conversation-settings/human-handoff.md)的服務時間有自己的時區，決定真人客服的上班時段怎麼判定。

### Q：關掉「工具顯示模式」的工具卡片，AI 還會用工具嗎？ <a href="#faq-tool-hidden" id="faq-tool-hidden"></a>

會。「隱藏」只是不在對話中顯示工具執行區塊，不會停用工具。工具顯示模式在[回覆等待樣式](/build/conversation-settings/platform-settings/loading-display.md#narrative-tool-display)設定。若要阻止 AI 呼叫某支工具，請到 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/build/conversation-settings/platform-settings/function-settings.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.