> 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/explain.md).

# 與 Agent 對話（Agent 市集）

從後台左側選單的「Agent 市集」挑選官方內建或組織自建的 Agent 直接對話，對話只留在平台內部，不經過外部通訊軟體。適用於內部資料查詢、教育訓練等用途。

左側選單的 <mark style="color:blue;">Agent 市集</mark> 是組織成員在後台直接與 Agent 對話的入口，分成兩個分頁：

* <mark style="color:blue;">官方內建</mark>：MaiAgent 預先做好、由組織啟用的 Agent，說明見 [官方內建 Agent](/work/built-in-agents.md)
* <mark style="color:blue;">組織自建</mark>：你們自己用 Agent Builder 建立的 Agent，本頁說明的就是這條路徑

市集會記住你在這個瀏覽器上次停留的分頁：下次從左側選單進入、重新整理頁面，或關掉瀏覽器再開，都會直接回到那個分頁。第一次進入、或清除瀏覽器 cookie 之後，預設顯示 <mark style="color:blue;">官方內建</mark>。例如客服主管每天都用公司自建的 Agent 回覆客訴，切到 <mark style="color:blue;">組織自建</mark> 一次之後，之後每次打開 Agent 市集就直接停在 <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-5f87d180ec98136eb334738ba84699f5d5a7fe0c%2Fmarketplace-tab-memory.png?alt=media" alt="Agent 市集頁首的官方內建與組織自建兩個分頁，目前停在組織自建"><figcaption><p>上次停在組織自建，再次進入 Agent 市集時仍停在組織自建</p></figcaption></figure>

{% hint style="info" %}
這個紀錄只存在目前的瀏覽器，不會同步到帳號；換一個瀏覽器或裝置，會從 <mark style="color:blue;">官方內建</mark> 開始。如果組織沒有 <mark style="color:blue;">官方內建</mark> 分頁，市集照常只顯示組織自建，不受紀錄影響。
{% endhint %}

## <mark style="color:blue;">Agent 市集對話介紹</mark> <a href="#internal-qa-introduction" id="internal-qa-introduction"></a>

在 Agent 市集與組織自建 Agent 對話，走的是建立 Agent 時自動產生的**內建對話平台**「內部」，不需要任何串接設定；在「所有對話」中，這些對話的來源會標示為「<mark style="color:blue;">內部</mark>」。對話只留在平台內部，不會出現在 LINE、Web Chat 等外部通路。

**💬 對話區塊**

* 與 Agent 進行即時問答互動

**📋 歷史對話紀錄**

* 查看和管理所有過往對話記錄

**🤖 Agent 選擇**

* 切換不同的 Agent 進行對話

**⚙️ Agent 設定**

* 即時調整當前對話的 Agent 設定，包含權限和工具配置
* 僅在您對該 Agent 具備編輯權限時顯示

**📚 知識庫文件管理**

* 精確控制每次對話時 Agent 可參考的文件範圍

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-dab680798dea8533d74f670d8532d0b1960b5879%2F%E6%AD%B7%E5%8F%B2%E5%B0%8D%E8%A9%B1%E7%B4%80%E9%8C%84%20(1).png?alt=media&amp;token=f9b9d449-2f0b-4ae9-b734-5cf3874e800a" alt=""><figcaption></figcaption></figure>

## <mark style="color:blue;">如何在 Agent 市集與 Agent 對話？</mark> <a href="#how-to-use-internal-qa" id="how-to-use-internal-qa"></a>

### 1. 從「Agent 市集」挑選 Agent <a href="#step-navigate-to-internal-qa" id="step-navigate-to-internal-qa"></a>

點選左側選單的「<mark style="color:blue;">Agent 市集</mark>」，切到 <mark style="color:blue;">組織自建</mark> 分頁，挑選要對話的 Agent 後即可進入對話頁。

這個分頁上還有幾個小工具：

