> 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/conversations/web-chat/website.md).

# 串接對話平台：網站

## <mark style="color:blue;">一、進入設定頁面</mark> <a href="#navigate-to-settings" id="navigate-to-settings"></a>

### 1. 路徑一：新增網頁客服對話 <a href="#path-add-web-chat" id="path-add-web-chat"></a>

點擊左側選單 「 <mark style="color:blue;">客服對話 > 對話平台</mark>」 ，點選右上角的 「<mark style="color:blue;">＋串接對話平台</mark>」，選擇平台 「 <mark style="color:blue;">Website</mark> 」

### 2. 路徑二：AI 助理關聯對話平台 <a href="#path-ai-agent-link-channel" id="path-ai-agent-link-channel"></a>

進入左側功能欄的 <mark style="color:blue;">AI 功能</mark> → <mark style="color:blue;">AI 助理</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-b8489ca6969c2a5473b72ee019bf07d539d1ca45%2Fai-agent-channel-platform-settings-prod.png?alt=media" alt="AI 助理的對話平台分頁，每張平台卡片都有平台設定按鈕"><figcaption><p>從 AI 助理的對話平台分頁點選「平台設定」。</p></figcaption></figure>

完成設定後，點選頁面上方的 <mark style="color:blue;">返回 AI 助理設定</mark>，即可回到原助理的 <mark style="color:blue;">對話平台</mark>分頁。在 <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-9dc1869d16658968ef1f594d157bd5045fda1b3c%2Finbox-back-to-ai-agent-settings-prod.png?alt=media" alt="對話平台設定頁上方的返回 AI 助理設定按鈕"><figcaption><p>設定完成後，可直接返回原本的 AI 助理設定頁。</p></figcaption></figure>

{% hint style="info" %}
只有從 AI 助理的 <mark style="color:blue;">對話平台</mark>分頁進入時，才會顯示 <mark style="color:blue;">返回 AI 助理設定</mark>。若是從左側選單的 <mark style="color:blue;">對話平台</mark>直接進入，頁面維持原本的導覽方式。
{% endhint %}

#### 使用情境：調整網站客服後回到助理 <a href="#scenario-return-to-agent" id="scenario-return-to-agent"></a>

客服主管要為「產品諮詢助理」更新網站客服設定。她在這隻 AI 助理的 <mark style="color:blue;">對話平台</mark>分頁點選 <mark style="color:blue;">平台設定</mark>，完成調整後點選 <mark style="color:blue;">返回 AI 助理設定</mark>，回到同一隻助理的對話平台清單，繼續檢查其他客服入口，不需要再從 AI 助理清單重新尋找。

### 3. 路徑三：對話平台操作 <a href="#path-channel-management" id="path-channel-management"></a>

左側功能欄中的 「 <mark style="color:blue;">客服對話 > 對話平台</mark> 」，選擇您想要設定之 AI 助理，點選 「 <mark style="color:blue;">操作</mark> 」 圖示即可進入對話平台配置。

## <mark style="color:blue;">二、基本設定</mark> <a href="#basic-settings" id="basic-settings"></a>

「基本」分頁裡「一般」群組的五個分類，各有專頁詳細說明：

### 1. 基本設定 <a href="#general-settings" id="general-settings"></a>

平台名稱、AI 助理、返回地址、自訂域名、允許嵌入的網域、公開訪問 URL 與三種嵌入方式，請見[基本設定](/conversations/platform-settings/basic-settings.md)。

#### 允許嵌入的網域 <a href="#allowed-embed-origins" id="allowed-embed-origins"></a>

嵌入白名單的運作方式、設定步驟與啟用前檢查清單，請見[基本設定：允許嵌入的網域](/conversations/platform-settings/basic-settings.md#allowed-embed-origins)。

### 2. 外觀設定 <a href="#appearance-settings" id="appearance-settings"></a>

Logo、大頭貼、顯示設定與淺色／深色主題配色，請見[外觀設定](/conversations/platform-settings/appearance-settings.md)。

### 3. 功能設定 <a href="#feature-settings" id="feature-settings"></a>

是否啟用、允許上傳檔案、引用文件、OCR、工具顯示模式、提問集選項顯示模式與 AI 感知設定，請見[功能設定](/conversations/platform-settings/function-settings.md)。

### 4. 互動設定 <a href="#interaction-settings" id="interaction-settings"></a>

開場白、對話開始問題、開場白選項納入 Agent 上下文、對話顯示設定、滿意度問卷與額度用完提示訊息，請見[互動設定](/conversations/platform-settings/interaction-settings.md)。

#### 開場白選項納入 Agent 上下文 <a href="#include-greeting-in-context" id="include-greeting-in-context"></a>

開啟前後差異、適用情境與注意事項，請見[互動設定：開場白選項納入 Agent 上下文](/conversations/platform-settings/interaction-settings.md#include-greeting-in-context)。

### 5. 登入設定 <a href="#login-settings" id="login-settings"></a>

**設定 SSO 登入來源**

* MaiAgent 目前支援透過 Keycloak 整合實現 SSO（Single Sign-On）服務
* 於 「 <mark style="color:blue;">登入來源</mark> 」 下拉選單中進行切換
* 選擇使用 Maiagent 或 Keycloak 作為身份驗證方式

**嵌入端免登入對話**

若您把 Web Chat 嵌入自家網站，且使用者已在您的網站登入過，可開啟 「 <mark style="color:blue;">允許嵌入端以 Source ID 免登入對話</mark> 」 讓他們直接對話。設定方式與簽章串接說明請見 [以聯絡人 Source ID 免登入對話](/conversations/web-chat/source-id-access.md)。

## <mark style="color:blue;">三、自動回覆設定</mark> <a href="#auto-reply-settings" id="auto-reply-settings"></a>

您可以在此設定機器人回覆時間段。

* 點選日期旁的開關鈕：選定一周中的哪幾天回覆。
* 設定時段：選定開始的時間與結束的時間。
* 新增時段：如果有多個時段要設定，可按下 「 <mark style="color:blue;">+新增時段</mark> 」 來新增，並設定時段。


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.maiagent.ai/conversations/web-chat/website.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