| 位置                                                                                  | 功能                                                                                            |
| ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------- |
| 工具列 <mark style="color:blue;">搜尋 Agent 名稱或描述…</mark>                                | 依名稱或描述篩選                                                                                      |
| 工具列 <mark style="color:blue;">檢視最愛</mark>                                           | 只列出你加入最愛的 Agent                                                                               |
| 工具列 <mark style="color:blue;">Agent 管理</mark>／<mark style="color:blue;">建立助理</mark> | 前往 Agent Builder 的管理頁或直接建立新 Agent；需要有 Agent 的管理權限才會出現                                         |
| 卡片上的星號                                                                              | <mark style="color:blue;">加入最愛</mark>／<mark style="color:blue;">移除最愛</mark>。最愛會同步到你的帳號，換裝置也一樣 |
| 卡片上的工具圖示                                                                            | 滑過顯示「已掛載 N 個工具」，代表這個 Agent 配置了幾個工具                                                            |
| 卡片上的 <mark style="color:blue;">設定</mark>                                            | 開啟該 Agent 的設定頁；只有你對它有編輯權限時才顯示                                                                 |

{% hint style="info" %}
在 <mark style="color:blue;">Agent 市集</mark> 的 <mark style="color:blue;">組織自建</mark> 分頁找不到某個 Agent 時，通常是所屬角色沒有分配到它的「內部」對話平台。列出條件見 [組織自建分頁會列出哪些 Agent](/work/built-in-agents.md#self-built-tab-conditions)。
{% endhint %}

### 2. 選擇想要進行對話的 Agent <a href="#step-select-ai-agent" id="step-select-ai-agent"></a>

您可以在左上方的<mark style="color:blue;">藍色下拉選單</mark>（<mark style="color:blue;">選擇 AI 助理</mark>）中選擇想要進行對話的 Agent。展開後，上方的 <mark style="color:blue;">搜尋 AI 助理</mark> 可依名稱篩選；清單先列 <mark style="color:blue;">最近使用</mark>，再列 <mark style="color:blue;">所有 AI 助理</mark>。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-c957d44eede6799bc66f68cc9d6e630d62e500ca%2F%E6%AD%B7%E5%8F%B2%E5%B0%8D%E8%A9%B1%E7%B4%80%E9%8C%84%20(3).png?alt=media&amp;token=65f13e29-249b-488f-8bff-57374b382cbb" alt=""><figcaption></figcaption></figure>

### 3. 開始對話 <a href="#step-start-conversation" id="step-start-conversation"></a>

* **繼續過去對話**：由左側過去問答話題中選擇要接續對話的話題。
* **開啟新對話**：點選左方區塊的 「<mark style="color:blue;">新建問答</mark>」，進行一個全新的對話。

{% hint style="info" %}
所有對話都會出現在左上角問答紀錄中
{% endhint %}

選擇對話後即可在下方文字方框中輸入您的問題開始對話。

<div><figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-78e74e1e1933541d3c49ca1edbba7e46b091a7eb%2F%E6%AD%B7%E5%8F%B2%E5%B0%8D%E8%A9%B1%E7%B4%80%E9%8C%84%20(4).png?alt=media&amp;token=84986456-611d-46f5-b170-b126b9370dbd" alt=""><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-5ff73675a898bded8ad4531d8c24b2cb91cabd2c%2F%E6%AD%B7%E5%8F%B2%E5%B0%8D%E8%A9%B1%E7%B4%80%E9%8C%84%20(5).png?alt=media" alt=""><figcaption><p>開啟新對話(新建對話)</p></figcaption></figure></div>

### 4. 自訂文件參考範圍（可選） <a href="#step-customize-document-scope" id="step-customize-document-scope"></a>

使用右側的知識庫管理功能，選擇此次對話要讓 Agent 參考的具體文件。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-0cb1bd1b15171439d50e86c8c617df2f23cbb759%2F%E6%AD%B7%E5%8F%B2%E5%B0%8D%E8%A9%B1%E7%B4%80%E9%8C%84%20(6).png?alt=media&amp;token=33bd6cc6-00db-477a-81b2-f0fd0bdfeaab" alt=""><figcaption></figcaption></figure>

* 每則訊息都可以自由勾選參考文件、FAQs
* 每次傳送問答前都可以重新設定

#### **文件存取範圍** <a href="#document-access-scope" id="document-access-scope"></a>

1. 第一則訊息傳送時開放所有文件，包含「氣氛燈-系列.md」

Agent 參考後回答：「文件內容：官網已關閉，不再對外銷售任何商品」

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-030224e50ac35ffc4f9c52d1885cc0242c30fb33%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-09-12%20145435.png?alt=media&amp;token=e6e80f05-1a7c-4d7c-bfaf-df56fedede7e" alt=""><figcaption></figcaption></figure>

2. 第二則訊息傳送時取消勾選「氣氛燈-系列.md」

Agent 無法參考，並回覆：「我無法找到『**氣氛燈-系列.md』檔案的具體內容。**」

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-3c67557e56ed0e9d4272289f2e24aa8d8e75b75b%2F%E8%9E%A2%E5%B9%95%E6%93%B7%E5%8F%96%E7%95%AB%E9%9D%A2%202025-09-12%20145644.png?alt=media&amp;token=5030208f-0404-4ce2-946a-11b3f1d88eaa" alt=""><figcaption></figcaption></figure>

#### FAQs 存取範圍 <a href="#faqs-access-scope" id="faqs-access-scope"></a>

1. 第一則訊息傳送時開放所有 FAQs，包含「LLM 的運作原理是什麼？」

Agent 參考後回答相關答案

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-fb3c81acae951764f6f247d13146ceb140b4e78e%2Fimage%20(205).png?alt=media&amp;token=638e191e-d40a-40c6-87a8-e8000cd79fb5" alt=""><figcaption></figcaption></figure>

2. 第二則訊息傳送時取消勾選「LLM 的運作原理是什麼？」

Agent 無法參考「LLM 的運作原理是什麼？」，並回答「我無法找到 FAQ 中關於 LLM 運作原理的相關資訊」

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-693cb124378dbd35f5bc571b3f2b2bb8d6ebf706%2Fimage%20(206).png?alt=media&amp;token=66c97fce-ad2e-4d97-96a2-7bd2ff118884" alt=""><figcaption></figcaption></figure>

#### 標籤過濾 <a href="#tag-filter" id="tag-filter"></a>

您可以使用在知識庫中設定的標籤，篩選您想要開放給 Agent 參考的文件內容：

{% hint style="info" %}
標籤設定請參考：[文件管理：標籤及元資料](/build/knowledge-base/tags-and-metadata.md)
{% endhint %}

a. 點按右上角「顯示標籤過濾」

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-f0108aa6a16afdf9a6b32d30e94e3fb14cbb996d%2F%E6%AD%B7%E5%8F%B2%E5%B0%8D%E8%A9%B1%E7%B4%80%E9%8C%84%20(7).png?alt=media&amp;token=3b716e16-8cb6-4a5f-9d20-df32cee035ef" alt=""><figcaption></figcaption></figure>

b. 選擇判斷方式：點選「<mark style="color:blue;">包含所有標籤（AND）</mark>」或「<mark style="color:blue;">包含任一標籤（OR）</mark>」即可切換（下圖為舊版 AND／OR 按鈕，位置相同）

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-84a8b1a769ef70560fd80e037f0ce49b8d3e6757%2F%E6%AD%B7%E5%8F%B2%E5%B0%8D%E8%A9%B1%E7%B4%80%E9%8C%84%20(8).png?alt=media&amp;token=52014d1c-1d5c-4d23-a726-37bc53b694f7" alt=""><figcaption></figcaption></figure>

c. 加入標籤

* 使用「包含所有標籤（AND）」過濾
  * 文件：僅有「進階露營.pdf」符合所有條件，可供 Agent 參考
  * FAQ：沒有同時符合所有條件的 FAQ，故無顯示

{% hint style="info" %}
標籤過濾會同時套用文件及 FAQ 內容。這裡的設定只影響這段對話；若要讓 Agent 在所有對話平台都預設套用同一組條件，請在 Agent 設定頁設定 [知識庫標籤過濾](/build/agent/label-filter.md)。
{% endhint %}

<div><figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-9c96628fe6a98fa0101af21c1eb83a5dde075418%2F%E6%AD%B7%E5%8F%B2%E5%B0%8D%E8%A9%B1%E7%B4%80%E9%8C%84%20(9)%20(1)%20(1).png?alt=media&amp;token=68ef22d3-b0cb-4d9d-9279-f333f5f4b8ed" alt=""><figcaption></figcaption></figure> <figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-225b8700508b07416c9c3510c5da872f8dc619e5%2F%E6%AD%B7%E5%8F%B2%E5%B0%8D%E8%A9%B1%E7%B4%80%E9%8C%84%20(10).png?alt=media&amp;token=c35ce244-2f0a-41fb-b19d-af66aa687e1d" alt=""><figcaption></figcaption></figure></div>

### 5. 即時調整 Agent 設定（可選） <a href="#step-adjust-ai-agent-settings" id="step-adjust-ai-agent-settings"></a>

透過右上方的「<mark style="color:blue;">AI 助理設定</mark>」，可即時修改權限、工具等配置。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-c716b48211c7c4611fee1df63c193740766fa1f1%2F%E6%AD%B7%E5%8F%B2%E5%B0%8D%E8%A9%B1%E7%B4%80%E9%8C%84%20(11).png?alt=media&amp;token=c5731ff4-3345-4338-9da7-2818b12e745f" alt=""><figcaption></figcaption></figure>

點選後會跳出右側彈跳視窗，讓您自由編輯需要的權限、工具等

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-0f9b266a1fe3b62450b207a56cf57522a31acfd9%2Fimage%20(90).png?alt=media&amp;token=a6a26bdd-dd37-449c-9ab9-ae65a5662f57" alt=""><figcaption></figcaption></figure>

#### 誰看得到「AI 助理設定」按鈕 <a href="#who-sees-settings-button" id="who-sees-settings-button"></a>

這顆按鈕依「您對**當前這個 Agent**的編輯權限」顯示。沒有編輯權限時，按鈕不會出現，您仍可正常與該 Agent 進行問答。

| 您的身分                 | 按鈕是否顯示       |
| -------------------- | ------------ |
| 組織擁有者                | ✅ 一律顯示       |
| 所屬角色對該 Agent 有「允許編輯」 | ✅ 顯示         |
| 所屬角色對該 Agent 只能檢視    | ❌ 不顯示，僅能進行問答 |
| 沒有「AI 助理」功能權限        | ❌ 不顯示        |

{% hint style="info" %}
權限是**逐個 Agent**判定的。同一個人在同一頁切換不同 Agent 時，按鈕可能出現、也可能消失，這是正常的。
{% endhint %}

{% hint style="warning" %}
按鈕會等權限確認完成後才出現，切換 Agent 當下可能有短暫延遲，屬正常行為。
{% endhint %}

編輯權限由組織管理員在「<mark style="color:blue;">角色權限</mark>」的「<mark style="color:blue;">分配 AI 助理</mark>」頁籤中，逐個 Agent 勾選「<mark style="color:blue;">允許編輯</mark>」來授予。設定方式請參考 [角色資源存取權限](/org/roles/group-resource-access.md)。管理員調整後，成員重新整理頁面即生效。

{% hint style="info" %}
若您需要編輯某個 Agent 卻看不到這顆按鈕，請聯繫組織管理員為您所屬的角色開啟該 Agent 的「允許編輯」權限。
{% endhint %}

## 訊息與對話操作 <a href="#message-and-conversation-actions" id="message-and-conversation-actions"></a>

Agent 市集的對話頁與 MaiGPT 共用同一套訊息與對話操作，完整說明請見 [MaiGPT：訊息操作](/work/maigpt/chat.md#message-actions)與[整理對話](/work/maigpt/chat.md#manage-conversations)。在 Agent 市集：

* **你的訊息**：滑過後可 <mark style="color:blue;">複製</mark> 或 <mark style="color:blue;">編輯訊息</mark>；編輯會刪除之後的對話並重新回覆，編輯過的訊息可用 <mark style="color:blue;">‹ N / M ›</mark> 切換版本。
* **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> 可 <mark style="color:blue;">重新命名</mark> 或 <mark style="color:blue;">刪除對話</mark>；<mark style="color:blue;">新建問答</mark> 下方的搜尋框可依對話標題或訊息找對話，要一次清掉多則見下方[一次刪除多則對話](#sidebar-batch-delete)。釘選是 MaiGPT 專屬，這裡沒有。
* **官方內建 Agent 的對話頁**：頂部多一顆 <mark style="color:blue;">已連接的服務</mark>，用來管理 Agent 代你存取的外部服務授權，見 [已連接的服務](/build/choose-channel/web-chat/connected-services.md)。
* **語音**：Agent 開啟語音助理時，輸入列會多一顆 <mark style="color:blue;">語音互動模式</mark>，見 [語音助理：使用者端怎麼用](/build/agent/voice-agent.md#how-users-talk)。

### 一次刪除多則對話 <a href="#sidebar-batch-delete" id="sidebar-batch-delete"></a>

和 Agent 測完一輪後，左側清單常會留下好幾則測試對話。你可以在對話頁的左側清單直接勾選多則自己的對話，一次刪除。

例如，客服主管測試完新上線的服務台 Agent，左側留下三則測試對話。她想刪掉其中兩則、保留一則備查，於是按 <mark style="color:blue;">編輯</mark>、按 <mark style="color:blue;">全選</mark>，再點一下要保留的那則取消勾選，確認刪除後清單只剩那一則。她刪掉的對話裡剛好有一則正開著，畫面也自動換成新對話。

1. 在 Agent 對話頁，按 <mark style="color:blue;">新建問答</mark> 下方、搜尋框右側的鉛筆圖示 <mark style="color:blue;">編輯</mark>。進入編輯模式後，按鈕會變成勾號圖示 <mark style="color:blue;">完成</mark>。需要時可以先搜尋，再按 <mark style="color:blue;">編輯</mark>。
2. 點對話列或列首的勾選框，選取要刪除的對話；在編輯模式中點對話列只會勾選，不會打開對話。也可以按清單上方的 <mark style="color:blue;">全選</mark>，選取目前清單上已載入的對話，每次最多 100 則。右上方會顯示「已選 N 則」。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-0dd752f840a598f1682354aeb65e688edcf85f62%2Fagent-market-sidebar-batch-delete.png?alt=media" alt="Agent 對話頁左側清單進入編輯模式，勾選示範清理 A 與 B 兩則對話，上方顯示已選 2 則，底部顯示刪除（2）按鈕"><figcaption><p>勾選兩則對話後，清單底部的按鈕會顯示「刪除(2)」。</p></figcaption></figure>

3. 按清單底部的 <mark style="color:blue;">刪除</mark>，確認視窗會顯示「刪除 N 則對話？」，核對數量後按 <mark style="color:blue;">刪除</mark>。全部成功後會顯示「已刪除 N 則對話」，並離開編輯模式。

{% hint style="warning" %}
對話中的訊息會一起刪除，介面不提供復原。勾選範圍、更換搜尋關鍵字會清空勾選、部分失敗時的處理，都和 MaiGPT「所有對話」頁相同，見 [MaiGPT：一次刪除多則對話](/work/maigpt/chat.md#batch-delete-conversations)。
{% endhint %}

* 刪除的對話包含目前開著的那一則時，畫面會自動換成新對話。
* 清單裡還沒有任何對話時，不會出現 <mark style="color:blue;">編輯</mark>。
* 不想刪除時，按 <mark style="color:blue;">完成</mark> 離開編輯模式，勾選會一併清除。

## 💡 <mark style="color:blue;">使用技巧</mark> <a href="#usage-tips" id="usage-tips"></a>

### **對話管理** <a href="#conversation-management" id="conversation-management"></a>

* 善用歷史對話紀錄快速回到之前的討論
* 新建問答適合開啟全新話題
* 對話多了就重新命名，標題一看就知道在談什麼

### **文件控制精準度** <a href="#document-precision-control" id="document-precision-control"></a>

* 針對特定問題可限制參考文件，獲得更精準回答
* 避免無關文件干擾 Agent 的判斷

### **設定靈活調整** <a href="#flexible-settings-adjustment" id="flexible-settings-adjustment"></a>

* 可針對不同對話情境即時調整 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/explain.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.
