# MaiAgent ## 使用者手冊 - [概述](https://docs.maiagent.ai/readme.md): MaiAgent 使用者手冊入口：企業級 AI Agent 平台的三條產品線（Build、Serve、Work）、適用情境與從哪一頁開始讀。 - [申請帳號](https://docs.maiagent.ai/start/apply.md): 公司第一次使用 MaiAgent 的兩條路：在登入頁自助註冊、建立組織並送出申請，審核通過後開通 14 天試用；或聯絡業務規劃企業方案。說明註冊與建立組織時要填的欄位，以及「邀請碼」欄位的用途。 - [收到邀請：加入組織](https://docs.maiagent.ai/start/invitation.md): 收到公司管理員的邀請後，如何註冊或登入並加入組織：邀請信與邀請連結的差別、有效期限與重寄限制、公司使用單一登入（SSO）時的登入方式，以及屬於多個組織時如何切換。 - [如何登入平台](https://docs.maiagent.ai/start/login.md): 登入 MaiAgent 平台的三種方式：帳號密碼、使用 Google 登入、公司單一登入（SSO）。登入頁會先請你輸入公司信箱，再依信箱判斷要輸入密碼還是前往公司的登入頁；也說明登入後如何切換組織。 - [忘記密碼](https://docs.maiagent.ai/start/forget-password.md): 忘記 MaiAgent 平台密碼時，在登入頁申請重置信、從信中連結設定新密碼的步驟；以及使用公司單一登入（SSO）的帳號忘記密碼時該找誰。 - [個人帳號設定](https://docs.maiagent.ai/start/profile.md): 帳號頁的各分頁說明：個人資料與頭貼、個人偏好、我的組織、邀請管理、變更密碼、刪除帳號，以及目前組織下的 Credit 額度、API 金鑰與 AI 記憶。 - [通知中心](https://docs.maiagent.ai/start/notifications.md): 後台右上角鈴鐺的「通知中心」：系統公告與組織公告的差別、會收到哪些通知（轉真人、額度提醒、連接器已啟用等）、如何標為已讀與全部標記已讀，以及新成員看得到哪些公告。 - [系統通知與 Email](https://docs.maiagent.ai/start/system-emails.md): MaiAgent 什麼時候會寄 Email：每一種系統信的觸發條件、收件人、能不能關閉與在哪裡設定，對照通知中心的站內通知，並說明幾個容易誤會的寄信規則。 - [頂端列工具：Ask AI、支援中心與介面語言](https://docs.maiagent.ai/start/header-tools.md): 後台頂端列的 Ask AI 側邊助理能問什麼、支援中心（MaiAgent Helpdesk 工單）怎麼回報問題、後台介面語言怎麼切換與影響範圍。 - [MaiAgent Work 總覽](https://docs.maiagent.ai/work/overview.md): MaiAgent Work 是每位員工開箱即用的 AI 工作台：MaiGPT、Agent 市集、AI 會議記錄，權限依職務授權，用量與紀錄由企業統一管理。 - [MaiGPT](https://docs.maiagent.ai/work/maigpt.md): MaiGPT 是什麼：公司專屬的 AI 對話工具，像 ChatGPT 一樣對話但資料留在公司內，涵蓋 AI 對話、Canvas、Deep Research、AI 生圖、連接器等功能速覽。 - [用範本建立文件與表格](https://docs.maiagent.ai/work/maigpt/document-templates.md): 從 MaiGPT 的文件或表格範本開始，搭配知識庫、技能或資料庫建立工作草稿 - [AI 對話](https://docs.maiagent.ai/work/maigpt/chat.md): 在 MaiGPT 與 AI 對話：選擇模型、調整思考力度、從「＋」選單加入檔案、技能、工具與連接器，並搜尋、整理與分享對話。 - [對話交接](https://docs.maiagent.ai/work/maigpt/chat/conversation-handoff.md): 對話太長時，讓 Agent 整理一份交接摘要，再開一個新對話接著做，不必重新交代前情 - [AI 記憶](https://docs.maiagent.ai/work/maigpt/ai-memory.md): 查看與管理 Agent 從對話中學到的偏好與事實 - [Canvas 畫布](https://docs.maiagent.ai/work/maigpt/canvas.md): MaiGPT Canvas 畫布：AI 產出文件與圖表時的呈現區域，如何請 AI 用 Canvas 輸出、預覽與下載，以及撰寫文件與製作圖表的技巧。 - [Deep Research 深度研究](https://docs.maiagent.ai/work/maigpt/deep-research.md): 在 MaiGPT 擬定研究計畫、確認 Credits 預估與輸出形式，再閱讀研究報告 - [AI 生圖](https://docs.maiagent.ai/work/maigpt/image.md): MaiGPT AI 生圖：用中文描述畫面生成圖片、反覆編輯與迭代，以及寫好提示詞的建議。 - [AI 影片生成](https://docs.maiagent.ai/work/maigpt/video.md): 在 MaiGPT 描述影片內容、選擇畫質與比例，確認預估 Credits 後開始生成 - [AI 簡報](https://docs.maiagent.ai/work/maigpt/slides.md): 在 MaiGPT 對話中製作 AI 簡報：用範本與頁數快速開始，在簡報面板用 AI 修改單頁或元素、還原版本，並匯出 PDF／PPTX 或分享連結。 - [連接器](https://docs.maiagent.ai/work/maigpt/connectors.md): MaiGPT 連接器是什麼：連接 Notion、Slack、Google Drive、GitHub 等第三方工具（OAuth 授權），實際清單由管理員啟用，以及如何管理與解除已連接的工具。 - [管理連接器（管理員）](https://docs.maiagent.ai/work/maigpt/connectors/connectors-admin.md): 組織管理員在「MaiGPT 連接器」頁為組織啟用連接器、設定 Service Account 認證與 contextData 允許清單、查看與撤銷成員授權、處理成員的啟用申請，以及新增組織私有的 MCP 伺服器。 - [在不同裝置上使用](https://docs.maiagent.ai/work/maigpt/access.md): 在不同裝置上使用 MaiGPT：網頁版、LINE、Microsoft Teams 等支援的平台、各自適合的情境，以及對話紀錄跨裝置同步。 - [網頁版](https://docs.maiagent.ai/work/maigpt/access/web.md): MaiGPT 網頁版：用瀏覽器登入公司提供的網址開始對話，不需安裝軟體，以及建議的瀏覽器。 - [iOS App](https://docs.maiagent.ai/work/maigpt/access/ios.md): MaiGPT iOS 手機 App：在 iPhone／iPad 上使用 MaiGPT 的安裝、登入與使用教學（手機版應用程式）。 - [LINE 上使用](https://docs.maiagent.ai/work/maigpt/access/line.md): 在 LINE 上使用 MaiGPT：掃描公司官方帳號 QR Code 開始對話，LINE 上支援的功能與限制。 - [Microsoft Teams 上使用](https://docs.maiagent.ai/work/maigpt/access/teams.md): 在 Microsoft Teams 上使用 MaiGPT：在 Teams 找到 MaiGPT 應用開始對話，Teams 上支援的功能與限制。 - [常見問題](https://docs.maiagent.ai/work/maigpt/faq.md): MaiGPT 常見問題：跟 ChatGPT 的差別、要不要付費、用量與額度、模型怎麼選、資料安全等問題的快速解答。 - [用量與額度](https://docs.maiagent.ai/work/maigpt/faq/usage.md): MaiGPT 用量與額度：哪些操作會消耗 Credits、成員怎麼查看自己的額度與剩餘用量（我的額度）、節省用量的技巧。 - [模型差異怎麼選](https://docs.maiagent.ai/work/maigpt/faq/model-comparison.md): MaiGPT 模型差異怎麼選：GPT、Claude、Gemini 等常見模型家族的速度、能力與適用情境快速對照。 - [安全性與隱私](https://docs.maiagent.ai/work/maigpt/faq/security.md): MaiGPT 安全性與隱私：對話資料是否會被其他公司或用來訓練模型、誰看得到我的對話、企業資料保護與使用建議。 - [與 Agent 對話（Agent 市集）](https://docs.maiagent.ai/work/explain.md): 從後台左側選單的「Agent 市集」挑選官方內建或組織自建的 Agent 直接對話，對話只留在平台內部，不經過外部通訊軟體。適用於內部資料查詢、教育訓練等用途。 - [官方內建 Agent](https://docs.maiagent.ai/work/built-in-agents.md): 官方內建 Agent 是 MaiAgent 預先做好、上架在 Agent 市集的 Agent，組織啟用後即可直接使用，不需自行建置。 - [使用官方內建 Agent](https://docs.maiagent.ai/work/built-in-agents/use.md): 到 Agent 市集挑一個官方內建 Agent，從上傳資料、追問釐清到取得可下載的產出。 - [啟用與管理](https://docs.maiagent.ai/work/built-in-agents/management.md): 組織管理者如何啟用官方內建 Agent、設定開放對象與知識庫，以及啟用數量、冷卻期與停用的規則。 - [AI 會議記錄](https://docs.maiagent.ai/work/meeting-records.md): 會議記錄總覽：即時與離線兩種語音轉錄模式、AI 摘要與問答、下載匯出與知識庫整合、使用流程與權限說明。 - [建立會議記錄](https://docs.maiagent.ai/work/meeting-records/create-meeting.md): 建立會議記錄：建立新會議、選擇語音識別供應商（STT）、設定即時翻譯、關聯知識庫，以及管理既有會議記錄。 - [即時會議記錄](https://docs.maiagent.ai/work/meeting-records/live-transcription.md): 即時會議記錄：開會時低延遲即時轉錄與即時翻譯、轉錄畫面與操作控制、錄音結束後的處理。 - [會議記錄快捷入口](https://docs.maiagent.ai/work/meeting-records/quick-entry.md): 從 MaiGPT 首頁的「辦公應用」快捷面板開始錄音，或接續查看最近的會議記錄與摘要 - [會議記錄備援音檔](https://docs.maiagent.ai/work/meeting-records/backup-audio.md): 即時會議記錄會在瀏覽器同步錄一份本機備援音檔，斷網也不漏音；結束後可切換播放備援音檔，並用備援音檔重新轉錄補回缺漏段落。 - [離線會議記錄](https://docs.maiagent.ai/work/meeting-records/offline-transcription.md): 離線會議記錄：上傳錄音檔進行多語言高精準轉錄、語者辨識與管理、時間軸逐字稿與動態字幕播放，以及支援的音檔格式。 - [會議記錄詳情](https://docs.maiagent.ai/work/meeting-records/meeting-detail.md): 會議記錄詳情頁：標題列的編輯會議名稱、重新轉錄與下載，左側音訊播放器與會議資訊，右側逐字稿、會議摘要、AI 問答三個分頁的內容與操作。 - [會議存取權限](https://docs.maiagent.ai/work/meeting-records/access-control.md): 會議記錄的可見範圍、參與者與外部參與者名單管理，以及「會議記錄管理權限」的設定方式 - [AI 會議摘要與問答](https://docs.maiagent.ai/work/meeting-records/summary.md): AI 會議摘要與問答：用預設範本或自訂 Agent 產生摘要、摘要版本管理、複製與朗讀、針對會議內容提問，以及串接 Agent 自動開單。 - [下載與知識庫整合](https://docs.maiagent.ai/work/meeting-records/download-and-export.md): 會議記錄下載與知識庫整合：下載逐字稿、SRT 字幕與摘要檔案，一鍵複製純文字稿，並把會議內容上傳到知識庫。 - [應用實例：內部知識管理](https://docs.maiagent.ai/work/km.md): 將企業內部文件、會議記錄與各類資料整合進知識庫，打造具語意理解能力的內部 AI 知識問答 Agent - [專業知識管理](https://docs.maiagent.ai/work/km/internalkm.md): 專業知識管理應用範例：以海運產業期刊與報告建立知識庫，打造內部專業知識問答 Agent，從建立到測試的完整流程。 - [會議需求管理](https://docs.maiagent.ai/work/km/meeting.md): 會議需求管理應用範例：把會議記錄整合進知識庫，讓 Agent 回答過往決策、需求變更與會議結論，協助專案追蹤。 - [財務分析助理](https://docs.maiagent.ai/work/km/finance.md): 財務分析助理應用範例：以 Canvas 用自然語言生成營收、毛利率等互動式財務圖表，取代手動製作 Excel 報表。 - [帳單費用助理](https://docs.maiagent.ai/work/km/billing-assistant.md): 帳單費用助理應用範例：以視覺辨識讀取水電、電信等報銷憑證，依角色指令套用部門代碼與費用科目規則，並寫入 Google Sheets。 - [徵信分析助理](https://docs.maiagent.ai/work/km/credit.md): 徵信分析助理應用範例：整合徵信資料，以 Canvas 生成風險評估圖表與儀表板，加速金融機構的授信審查。 - [應用實例：影像視覺](https://docs.maiagent.ai/work/image-vision.md): 運用多模態 AI 辨識發票、公文、名片、證件等圖片，直接輸出可串接業務系統的結構化 JSON 資料 - [發票辨識](https://docs.maiagent.ai/work/image-vision/invoice-recognition.md): 發票辨識應用範例：用多模態 Agent 辨識三聯式、二聯式、電子發票與收銀機發票，擷取欄位輸出 JSON 串接 ERP 或帳務系統。 - [名片掃描](https://docs.maiagent.ai/work/image-vision/business-card-scan.md): 名片掃描應用範例：用多模態 Agent 辨識名片圖片，擷取姓名、職稱、公司、電話與 Email 並輸出結構化 JSON，可匯入 CRM。 - [證件辨識](https://docs.maiagent.ai/work/image-vision/id-card-recognition.md): 使用多模態 AI 辨識身分證等證件圖片，自動輸出結構化 JSON 資料 - [應用實例：文書與內容創作](https://docs.maiagent.ai/work/writing-assistants.md): 用角色指令打造文書與內容 Agent：翻譯、公文撰寫、存證信函草擬、廣告文案、文案診斷、SEO 健檢、教材設計與對話練習，給同仁在內部問答使用。 - [公文撰寫助理](https://docs.maiagent.ai/work/writing-assistants/official-document.md): 公文撰寫 Agent 應用實例：用 MaiAgent 建一個會寫函、簽、書函、公告、開會通知單的公文撰寫助理，含角色指令範例、公文範本知識庫、測試題與常見問題。 - [法律存證信函草擬](https://docs.maiagent.ai/work/writing-assistants/legal-attest-letter.md): 存證信函草擬 Agent 應用實例：用 MaiAgent 建一個法律存證信函撰寫助理，依寄件人、收件人、事實經過與訴求產出存證信函草稿，含角色指令範例、測試題與常見問題。 - [AI 智能翻譯](https://docs.maiagent.ai/work/writing-assistants/translation.md): AI 翻譯 Agent 應用實例：啟用官方內建的多語翻譯 Agent，或自建帶公司專有名詞對照表的翻譯助理，支援文字、文件與圖片翻譯，含角色指令範例、測試題與常見問題。 - [廣告文案與靈感發想](https://docs.maiagent.ai/work/writing-assistants/ad-copywriting.md): 廣告文案 Agent 應用實例：啟用官方內建的內容生成 Agent，或自建帶品牌語氣的廣告文案與廣告靈感助理，一次產出多個切角的標題、內文與行動呼籲，含角色指令範例、測試題與常見問題。 - [MaiAgent Serve 總覽](https://docs.maiagent.ai/serve/overview.md): MaiAgent Serve 的三種客服方案：文字客服、語音客服與客服 Copilot。一張表比較適合誰、要準備什麼、從哪一頁開始，以及建置者與客服人員各看哪裡。 - [文字客服：從零到上線](https://docs.maiagent.ai/serve/text-service.md): 文字客服從零到上線的六個步驟：建立 Agent、準備知識庫、串接對話平台、調整平台設定、設定轉真人，最後做上線檢查與品質監控。每一步連到 MaiAgent Build 的設定頁。 - [語音客服：從零到上線](https://docs.maiagent.ai/serve/voice.md): 語音客服從零到上線：確認組織已開通語音、先讓 Agent 用文字答對、開啟語音助理、在網頁試講，再接上電話線路並打一通電話驗收。每一步連到 MaiAgent Build 的設定頁。 - [客服 Copilot](https://docs.maiagent.ai/serve/copilot.md): 客服 Copilot：在對話平台啟用 AI Copilot，讓 Agent 為客戶訊息產生回覆建議，真人客服確認、修改後再送出。 - [客服人員日常](https://docs.maiagent.ai/serve/daily-operations.md): 客服人員與客服主管每天在後台做的事的入口：客服人員操作手冊、客服主管指南，以及每個日常任務對應的功能頁。 - [客服人員操作手冊](https://docs.maiagent.ai/serve/daily-operations/agent-handbook.md): 客服人員操作手冊：第一天上手、一天的工作流、對話狀態與分頁定義、常見情境的處理步驟、常見錯誤，以及可列印的檢查清單。 - [客服主管指南](https://docs.maiagent.ai/serve/daily-operations/supervisor-guide.md): 客服主管指南：每日與每週要看的事、排班與可用性、工作負載與改派、品質抽查、把答錯的問題變成 FAQ、怎麼讀對話平台分析，以及客服人員的權限配置。 - [所有對話](https://docs.maiagent.ai/serve/daily-operations/reply.md): 「所有對話」頁的導覽：如何依對話平台、分頁與篩選條件找到對話，如何介入回覆、開關單一對話的自動回覆、接手與轉回 AI，以及對話檢視、搜尋與分析的延伸頁面。 - [對話檢視器](https://docs.maiagent.ai/serve/daily-operations/reply/conversation-viewer.md): 檢視完整對話內容與詳細資訊 - [收件匣搜尋](https://docs.maiagent.ai/serve/daily-operations/reply/inbox-search.md): 快速搜尋與過濾收件匣對話 - [對話平台分析](https://docs.maiagent.ai/serve/daily-operations/reply/inbox-analysis.md): 針對單一對話平台的對話資料，使用 AI 自動分析主題分群、解決率與改善建議 - [真人客服接手與回覆](https://docs.maiagent.ai/serve/daily-operations/human-handoff-operations.md): 真人客服的日常操作：設定自己的接單狀態與排休、收到轉接通知、接手對話、回覆使用者、轉交同事、轉回 AI，以及查看使用者的滿意度回饋。 - [聯絡人](https://docs.maiagent.ai/serve/daily-operations/contact.md): 聯絡人是什麼：記錄終端客戶身分與權限的資料卡，聯絡人類型比較、如何設定、權限管理與自動化整合。 - [AI 客服品質管理](https://docs.maiagent.ai/serve/ai-quality-guide.md): AI 客服品質管理指南：看懂忠實性、回答相關性、上下文精確度三個評估指標，從評估報告找出問題並用三步驟改善角色指令與知識庫。 - [應用實例：文字客服](https://docs.maiagent.ai/serve/text.md): 以知識庫與 FAQ 打造企業對外的 AI 文字客服 Agent，串接官網與各通訊軟體，並在必要時轉接真人客服 - [法規查詢助理](https://docs.maiagent.ai/serve/text/lawsearch.md): 法規查詢助理應用範例：以公部門法規公告建立知識庫，用不同角色指令為內部人員與一般民眾設計兩種回覆方式。 - [產品查詢助理](https://docs.maiagent.ai/serve/text/productsearch.md): 產品查詢助理應用範例：以電腦廠牌產品型錄為例，從建立 Agent、上傳型錄、設定角色指令到嵌入官網 Web Chat 的完整流程。 - [應用實例：語音客服](https://docs.maiagent.ai/serve/voicecs.md): 語音客服應用總覽：從語音輸入、ASR 語音辨識到 Agent 處理的流程，涵蓋 IVR 意圖辨識、通話摘要與通話質檢三種應用。 - [IVR 客服意圖辨識](https://docs.maiagent.ai/serve/voicecs/ivr-intent-recognition.md): IVR 客服意圖辨識應用範例：客戶直接用語音說明需求，由 Agent 判斷意圖並導向對應服務，取代按鍵式語音選單。 - [語音通話摘要](https://docs.maiagent.ai/serve/voicecs/call-summary.md): 語音通話摘要應用範例：以市民陳情專線為背景，將通話轉錄後由 Agent 擷取來電者、問題與地點並產出結構化摘要。 - [語音通話質檢](https://docs.maiagent.ai/serve/voicecs/call-qa.md): 語音通話質檢應用範例：將客服通話轉錄為文字後，由 Agent 依 SOP 檢核話術、情緒與合規風險，產出質檢報告。 - [MaiAgent Build 總覽](https://docs.maiagent.ai/build/overview.md): MaiAgent Build 是建置企業自己 Agent 的平台：定義角色、知識、工具與權限，串接資料庫與企業系統，上線前有測試、上線後有監控。 - [Agent Builder](https://docs.maiagent.ai/build/agent-builder.md): Agent Builder 總覽：Agent、知識庫、資料庫、工具、技能、爬蟲、代理排程、Agent Teams、Hook 等模組的關係與建議建置順序。 - [我要做 X，該用什麼？](https://docs.maiagent.ai/build/agent-builder/decision-guide.md): 我要做 X 該用什麼模組？依需求情境對照知識庫、資料庫、工具、技能、爬蟲、代理排程、Agent Teams、Hook，以及常見的模組組合。 - [Agent](https://docs.maiagent.ai/build/agent.md): Agent 是什麼：在 MaiAgent 建立的 AI 對話角色，由回答模式、角色指令、語言模型、知識庫與工具組成，以及建立 Agent 前要先決定的事。 - [Agent 的功能](https://docs.maiagent.ai/build/agent/explain.md): Agent 的功能與用途：常見企業應用範例，以及 MaiAgent 建置 Agent 的四個階段（建立、知識庫、工具、對話平台）。 - [建立 Agent](https://docs.maiagent.ai/build/agent/setup.md): 建立 Agent 的步驟，以及 Agent 設定頁每個分頁的用途 - [用 Agent 模板庫建立 Agent](https://docs.maiagent.ai/build/agent/agent-templates.md): 從 Agent 模板庫挑一個官方模板，預覽示範對話後一鍵套用，得到一個可自由修改指令、知識庫與工具的組織自建 Agent。 - [角色指令設計指南](https://docs.maiagent.ai/build/agent/system-prompt.md): 角色指令（System Prompt）設計指南：四大支柱、實戰範本、進階技巧、長度控制與常見問題，寫出穩定可控的 AI 客服人設。 - [為 Agent 加入角色指令](https://docs.maiagent.ai/build/agent/add-system-prompt.md): 把設計好的角色指令（System Prompt）填入 Agent 設定：進入 Agent 編輯頁、貼上角色指令並儲存的操作步驟。 - [多國語言支援](https://docs.maiagent.ai/build/agent/multi-language-support.md): 多國語言支援：Web Chat 13 種介面語言、知識庫全語言內容處理、回覆語言設定方式與跨語言問答的應用場景。 - [跨對話檢索](https://docs.maiagent.ai/build/agent/cross-conversation-search.md): 讓 Agent 在同一位聯絡人的近期對話中搜尋相關內容 - [持久記憶](https://docs.maiagent.ai/build/agent/persistent-memory.md): 讓 Agent 從對話中提取事實與偏好長期保存，並在 Agent 設定頁檢視、刪除或重新啟用每一條記憶 - [知識庫標籤過濾](https://docs.maiagent.ai/build/agent/label-filter.md): 在 Agent 設定一次標籤過濾條件，讓 Agent 在所有對話平台都只參考符合標籤的檔案 - [回覆長度與 Agent 執行上限](https://docs.maiagent.ai/build/agent/custom-max-tokens.md): 設定 Agent 每次回覆的長度上限（最大輸出 Token 數），以及 Agent 模式的工具呼叫次數上限（最大迭代次數，預設 20）與執行逾時時間；說明達到工具使用上限時使用者會看到什麼。 - [代理排程](https://docs.maiagent.ai/build/agent/schedule.md): 代理排程是什麼：讓 Agent 定時自動執行任務（定時任務、主動發送通知），Cron／間隔／單次三種排程類型、執行模式與結果傳遞方式。 - [如何設定代理排程](https://docs.maiagent.ai/build/agent/schedule/schedule-setup.md): 從 0 到 1 建立一個代理排程（定時任務、主動發送通知）：選擇 Agent、撰寫提示詞、設定排程時間、配置傳遞方式。 - [Code Interpreter（程式碼執行）](https://docs.maiagent.ai/build/agent/code-interpreter.md): 程式碼執行工具（Code Interpreter）：讓 Agent 在安全沙盒中撰寫並執行 Python 程式碼——計算、分析資料、處理上傳檔案、繪製圖表、產生 Word／Excel／PowerPoint／PDF 檔案；含沙盒規格、產出檔案下載與搭配技能的說明。 - [Browser Tool（瀏覽器操作）](https://docs.maiagent.ai/build/agent/browser-tool.md): 瀏覽器操作工具（瀏覽器工具／瀏覽器自動化，即 Browser Use、Computer Use）：讓 Agent 即時開啟網頁、點擊按鈕、填寫表單、截圖判讀畫面，適合操作沒有 API、需要即時瀏覽或登入互動的網站。 - [語音助理（Voice Agent）](https://docs.maiagent.ai/build/agent/voice-agent.md): 讓 Agent 能用「聽」和「說」服務客戶，支援即時對話、STT/LLM/TTS 管線與中斷控制 - [Agent 使用分析](https://docs.maiagent.ai/build/agent/usage.md): 提供後台監測數據內容，了解使用者的資訊。 - [知識庫](https://docs.maiagent.ai/build/knowledge-base.md): 知識庫是什麼：Agent 回答企業專屬問題的資料來源，能放哪些內容（文件、FAQ、網頁），知識庫與資料庫的用途差異，以及建立步驟。 - [知識庫總覽](https://docs.maiagent.ai/build/knowledge-base/km.md): 知識庫總覽：知識庫是什麼、能做什麼（文件、FAQ、網頁內容的檢索問答），以及上傳檔案與建立知識庫的入口。 - [如何建立知識庫：基本設置](https://docs.maiagent.ai/build/knowledge-base/km-basic-settings.md): 建立知識庫的基本設置：文件解析（Parser）、切片（chunk）與檢索片段數量、相似度門檻、Embedding 模型、強制使用完整檢索範圍，以及關聯 Agent。 - [爬蟲](https://docs.maiagent.ai/build/knowledge-base/crawler.md): 爬蟲是什麼：給一個網址自動抓取網頁內容並匯入知識庫，什麼時候需要用、與知識庫的關係，以及設定前要準備什麼。 - [如何使用爬蟲（爬取資料）功能](https://docs.maiagent.ai/build/knowledge-base/scrape-website.md): 輸入網址、設定爬取範圍，選擇單次執行或定期排程，MaiAgent 就會自動爬取網頁並匯入知識庫，還能在匯入紀錄中追蹤每一次匯入結果。 - [如何建立 FAQ 常見問題](https://docs.maiagent.ai/build/knowledge-base/faq.md): 當使用者詢問敏感問題，或是您需要 100% 精準回覆的答案，可以利用 FAQ 常見問題來提供指定的回覆，適用於常見的顧客問題，且答案固定的內容。 - [文件管理：標籤及元資料](https://docs.maiagent.ai/build/knowledge-base/tags-and-metadata.md): 知識庫文件管理：用標籤分類文件與 FAQ、用元資料控制檢索範圍與參考資料權限，以及與標籤過濾、查詢元資料的關係。 - [知識庫檔案搬移](https://docs.maiagent.ai/build/knowledge-base/km-file-move.md): 將知識庫檔案搬移到同組織的另一個知識庫，檔案編號不變、不需重新解析與向量化 - [PDF 文件翻譯](https://docs.maiagent.ai/build/knowledge-base/translate-pdf.md): 使用 AI 翻譯知識庫中的 PDF 文件，產出翻譯版與雙語對照版 PDF - [搜尋測試](https://docs.maiagent.ai/build/knowledge-base/test-search-result.md): 在 LLM 正式上線前，可以先透過搜尋測試預覽功能，確認 LLM 所搜尋到的資料相關性與內容 - [資料庫](https://docs.maiagent.ai/build/database.md): 資料庫（Text to SQL）是什麼：讓 Agent 用自然語言查詢結構化數據，支援的資料庫類型、與知識庫的差異、安全性與建立步驟。 - [Text to SQL 功能](https://docs.maiagent.ai/build/database/text2sql.md): 本篇將介紹如何在 MaiAgent 系統中使用 Text to SQL 功能，協助您使用日常對話輕鬆查詢資料庫內資訊 - [建立與設定資料庫](https://docs.maiagent.ai/build/database/create-database.md): 建立資料庫問答（Text-to-SQL／Text2SQL）：上傳檔案建立資料表、連接外部資料庫，以及設定欄位描述，讓 Agent 以自然語言查詢資料。 - [MaiAgent 資料庫進行 Text to SQL](https://docs.maiagent.ai/build/database/text-to-sql-maiagent.md): 本篇將介紹如何上傳 Excel、CSV 等試算表至 MaiAgent 資料庫，讓 Agent 透過自然語言查詢與分析您的資料 - [使用 Supabase 進行 Text to SQL](https://docs.maiagent.ai/build/database/text-to-sql-supabase.md): 本文章將介紹如何在 MaiAgent 中使用 supabase 進行 Text to SQL 功能 - [關聯 Agent 與群組權限](https://docs.maiagent.ai/build/database/link-chatbots-groups.md): 本篇將介紹如何將資料庫關聯至 Agent，以及如何透過群組權限控制資料庫的存取範圍 - [工具](https://docs.maiagent.ai/build/tools.md): 工具是什麼：讓 Agent 呼叫外部服務執行動作或取得即時資訊，API 工具與 MCP 工具的類型、與技能的差異，以及建立步驟。 - [工具功能概覽](https://docs.maiagent.ai/build/tools/tool_description.md): 本篇將介紹何謂工具，工具如何協助 Agent 及 MaiAgent 支援的工具類型概覽 - [建立 MCP 工具](https://docs.maiagent.ai/build/tools/mcp-setup.md): 本指南將引導您在平台中建立新的 MCP 工具。 - [MCP 互動卡片（MCP Apps）](https://docs.maiagent.ai/build/tools/mcp-apps.md): MCP 伺服器提供的互動卡片（MCP Apps）在 Web Chat 與 MaiGPT 對話中怎麼呈現、怎麼操作、需要什麼條件、安全限制，以及適合做成互動卡片的情境與常見問題。 - [建立 API 工具](https://docs.maiagent.ai/build/tools/setup_api_tool.md): 本指南將引導您在平台中建立新的 API 工具。 - [為 Agent 配置工具](https://docs.maiagent.ai/build/tools/configure_tools.md): 為 Agent 配置工具：在 Agent 設定頁選用已建立的 API／MCP 工具、關閉不需要的系統功能，以及啟用 MaiAgent 內建工具。 - [自訂工具訊息顯示](https://docs.maiagent.ai/build/tools/tool-display-settings.md): 工具執行時對話中顯示的狀態文案（執行中、完成、失敗、沒有結果），以及如何自訂 API、MCP 與 Function 工具的文案、詳細程度與結果格式。 - [聯絡人 MCP 憑證設定](https://docs.maiagent.ai/build/tools/setup-contacts-mcp-credentials.md): 實現個人化的 MCP 工具憑證管理，確保資料安全隔離 - [內建 AI 圖像生成工具](https://docs.maiagent.ai/build/tools/ai-image-generation-guide.md): 本篇將介紹 MaiAgent 內建的 AI 圖像生成工具，並比較其效果及適用場景 - [Gemini 3 圖片生成工具](https://docs.maiagent.ai/build/tools/gemini-3-image-tool.md): 使用 Gemini 3 Pro Image 從文字提示生成高品質圖片 - [快速選單](https://docs.maiagent.ai/build/tools/quick-menu.md): 建立常駐在 Web Chat 輸入列的快速選單，讓訪客一鍵送出訊息、帶入文字或開啟連結 - [Agent UI](https://docs.maiagent.ai/build/tools/agent-ui.md): 建立 Agent UI／FlexMessage（LINE Flex Message／Flex 卡片），綁定到 Agent，讓 Web Chat 回覆以資訊卡片呈現。 - [Quick Reply](https://docs.maiagent.ai/build/tools/agent-ui/quick-reply.md): 建立 Quick Reply 快速回覆按鈕列，讓 Agent 在回覆後附上可點選的選項，引導使用者下一步 - [技能](https://docs.maiagent.ai/build/skills.md): 技能（Skill）是什麼、由哪些部分組成、Agent 如何展開技能執行多步驟流程，以及技能和工具的差異與適用情境。建立與管理方式見技能管理。 - [技能管理](https://docs.maiagent.ai/build/skills/skills-management.md): 了解如何建立、編輯與管理技能，包含手動建立、上傳技能包、附加工具與匯出功能 - [Agent Teams](https://docs.maiagent.ai/build/teams.md): Agent Teams：多 Agent 協作。把多個各有專長的 Agent 組成團隊，透過「移交」與「委派」讓一個 Agent 呼叫另一個 Agent（子 Agent）自動分工——使用者只跟一個入口對話，系統就把問題交給最合適的 Agent。 - [建立與編排團隊](https://docs.maiagent.ai/build/teams/setup.md): 建立與編排多 Agent 協作團隊：新建團隊、設定內建入口（模型、分流指令、知識庫）、在畫布拖入 Agent 節點、拉連線設定互動方式（自動／移交／委派）、升級舊版入口，到設定安全護欄（含自訂停止訊息）與開始對話的完整流程。 - [團隊執行記錄](https://docs.maiagent.ai/build/teams/traces.md): 查看團隊每一次執行的記錄——屬於哪一段對話、經過哪些 Agent、各自的 Token 用量與耗時，並可依對話篩選出同一段對話的所有執行。 - [Hook 訊息攔截](https://docs.maiagent.ai/build/hook.md): Hook 是什麼、有什麼用途：在使用者訊息進入 AI 前、AI 回覆送出前依條件自動觸發，遮罩個資（PII）、攔截敏感詞與惡意指令、把關回覆品質——系統層強制執行、不靠 AI 自律，並留下完整稽核紀錄。 - [新增與設定 Hook](https://docs.maiagent.ai/build/hook/setup.md): 從標準範本建立 Hook、調整參數（禁語清單、判斷模型、偵測服務、封鎖訊息等），並關聯到 Agent。 - [Hook 執行紀錄](https://docs.maiagent.ai/build/hook/execution-logs.md): 查看每一次 Hook 攔截或改寫的紀錄、追查附件與工具回傳的檢查來源、控制是否記錄原始訊息內容，以及從對話中追查單筆訊息的 Hook 執行詳情。 - [發布到對話平台](https://docs.maiagent.ai/build/choose-channel.md): 一張表比較 MaiAgent 可串接的全部對話平台（網站、通訊軟體、企業協作、Email），以及透過通話中心接聽的電話：適合對外客戶還是對內員工、要準備哪些憑證、主要限制，以及各平台的設定說明頁。 - [Web Chat 介紹總覽](https://docs.maiagent.ai/build/choose-channel/web-chat.md): 本篇將介紹 Web Chat 互動功能及自定義介面，讓您打造符合企業風格的 Web Chat 服務 - [串接對話平台：網站](https://docs.maiagent.ai/build/choose-channel/web-chat/website.md): 串接網站對話平台：建立 Website 對話平台、設定名稱與 Agent、自動回覆與登入設定，取得網站嵌入碼。 - [以聯絡人 Source ID 免登入對話](https://docs.maiagent.ai/build/choose-channel/web-chat/source-id-access.md): 讓您網站上已登入的使用者帶著自己的使用者編號（Source ID）直接對話，不必再登入一次。平台會依此編號對應到一位聯絡人，未經您後端簽章的請求則無法冒用任何人的身分。 - [已連接的服務](https://docs.maiagent.ai/build/choose-channel/web-chat/connected-services.md): 使用者自助管理 Agent 代自己存取的外部服務：在 Agent 市集與 Web Chat 的「已連接的服務」查看授權狀態、重新授權或解除連接，以及管理員要先做什麼。 - [引用來源顯示](https://docs.maiagent.ai/build/choose-channel/web-chat/citation-display.md): Web Chat 引用來源顯示：Agent 回答引用知識庫時如何標示出處，多語言與深色模式支援、顯示位置與管理員設定。 - [Markdown 渲染](https://docs.maiagent.ai/build/choose-channel/web-chat/markdown-rendering.md): Web Chat 訊息內容渲染：Markdown 標題、清單、表格、程式碼區塊與連結在聊天視窗的呈現方式、優化項目與管理員設定。 - [MaiGPT 視窗模式嵌入](https://docs.maiagent.ai/build/choose-channel/web-chat/maigpt-embed.md): 以 MaiGPT 視窗模式將 ChatGPT 風格的完整對話介面直接嵌入您的網站，並提供深度研究與工具選擇。 - [串接對話平台：LINE](https://docs.maiagent.ai/build/choose-channel/line.md): 串接 LINE 官方帳號：取得 Channel ID、Channel Secret 與 Channel Access Token、設定 Webhook URL，並可在 LINE 內用 LIFF 開啟 Web Chat。 - [串接對話平台：FB Messenger](https://docs.maiagent.ai/build/choose-channel/fb.md): 將 Agent 串接到 Facebook 粉絲專頁的 Messenger，前置權限、授權流程與常見問題 - [串接對話平台：Instagram](https://docs.maiagent.ai/build/choose-channel/instagram.md): 將 Agent 串接到 Instagram 專業帳號的私訊，前置條件、授權流程與常見問題 - [串接對話平台：Telegram](https://docs.maiagent.ai/build/choose-channel/connect-telegram.md): 串接 Telegram 對話平台：建立 Telegram Bot 取得 Bot Token，在 MaiAgent 新增對話平台並綁定 Agent 的步驟。 - [串接對話平台：Microsoft Teams](https://docs.maiagent.ai/build/choose-channel/teams.md): 串接 Microsoft Teams：在 Azure 建立 Bot 資源、取得 App ID 與密碼、設定 API 權限與訊息端點，並在 Teams 安裝 Bot。 - [串接對話平台：WhatsApp](https://docs.maiagent.ai/build/choose-channel/whatsapp.md): 串接 WhatsApp 對話平台：準備 Meta Business 帳號與 WhatsApp Business API 憑證，在 MaiAgent 新增對話平台並綁定 Agent。 - [串接對話平台：Email](https://docs.maiagent.ai/build/choose-channel/email.md): 串接 Email 對話平台：設定收發信帳號（Gmail 需應用程式專用密碼）、綁定 Agent，讓 Agent 自動回覆來信的步驟與限制。 - [串接對話平台：Slack](https://docs.maiagent.ai/build/choose-channel/slack.md): 串接 Slack 對話平台：用 App Manifest 建立 Slack App、設定 Bot 權限與 Event Subscriptions，讓員工在 Slack 私訊或頻道與 Agent 對話。 - [串接對話平台：LINE WORKS](https://docs.maiagent.ai/build/choose-channel/line-works.md): 串接 LINE WORKS 對話平台：在 Developer Console 建立 Client App 與 Bot、取得 Service Account 與 Bot Secret、設定 Callback URL 並啟用。 - [串接對話平台：Team+](https://docs.maiagent.ai/build/choose-channel/team-plus.md): 串接 Team+ 企業通訊平台：在 Team+ 後台啟用 API 取得憑證、在 MaiAgent 建立對話平台並填入 Webhook URL，目前只支援一對一對話。 - [串接對話平台：Viber](https://docs.maiagent.ai/build/choose-channel/viber.md): 把 Agent 串接到 Viber（Beta）：取得 Viber Bot Token、在 MaiAgent 建立 Viber 對話平台、設定歡迎訊息，以及一對一對話等使用限制。 - [從其他客服系統搬到 MaiAgent](https://docs.maiagent.ai/build/choose-channel/migrate-from-other-platform.md): LINE 官方帳號、FB 粉專、Instagram 已接在其他客服系統時，如何搬到 MaiAgent：切換時間、事前準備清單、操作順序與退回方法。 - [電話客服（通話中心）](https://docs.maiagent.ai/build/choose-channel/call-center.md): 把電話線路接上 Agent：設定 SIP 中繼與電話號碼、指定接聽的 Agent，並在通話歷史查看紀錄、掛斷進行中的通話。 - [對話與轉真人設定](https://docs.maiagent.ai/build/conversation-settings.md): Agent 發布到對話平台後的設定入口：各平台的外觀、功能與互動設定，轉真人條件與通知，AI Copilot，以及把對話事件推送到自家系統的 Webhook。 - [對話平台設定總覽](https://docs.maiagent.ai/build/conversation-settings/platform-settings.md): 對話平台設定頁的分頁地圖：怎麼進入、每個分頁管什麼、哪些平台有哪些分頁；「一般」群組的五個分類各有子頁詳細說明。 - [基本設定](https://docs.maiagent.ai/build/conversation-settings/platform-settings/basic-settings.md): 網頁對話平台的基本設定：平台名稱、綁定的 Agent、返回地址、自訂域名、允許嵌入的網域、公開訪問 URL 與三種嵌入方式，以及 API 平台的 Web Chat ID 在哪裡。 - [外觀設定](https://docs.maiagent.ai/build/conversation-settings/platform-settings/appearance-settings.md): 網頁對話視窗的外觀：品牌資產（Logo、大頭貼、技術支援 Logo、聊天按鈕圖示）、顯示設定、淺色與深色主題的顏色與效果，右側即時預覽。 - [回覆等待樣式](https://docs.maiagent.ai/build/conversation-settings/platform-settings/loading-display.md): 自訂 Web Chat 等待回覆時的顯示風格——文案敘事或品牌動畫，以及 AI 調用工具時工具卡怎麼顯示、品牌動畫播哪段素材 - [功能設定](https://docs.maiagent.ai/build/conversation-settings/platform-settings/function-settings.md): 對話平台的功能設定：基本功能、AI 互動功能、Hook 處理標記、提問集選項顯示模式，以及 AI 感知設定（使用系統時間、傳送者名稱、位置資訊回答）與時區規則。 - [互動設定](https://docs.maiagent.ai/build/conversation-settings/platform-settings/interaction-settings.md): 網頁對話視窗的互動行為：開場白、對話開始問題、開場白選項納入 Agent 上下文、對話顯示設定（延續上次對話、歷史對話列表、閒置計時器）、滿意度問卷、額度用完提示訊息。 - [客服轉真人設定](https://docs.maiagent.ai/build/conversation-settings/human-handoff.md): 讓 Agent 在需要時把對話轉接給真人客服：轉接條件、提示訊息與排隊期間體驗、服務時間、派工模式與客服可用性、內部通知的完整設定說明。 - [轉真人客服通知](https://docs.maiagent.ai/build/conversation-settings/human-handoff/handoff-notification.md): 對話被指派給真人客服時，以通知中心、Email 提醒內部人員；並在轉真人觸發、指派、轉回 AI 與排隊逾時時，以 Webhook 通知外部系統 - [對話標籤管理](https://docs.maiagent.ai/build/conversation-settings/conversation-tags.md): 在對話平台設定建立對話標籤、指派負責成員，讓客服在對話詳情貼標、依標籤篩選，並供標籤路由與對話分析使用 - [對話分析](https://docs.maiagent.ai/build/conversation-settings/conversation-analysis.md): 開啟對話平台的對話分析，讓 AI 在轉接真人時自動產生對話摘要並貼上分類標籤；設定分析模型、分析提示詞與參考訊息數 - [Webhook](https://docs.maiagent.ai/build/conversation-settings/webhook.md): Webhook 回呼整合：把對話平台上的訪客訊息與 Agent、真人客服的回覆即時推送到你自己的系統——客服系統整合、即時通知推送、對話記錄歸檔、內部流程自動化。 - [AgentOps](https://docs.maiagent.ai/build/agent-ops.md): AgentOps 提供完整的 Agent 運作管理與品質控管工具 - [測試集管理](https://docs.maiagent.ai/build/agent-ops/test-datasets.md): 建立測試資料集,系統化管理測試案例,驗證 Agent 回應品質 - [自動評估與 Agent 監控](https://docs.maiagent.ai/build/agent-ops/evaluations.md): AgentOps 自動化測試與評測：以測試案例評估回應品質，透過 Agent 監控查看效能、成本與使用者讚／倒讚回饋。 - [對話詳情與執行時間軸](https://docs.maiagent.ai/build/agent-ops/evaluations/trace-timeline.md): 在 AI 助理監控的對話詳情頁，用執行時間軸、完整對話紀錄與用量面板，查出一則回覆為什麼慢、為什麼答錯、花了多少 Credit - [評估洞察報告](https://docs.maiagent.ai/build/agent-ops/evaluation-insights.md): 評估洞察報告：批次測試完成後自動分析指標分數、歸納問題類型並產生改善建議，說明計算方式與應用場景。 - [工具執行紀錄](https://docs.maiagent.ai/build/agent-ops/tool-execution-records.md): 工具執行紀錄：追蹤 Agent 呼叫 API、資料庫、爬蟲等工具的完整歷史，查看輸入輸出與失敗原因，加速排查工具問題。 - [對話紀錄加入 FAQ](https://docs.maiagent.ai/build/agent-ops/add-to-faq.md): 在 AgentOps 對話紀錄中，把客戶實際問過的問題一鍵整理成 FAQ 存進知識庫 - [AI Gateway](https://docs.maiagent.ai/build/ai-gateway.md): 在 AI Gateway 接入組織自己的模型供應商、管理模型目錄與備援模型群組，並查看 Gateway 流量與異常。 - [應用實例：外部資料串接](https://docs.maiagent.ai/build/integrate.md): 外部資料串接 - [農業數據資料查詢](https://docs.maiagent.ai/build/integrate/farmingsearch.md): 農業數據資料查詢應用範例：以 API 工具介接農業部開放資料，讓 Agent 即時查詢農產品交易行情並回答價格與趨勢問題。 - [Google Workspace 連接器](https://docs.maiagent.ai/build/integrate/google-workspace-connector.md): 用平台內建的 Google Workspace 連接器（MCP），讓 Agent 查詢 Gmail 信件、Google 日曆行程與雲端硬碟文件 - [應用實例：Agent 優化顧問](https://docs.maiagent.ai/build/optimizer-assistant.md): 建立 Agent 優化顧問，自動診斷 AI 回答品質問題並提供 Prompt 與知識庫文件的調整建議 - [組織與成員管理](https://docs.maiagent.ai/org/overview.md): 組織、角色、成員三層結構，以及角色裡裝的三樣東西：功能權限、建立權限、資源綁定。第一次設定組織前先讀這頁。 - [組織概覽](https://docs.maiagent.ai/org/overview/organization-overview.md): 一頁掌握組織的方案、用量、已啟用功能與常用管理入口 - [組織管理](https://docs.maiagent.ai/org/overview/organization.md): 組織是什麼、一家公司該開一個還是多個組織、怎麼建立與切換組織，以及擁有者要負責的事。 - [成員管理](https://docs.maiagent.ai/org/overview/member.md): 成員管理：成員與角色的關係、Email 邀請（已有帳號直接加入）、組織邀請連結、成員列表操作、刪除成員與分配角色，以及批次新增成員、角色成員與成員 Metadata 的進階操作。 - [個人資料：自訂屬性](https://docs.maiagent.ai/org/overview/custom-attributes.md): 在個人資料中新增自訂屬性，記錄部門、職稱、分機號碼等額外資訊 - [公告管理](https://docs.maiagent.ai/org/overview/announcements.md): 公告管理：發布組織公告給全部成員或指定角色、成員，設定顯示期間、優先級、連結與多語系內容，並從列表看每則公告的狀態。 - [刪除組織](https://docs.maiagent.ai/org/overview/organization-management.md): 永久刪除整個組織與其所有資料 - [角色與權限](https://docs.maiagent.ai/org/roles.md): 角色是 MaiAgent 控制「誰看得到什麼、誰能做什麼」的單位。這一組頁面從設定到規劃，依序說明角色怎麼用。 - [角色權限管理](https://docs.maiagent.ai/org/roles/role-permission.md): 角色權限管理：角色的三種類型、建立角色、勾選功能權限、分配 AI 助理／知識庫／對話平台等資源，以及成員看不到 Agent 時的檢查表。 - [轉交他人對話權限](https://docs.maiagent.ai/org/roles/transfer-others-permission.md): 明確授權客服轉交他人正在服務的對話，並分辨自己、同事與未指派案件的操作範圍。 - [MaiGPT 角色使用權限](https://docs.maiagent.ai/org/roles/maigpt-role-permissions.md): 為不同角色設定可用的 MaiGPT 模型、工具、技能、連接器與內建功能。 - [角色資源存取權限](https://docs.maiagent.ai/org/roles/group-resource-access.md): 角色資源存取權限管理，控制成員對資源的可見性與使用權限 - [角色資源可見性控制](https://docs.maiagent.ai/org/roles/group-resource-visibility.md): 控制角色成員在資源列表中可見的項目 - [角色成員篩選](https://docs.maiagent.ai/org/roles/group-member-filtering.md): 依角色快速篩選與管理組織成員 - [角色和聯絡人的差異](https://docs.maiagent.ai/org/roles/contact-role-comparison.md): 內部成員用角色管理平台權限，跟 Agent 對話的終端使用者用聯絡人識別身分；說明兩者的定義、差異與選擇方式 - [角色權限規劃指南](https://docs.maiagent.ai/org/roles/role-design-guide.md): 當同仁會自建 Agent、而分享需要受控時，用「個人 → 部門 → 全公司」三個上架層級來規劃角色。 - [模型調用權限](https://docs.maiagent.ai/org/model-access.md): 組織擁有者可自助管理組織內可使用的 AI 模型清單，控制成員與 Agent 能調用哪些模型 - [第三方登入（SSO）](https://docs.maiagent.ai/org/sso.md): 設定企業 SSO 整合（SAML / EIP / Keycloak / Cloudflare Access），讓員工使用公司帳號登入 MaiAgent - [SAML 整合](https://docs.maiagent.ai/org/sso/sso-saml.md): 透過 SAML 2.0 協定整合 Azure AD、Okta、Google Workspace 等身分提供者 - [ADFS 整合](https://docs.maiagent.ai/org/sso/sso-saml/sso-saml-adfs.md): 透過 SAML 2.0 協定整合企業內部的 ADFS（Active Directory Federation Services） - [EIP 整合](https://docs.maiagent.ai/org/sso/sso-eip.md): 透過 EIP 整合串接企業既有的身分驗證系統，支援彈性參數傳遞與角色自動同步 - [Keycloak 整合](https://docs.maiagent.ai/org/sso/sso-keycloak.md): 透過 OpenID Connect 協定整合 Keycloak 開源身分驗證平台 - [Cloudflare Access 整合](https://docs.maiagent.ai/org/sso/sso-cloudflare-access.md): 使用 Cloudflare Zero Trust 的組織，可讓成員經 Cloudflare Access 驗證後登入 MaiAgent；說明設定欄位（Team Name、AUD Tag、電子郵件網域、自動建立成員）、登入流程與錯誤訊息。 - [身分同步（LDAP／SCIM）](https://docs.maiagent.ai/org/identity-sync.md): 設定 LDAP 或 SCIM 身分同步，自動將企業目錄服務的使用者與群組匯入 MaiAgent；LDAP 另支援以 LDAP 密碼直接登入平台 - [知識管理權限：查詢元資料](https://docs.maiagent.ai/org/querymetadata.md): 本篇將說明如何透過查詢元資料控管 Agent 可參考的資料、知識範圍。 - [開始建構—使用「查詢構建器」](https://docs.maiagent.ai/org/querymetadata/query-builder.md): 查詢構建器：以圖形化方式為聯絡人、對話訊息或 Web Chat 載入參數建立查詢元資料，限制 Agent 檢索的知識庫範圍。 - [活動日誌](https://docs.maiagent.ai/org/activity-log.md): 查看組織內誰在什麼時間新增、更新、刪除了哪些資料，以及成員的登入紀錄，並可匯出成 Excel 留存稽核。 - [開發者工具](https://docs.maiagent.ai/org/developer.md): 開發者與系統整合人員用的後台工具：API Key 管理、API 呼叫紀錄、OAuth 應用程式，以及讓 Claude、Cursor 等外部 AI 工具操作平台的 MaiAgent MCP。 - [API Key 管理](https://docs.maiagent.ai/org/developer/api-keys.md): 管理組織內所有成員的 API Key：三步驟代發金鑰、限制可用模型與 RPM／TPM、停用與撤銷、查看最後使用時間；以及成員如何在帳號頁面自行建立金鑰。 - [API 呼叫紀錄](https://docs.maiagent.ai/org/developer/api-logs.md): 查看所有透過 API 呼叫 MaiAgent 服務的完整記錄，包含請求內容、回應結果與效能數據 - [OAuth 應用程式](https://docs.maiagent.ai/org/developer/oauth-applications.md): 在組織建立 OAuth 應用程式，讓 Claude 等 MCP 客戶端用 OAuth 授權連上 MaiAgent MCP，成員不必把 API Key 貼進設定檔；含建立、重新產生 Secret、端點資訊與每組織上限。 - [安全與隱私](https://docs.maiagent.ai/org/security-and-privacy.md): 給 IT 與資安窗口的 MaiAgent 安全與隱私重點：ISO 27001／27701 認證、傳輸加密、憑證加密儲存、角色權限、SSO、活動日誌、Hook 個資遮罩，以及 Agent 監控和活動日誌各自記錄什麼。 - [試用與訂閱方案](https://docs.maiagent.ai/others/trial-and-plans.md): 瞭解試用版與各方案的差異及升級方式 — Credits 制下一份額度涵蓋所有 AI 功能。 - [Credits 計費制度](https://docs.maiagent.ai/others/credits.md): MaiAgent 平台的 Credits 點數計費制度、模型費率表與價格（定價）查詢 — 一份額度涵蓋所有 AI 功能。 - [成員 Credits 額度管理](https://docs.maiagent.ai/others/credits/member-credit-quota.md): 為每位成員設定個人 Credits 消費上限（額度）；成員可在 MaiGPT「用量與額度」查看自己的剩餘額度。 - [對話平台 Credits 額度管理](https://docs.maiagent.ai/others/credits/inbox-credit-quota.md): 為每個對話平台設定 Credits 消費上限，控管各對話平台（官網、LINE 等）的 AI 使用成本 - [三種額度怎麼算：情境範例與常見問題](https://docs.maiagent.ai/others/credits/credit-quota-scenarios.md): 成員額度、角色額度、對話平台額度三種額度怎麼算、怎麼分辨，以「業務部」實際數字一步步帶您看懂，並整理最常被問到的問題。 - [用量計算](https://docs.maiagent.ai/others/usage.md): Credits 制度下平台用量計算方式 — 一份額度同時涵蓋對話、語音、生圖、文件解析等所有 AI 功能。 - [用量統計](https://docs.maiagent.ai/others/usage-statistics.md): 組織設定「用量統計」頁的完整說明：誰可以使用與如何依角色限定只看授權 Agent、篩選條件、用量概覽與快取節省、各分頁（Agent、角色、成員、對話平台、聯絡人、語音助理、計費類別）的欄位定義、角色用量的計算方式、「未知」代表什麼，以及為什麼和額度頁的數字不同。 ## 技術人員手冊 - [歡迎來到 MaiAgent](https://docs.maiagent.ai/tech/readme.md): MaiAgent 技術人員手冊入口：給 IT、開發者與系統整合夥伴的平台部署、身分整合（SSO／SCIM／OAuth）、API 串接與 Agent 技術原理，依產品線找整合方式。 - [大型語言模型（LLM）](https://docs.maiagent.ai/tech/quickstart/llm.md): 大型語言模型（LLM）怎麼選：依環境、資料敏感度、成本與能力選擇雲端或地端模型，MaiAgent 支援的模型家族，以及是否需要 Fine-tune。 - [RAG 知識庫檢索系統](https://docs.maiagent.ai/tech/quickstart/rag.md): RAG（Retrieval-Augmented Generation，檢索增強生成）先從知識庫找出相關段落，再交給大型語言模型作答。本頁說明 MaiAgent 的資料處理與檢索流程：解析、向量化、混合檢索、Reranker、相似度門檻與標籤過濾。 - [Embedding 模型](https://docs.maiagent.ai/tech/quickstart/embedding.md): Embedding 模型在 RAG 中的角色、MaiAgent 雲端目前啟用的 Embedding 模型、地端部署的預設模型，以及自備 Embedding 服務的介面要求。 - [Reranker 模型](https://docs.maiagent.ai/tech/quickstart/reranker.md): Reranker 模型如何在檢索後重新排序段落、MaiAgent 怎麼使用 Reranker、雲端啟用中的模型、地端部署的模型與自備服務的網址規則。 - [Parser 解析工具](https://docs.maiagent.ai/tech/quickstart/parser.md): 知識庫的文件解析器與語音轉文字解析器：各解析器支援的格式、處理圖片與掃描檔的方式、能否離線運作、自動偵測的選擇規則與計費方式。 - [圖像辨識支援](https://docs.maiagent.ai/tech/quickstart/tu-xiang-bian-shi-zhi-yuan.md): 視覺語言模型（VLM）與傳統 OCR 的差異，以及 MaiAgent 在對話附件、知識庫文件與知識庫圖片檔三個地方如何處理圖片。 - [角色指令](https://docs.maiagent.ai/tech/advanced-genai-tech/system-prompt.md): Agent 每次回覆前，平台會在您寫的角色指令後面自動附加哪些情境（時間、使用者名稱、位置、語系、聯絡人與成員屬性、知識庫與技能提示等），各由哪個設定控制，以及寫角色指令時該怎麼引用。寫法與範本見使用者手冊。 - [回覆評估與監測結果](https://docs.maiagent.ai/tech/advanced-genai-tech/evaluation.md): MaiAgent 回覆評估的技術說明：Agent 監控與自動評估各用哪些指標、需要哪些資料、分數方向與測試案例的通過判定。 - [Text to SQL](https://docs.maiagent.ai/tech/advanced-genai-tech/text-to-sql.md): Text to SQL 技術規格：支援的資料庫與連線字串格式、唯讀保護、網路與帳號需求、大型 schema 的處理方式與查詢結果上限。 - [Function Calling](https://docs.maiagent.ai/tech/advanced-genai-tech/function-calling.md): Function Calling（工具呼叫）的概念，以及 MaiAgent 的 Agent 怎麼取得工具定義、平台怎麼執行工具並把結果交回模型，還有迭代次數、逾時與結果長度等限制。 - [Skill 技能模組](https://docs.maiagent.ai/tech/advanced-genai-tech/skill.md): Skill 技能模組技術說明：把任務指令、工具與資源檔封裝成 Agent 按需展開的能力單元，SKILL.md 規格、觸發條件、技能包結構與 API 端點。 - [Canvas](https://docs.maiagent.ai/tech/advanced-genai-tech/canvas.md): Canvas（畫布）的概念，以及 MaiAgent 的 Agent 如何把產出交給畫布代理、支援哪些內容類型、在哪些對話平台顯示，與相關限制。 - [AI 安全防護機制](https://docs.maiagent.ai/tech/advanced-genai-tech/guardrails.md): MaiAgent 的 AI 安全防護機制：客戶可自行設定的 Hook 訊息攔截（個資遮罩、內容安全分類等），以及由 MaiAgent 代為設定的 ICAP 內容驗證與 AWS Bedrock Guardrails，各自的作用位置與限制。 - [OAuth 2.0 整合與 Token 自動刷新機制](https://docs.maiagent.ai/tech/advanced-genai-tech/oauth-integration.md): OAuth 2.0 整合與 Token 自動刷新：MaiAgent 連接 Google Workspace、Salesforce、GitHub 等第三方服務的授權架構、refresh token 管理與最佳實踐。 - [ICAP 內容驗證整合](https://docs.maiagent.ai/tech/advanced-genai-tech/icap-content-validation.md): ICAP 內容驗證整合：以 ICAP 協定把 Web Chat 上傳的檔案轉送外部服務做病毒掃描、內容過濾與 DLP，整合架構、協定實作、掃描記錄與部署設定。 - [把 MaiGPT 加進您的系統](https://docs.maiagent.ai/tech/work/maigpt-system-integration-guide.md): 把 MaiGPT 加進您自己的系統、給組織成員使用的端到端指南：從開通成員、換發 token、前端嵌入到登出與驗收，一頁讀完照著做 - [串接 MaiGPT：選對 Agent、補齊能力](https://docs.maiagent.ai/tech/work/maigpt-system-integration-guide/maigpt-integration.md): 把 MaiGPT 串進自家系統：釐清 MaiGPT 產品與 MaiGPT 視窗模式的差別、給客戶用就自建 Agent 補齊生圖等工具、給組織成員用就以成員身分嵌入 MaiGPT 產品 - [軟體廠商整合指南：把 AI Agent 嵌給您的客戶](https://docs.maiagent.ai/tech/serve/vendor-integration-guide.md): 軟體廠商將 Web Chat 嵌入自家產品並完成權限對接的端到端指南：嵌入、批次補建、登入同步、Token 刷新與登出註銷 - [Web Chat 嵌入與 SDK](https://docs.maiagent.ai/tech/serve/web-chat-sdk.md): 將 MaiAgent Web Chat 嵌入任何網站：嵌入碼、視窗模式、身分識別、完整配置參考與 JavaScript SDK API - [MaiGPT 模式嵌入](https://docs.maiagent.ai/tech/serve/web-chat-sdk/web-chat-maigpt-mode.md): 將類 ChatGPT 的 MaiGPT 完整對話介面嵌入您的網站或產品，支援指定容器與漂浮全屏兩種佈局 - [注入頁面 Context](https://docs.maiagent.ai/tech/serve/web-chat-sdk/web-chat-context-data.md): 透過 embed SDK 的 auth.contextData，把頁面 context（如商品 ID、工單編號、使用者識別碼）注入 Agent 的 LLM System Prompt - [LINE LIFF：什麼是 LINE LIFF](https://docs.maiagent.ai/tech/serve/whatislineliff.md): 什麼是 LINE LIFF（LINE Front-end Framework）：在 LINE 應用程式內嵌入網頁應用的框架，以及 MaiAgent Web Chat 用 LIFF 開啟的好處。 - [LINE LIFF：如何串接](https://docs.maiagent.ai/tech/serve/whatislineliff/setting.md): LINE LIFF 串接步驟：在 LINE Developers 建立 LIFF app、把對話平台公開網址設為 Endpoint URL，讓 Web Chat 在 LINE 聊天視窗內開啟。 - [LINE Flex Message 規格](https://docs.maiagent.ai/tech/serve/line-flex-message.md): MaiAgent 怎麼把 LINE Flex Message 卡片送出去：FlexMessage 工具的模板與 AI 欄位格式、驗證端點、回覆串流中的 flex 項目，以及送到 LINE 時的限制與失敗處理。 - [聯絡人 (Contact) 介紹及串接](https://docs.maiagent.ai/tech/serve/contacts.md): 聯絡人（Contact）介紹及串接：以 sourceId 把自家系統使用者對應到終端使用者，建立與同步聯絡人的四種方式、Excel 批次匯入與實作建議。 - [聯絡人身分同步與 Token 更新](https://docs.maiagent.ai/tech/serve/contacts/contact-credentials-sync.md): 企業系統在新增使用者與每次登入時，透過 setup-contact-credentials 同步聯絡人身分與更新 Token 憑證 - [角色(Role) 和 聯絡人(Contact) 的差異](https://docs.maiagent.ai/tech/serve/contacts/role-vs-contact.md): 內部成員用角色（Role）管理平台權限，外部使用者用聯絡人（Contact）識別身分；完整對照見使用者手冊 - [第三方客服系統串接（含轉真人）](https://docs.maiagent.ai/tech/serve/customer-service-system-integration.md): 客服系統或聊天平台以 API 接入 MaiAgent 當 AI 引擎：訊息進出、AI 判定轉真人時交由您的真人客服接手、結束後回到 AI 的端到端規格 - [Genesys Cloud 整合](https://docs.maiagent.ai/tech/serve/customer-service-system-integration/genesys-cloud-integration.md): 以 Genesys Cloud Open Messaging 串接 MaiAgent 對話平台：架構、OAuth 憑證與 API、訊息雙向流向、簽章驗證、錯誤處理與限制 - [對話交接與接續對話 API](https://docs.maiagent.ai/tech/serve/conversation-handoff-continuation.md): 以交接摘要建立接續對話，並辨識原對話與接續對話的關聯。 - [Webhook](https://docs.maiagent.ai/tech/serve/webhook.md): 對話平台 Webhook：把訪客訊息與 AI／真人回覆即時推送到您的系統，支援 MaiAgent 標準格式、Genesys Cloud 與自訂 Jinja2 範本 - [快速上手](https://docs.maiagent.ai/tech/api-integration/quickstart.md): 開始呼叫 MaiAgent 平台 API：基本網址、取得 API 金鑰的兩種方式（成員自建、管理者代發）、金鑰的權限範圍，以及第一個請求範例。 - [API 共通規範](https://docs.maiagent.ai/tech/api-integration/api-conventions.md): 呼叫 MaiAgent 平台 API 的共通規則摘要：網址與版本前綴、API Key 認證、速率限制、錯誤回應、分頁、欄位格式與上傳大小上限；正本在 API 文件 - [建立對話與訊息](https://docs.maiagent.ai/tech/api-integration/conversations-and-messages.md): 以 API 建立對話、送出訊息，再由 Webhook 接收 Agent 回覆的串接流程；欄位定義見 API 文件。 - [對話與訊息回覆（串流/同步）](https://docs.maiagent.ai/tech/api-integration/dui-hua-yu-xun-xi-hui-fu-chuan-liu-tong-bu.md): 呼叫 completions API 取得 Agent 回覆，以及串流（SSE）每個事件的欄位、reset 處理與結束條件 - [Presigned 檔案上傳模式](https://docs.maiagent.ai/tech/api-integration/api_knowledge.md): 以 Presigned URL 兩段式上傳檔案到 MaiAgent：先取得預簽網址把檔案直接送進儲存空間，再把結果註冊為知識庫檔案或對話附件。 - [使用知識庫—上傳、搜尋與管理](https://docs.maiagent.ai/tech/api-integration/knowledge-base-api.md): 用 API 上傳檔案到知識庫、以自然語言搜尋（檢索）知識庫內容並取回相關片段，以及管理知識庫檔案；附「上傳、等待解析、搜尋」的完整範例。 - [API 工具工程指南](https://docs.maiagent.ai/tech/api-integration/api-tool-engineering-guide.md): 把你的 REST API 接給 MaiAgent 的 Agent 當工具：請求怎麼組、認證怎麼帶、逾時與重試、錯誤怎麼回給模型、記錄怎麼查。 - [n8n 串接](https://docs.maiagent.ai/tech/api-integration/n8n.md): n8n 串接 MaiAgent：用 n8n 工作流自動化工具呼叫多個 Agent（多 Agent 串接），含工作流範例、多輪對話進階應用、故障排除與完整 JSON。 - [Google Sheet 串接](https://docs.maiagent.ai/tech/api-integration/google-sheet-integration.md): Google Sheet 串接：用 Google Apps Script 在試算表中呼叫 MaiAgent Agent，自訂函式批次處理多筆輸入，含完整腳本與示範影片。 - [端點行為補充](https://docs.maiagent.ai/tech/api-integration/endpoint-behaviors.md): 單一 API 端點在欄位定義之外的行為說明：可見範圍、事件語意、排序規則與相容性變更。 - [對話附件管理 API](https://docs.maiagent.ai/tech/api-integration/endpoint-behaviors/conversation-attachments.md): 使用檔案庫 API 查詢與刪除對話附件，並了解清單可見範圍與到期欄位。 - [對話產出清單 API](https://docs.maiagent.ai/tech/api-integration/endpoint-behaviors/conversation-outputs-api.md): 取得某個對話中 AI 產出的文件、圖片、影片與簡報清單。 - [對話可見權限與即時事件](https://docs.maiagent.ai/tech/api-integration/endpoint-behaviors/conversation-visibility-events.md): 說明整合端如何理解對話可見權限、即時事件與未讀數的一致性。 - [成員記憶管理 API](https://docs.maiagent.ai/tech/api-integration/endpoint-behaviors/member-memory-api.md): 說明已登入成員如何透過 API 管理自己的持久記憶。 - [站台品牌設定 API](https://docs.maiagent.ai/tech/api-integration/endpoint-behaviors/branding-api.md): 說明整合端如何依站台網域取得公開品牌顯示設定。 - [Credits 項目顯示順序](https://docs.maiagent.ai/tech/api-integration/endpoint-behaviors/credit-display-order.md): 說明 Credits 項目與交易明細在 API 回應中的顯示順序契約。 - [Agent 回答模式與結構化輸出欄位](https://docs.maiagent.ai/tech/api-integration/endpoint-behaviors/chatbot-reply-mode-api.md): Agent 的回答模式（replyMode）與後台名稱的對照，以及結構化輸出欄位 outputMode、rawOutputFormat 的組合規則與回應形狀。 - [對話記錄的用量與 Credits 欄位](https://docs.maiagent.ai/tech/api-integration/endpoint-behaviors/chatbot-records-usage-api.md): 對話記錄 API（records）回應中 usage 與 creditCosts 的欄位意義，以及依聯絡人、Agent 與期間彙總 Credits 的做法。 - [內建工作流回覆模式退場](https://docs.maiagent.ai/tech/api-integration/endpoint-behaviors/workflow-reply-mode-retirement.md): 說明內建工作流回覆模式退場後，Agent API 串接需要調整的欄位與端點。 - [MCP（Model Context Protocol）](https://docs.maiagent.ai/tech/mcp/mcp-model-context-protocol.md): MCP（Model Context Protocol）是什麼：AI 應用連接外部工具與資料來源的開放協定，運作原理、核心價值，以及在 MaiAgent 用 MCP 工具接 MCP Server。 - [MaiAgent MCP：讓外部 AI 工具操作平台](https://docs.maiagent.ai/tech/mcp/maiagent-mcp.md): 讓 Claude、Cursor 等支援 MCP 的 AI 工具透過 MaiAgent MCP 操作平台：服務端點與提供的工具、API Key 與 OAuth 兩種連法、驗證與疑難排解 - [自架 MCP Server 接入規格](https://docs.maiagent.ai/tech/mcp/self-hosted-mcp-server.md): 把自家系統做成 MCP Server 讓 MaiAgent 的 Agent 呼叫：支援的傳輸方式與 URL 要求、驗證（固定標頭、聯絡人憑證、OAuth 動態註冊）、允許的工具、逾時重試與錯誤如何回給模型，以及 MCP Apps 互動卡片。 - [Remote MCP 服務概述](https://docs.maiagent.ai/tech/mcp/remote-mcp.md): Remote MCP（遠端 MCP 服務）的概念，以及 MaiAgent 怎麼連線 Composio、Zapier 等託管服務與自架的 MCP 伺服器：傳輸方式、驗證、工具範圍、逾時與紀錄，和使用時的注意事項。 - [Composio 串接](https://docs.maiagent.ai/tech/mcp/composio.md): Composio 串接：從 Composio MCP 目錄取得 MCP Server URL、連接第三方帳號，並在 MaiAgent 建立 MCP 工具供 Agent 使用。 - [Zapier 串接](https://docs.maiagent.ai/tech/mcp/zapier.md): Zapier MCP 串接：在 Zapier MCP 控制台建立 MCP Server、選擇開放給 AI 的動作（Actions）、複製 endpoint，並在 MaiAgent 建立 MCP 工具。 - [AI Gateway：OpenAI 相容 API 串接](https://docs.maiagent.ai/tech/ai-gateway/ai-gateway-openai-compatible.md): 用 OpenAI SDK 不改程式邏輯串接 MaiAgent AI Gateway：端點與 base URL、Bearer 認證、模型識別（別名、自建模型、備援群組）、思考等級、串流、語音轉文字與文字轉語音、錯誤格式、Credits 計費與限制。 - [AI Gateway 安全性](https://docs.maiagent.ai/tech/ai-gateway/ai-gateway-security.md): 從「AI 中轉站」事件看企業使用多模型的真正風險，以及 MaiAgent AI Gateway 在來源、模型、資料、責任、紀錄五個面向提供的保障與目前的限制。 - [成員開通：SCIM／邀請／SSO](https://docs.maiagent.ai/tech/identity-and-access/member-provisioning.md): 讓您的人員成為 MaiAgent 組織成員的三條路：SCIM 開通 API（適合客戶 IT 與 ISV 代管）、後台邀請、SSO 登入自動開通；以及與 MaiGPT 成員身分嵌入的銜接 - [即時同步：在使用者事件中呼叫](https://docs.maiagent.ai/tech/identity-and-access/member-provisioning/member-event-sync.md): 您的產品是 Web 服務時，在新增／修改／停用使用者的事件中即時呼叫 SCIM，讓 MaiAgent 組織成員與您的系統隨時一致；附可直接引用的 client 與接法 - [名單同步工具：CSV／JSON／資料庫](https://docs.maiagent.ai/tech/identity-and-access/member-provisioning/member-roster-sync.md): 沒有 IdP 也能自動開通成員：一支現成的名單同步工具，吃 CSV、JSON 或從資料庫匯出的名單，透過 SCIM 建立、更新、停用組織成員，可排程執行 - [SSO 與身分整合總覽](https://docs.maiagent.ai/tech/identity-and-access/sso-overview.md): MaiAgent 支援的登入與身分整合方式總覽：內建帳號、SAML、EIP、Keycloak、Cloudflare Access、LDAP 帳密登入與 Google 帳號登入，各自的適用情境、設定入口，以及和成員開通的搭配 - [SAML SSO 單一登入整合](https://docs.maiagent.ai/tech/identity-and-access/sso-overview/saml-sso.md): SAML SSO 單一登入整合：IdP 與 SP 的架構、Email 正規化、帳號自動建立與衝突處理、配置步驟、限制與疑難排解。 - [MaiAgent 作為 OAuth 授權伺服器](https://docs.maiagent.ai/tech/identity-and-access/maiagent-oauth-server.md): 讓 Claude 等 MCP 客戶端以 OAuth 2.1（授權碼＋PKCE）連線 MaiAgent MCP：端點、應用程式註冊、Redirect URI、權杖效期與輪替，以及 scope 的實際作用 - [知識管理權限(Query Metadata / 查詢元資料) 總覽](https://docs.maiagent.ai/tech/identity-and-access/zhi-shi-guan-li-quan-xian-query-metadata-cha-xun-yuan-zi-liao-zong-lan.md): 透過 Query Metadata（查詢元資料）控管 Agent 可檢索的知識範圍，詳細設定方式見「開始建構」子頁 - [開始建構—使用 JSON 格式](https://docs.maiagent.ai/tech/identity-and-access/zhi-shi-guan-li-quan-xian-query-metadata-cha-xun-yuan-zi-liao-zong-lan/json-interfaces.md): 若您想要撰寫更複雜的篩選條件，可使用 JSON 格式直接以各層級 (如知識庫、單一文件等) ID 指定 - [概覽](https://docs.maiagent.ai/tech/platform-development/gai-lan.md): 平台部署概覽：MaiAgent 平台本身不需 GPU，模型服務可用雲端 API 推論或地端自建 GPU，SaaS、私有雲、地端與混合雲的部署環境。 - [平台環境（SaaS/私有雲/地端）](https://docs.maiagent.ai/tech/platform-development/environments.md): 平台環境比較：SaaS、私有雲與地端部署的隱私性、成本與擴展性差異，以及私有雲與地端的功能差異。 - [部署架構](https://docs.maiagent.ai/tech/platform-development/architecture.md): MaiAgent 部署架構：一體式與分散式部署的差異、服務元件與資料流，以及部署包的 Docker 單機／Docker 分散式／Kubernetes 三種部署型態。 - [部署型態與功能對照](https://docs.maiagent.ai/tech/platform-development/onprem-deployment-types.md): 私有雲與地端部署的三種部署型態（Docker 單機、Docker 分散式、Kubernetes）怎麼選，以及 SaaS、私有雲、地端的功能可用性對照 - [系統需求](https://docs.maiagent.ai/tech/platform-development/system-requirements.md): 私有雲與地端部署的主機需求：CPU、記憶體、磁碟、作業系統、對外與內部連線埠、依服務人數的建議規格，以及 GPU 節點的驅動與運算能力需求 - [版本與升級](https://docs.maiagent.ai/tech/platform-development/onprem-versioning-and-upgrades.md): 私有雲與地端的季度版（2026.Qn）怎麼編號、同季更新與跨季升級的流程摘要、預估停機時間、退版限制，以及地端功能為什麼會晚於 SaaS - [地端模型服務接入](https://docs.maiagent.ai/tech/platform-development/onprem-model-services.md): 私有雲與地端部署怎麼接模型：部署包內建的本機模型目錄（vLLM）、接既有的 OpenAI 相容模型服務（含網址 /v1 規則）、雲端模型自備金鑰，以及自備 Embedding 與 Reranker 的限制 - [維運重點：離線安裝、TLS、備份、監控與驗收](https://docs.maiagent.ai/tech/platform-development/onprem-operations.md): 私有雲與地端部署的維運重點：離線（air-gap）安裝、網域與 TLS 憑證、備份與還原、監控（選配）與部署後驗收，各項的重點與注意事項 - [自帶向量資料庫](https://docs.maiagent.ai/tech/platform-development/bring-your-own-vector-db.md): 建立知識庫時改用組織自有的向量資料庫：支援的類型、要填的欄位、版本與網路需求，以及建立後的限制 - [雲端模型推論 API 服務](https://docs.maiagent.ai/tech/platform-development/cloud-model-inference-api-service.md): 雲端模型推論 API 服務：LLM、Embedding、Reranker 各自支援的供應商（OpenAI、Azure、AWS Bedrock、Google Vertex AI 等）與模型家族對照。 - [GPU 算力硬體規劃](https://docs.maiagent.ai/tech/platform-development/gpu.md): GPU 算力硬體規劃：私有雲或地端自建 LLM、Embedding、Reranker 或離線語音辨識時，各模型建議的 GPU 與 VRAM、硬體配置與 NVIDIA 驅動需求。 - [檔案庫 Office 線上編輯（ONLYOFFICE Docs 整合）](https://docs.maiagent.ai/tech/platform-development/onlyoffice-online-editing.md): 檔案庫 Office 線上編輯（ONLYOFFICE Docs）的網路連線方向與使用條件，供客戶網管規劃防火牆與網域白名單。目前僅 SaaS 提供。 ## API 文件 - [總覽說明](https://docs.maiagent.ai/api/preparation/readme.md) - [API 認證](https://docs.maiagent.ai/api/preparation/authentication.md): 本篇將介紹在使用 MaiAgent API 時的身分驗證方法及取得方式 - [API 共通規範](https://docs.maiagent.ai/api/preparation/conventions.md): 呼叫 MaiAgent 平台 API 的共通規則：網址與版本前綴、API Key 認證、速率限制、錯誤回應與狀態碼、分頁、欄位格式與上傳大小上限 - [狀態碼](https://docs.maiagent.ai/api/preparation/status-code.md): 本篇將介紹使用 API 串接 MaiAgent 服務時，不同狀態下會回傳的 HTTP 代碼與回傳格式範例 - [轉真人 Webhook 事件](https://docs.maiagent.ai/api/preparation/handoff-webhook.md): 對話轉真人的生命週期（AI 判定轉真人、指派給客服、轉回 AI、排隊逾時）以 Webhook 推送到你指定的系統端點，本篇說明事件種類與格式、簽章驗證與重試行為 - [客戶端工具（Client Tools）](https://docs.maiagent.ai/api/preparation/client-tools.md): 讓 AI 助理呼叫由你的應用程式自行執行的工具（例如查詢只在內網可達的系統）：如何在對話 API 宣告客戶端工具、辨識模型的呼叫要求、把執行結果送回並讓模型繼續完成任務 - [訊息 Webhook](https://docs.maiagent.ai/api/preparation/message-webhook.md): 對話平台每收到一則客戶訊息、或每送出一則回覆，MaiAgent 都可以把該則訊息推送到你指定的網址。本篇說明 Incoming／Outgoing 的差別、後台與 API 設定方式、推送內容、來源驗證，以及失敗時不重試的行為 - [偵測新訊息](https://docs.maiagent.ai/api/preparation/detect-new-messages.md): 要讓自己的系統得知對話有新訊息（例如顯示通知、提醒真人客服），本篇說明建議做法：優先用 Webhook 推送；需要輪詢時只讀有更新的對話、每段對話只讀第一頁 - [AI 助理](https://docs.maiagent.ai/api/api-reference/ai-zhu-li.md) - [附件與檔案](https://docs.maiagent.ai/api/api-reference/fu-jian-he-dang-an.md) - [知識庫（新版）](https://docs.maiagent.ai/api/api-reference/zhi-shi-ku-xin-ban.md) - [知識庫（舊版）](https://docs.maiagent.ai/api/api-reference/zhi-shi-ku-jiu-ban.md) - [對話與訊息](https://docs.maiagent.ai/api/api-reference/dui-hua-he-xun-xi.md) - [對話 Widget](https://docs.maiagent.ai/api/api-reference/dui-hua-widget.md) - [對話平台](https://docs.maiagent.ai/api/api-reference/dui-hua-ping-tai.md) - [組織與成員](https://docs.maiagent.ai/api/api-reference/zu-zhi-he-cheng-yuan.md) - [角色與權限](https://docs.maiagent.ai/api/api-reference/jue-se-he-quan-xian.md) - [聯絡人](https://docs.maiagent.ai/api/api-reference/lian-luo-ren.md) - [工具與連接器](https://docs.maiagent.ai/api/api-reference/gong-ju-he-lian-jie-qi.md) - [技能](https://docs.maiagent.ai/api/api-reference/ji-neng.md) - [資料庫](https://docs.maiagent.ai/api/api-reference/zi-liao-ku.md) - [評估與測試集](https://docs.maiagent.ai/api/api-reference/ping-gu-he-ce-shi-ji.md) - [Credit](https://docs.maiagent.ai/api/api-reference/credit.md) - [AI Gateway](https://docs.maiagent.ai/api/api-reference/ai-gateway.md) - [SCIM](https://docs.maiagent.ai/api/api-reference/scim.md) - [會議記錄](https://docs.maiagent.ai/api/api-reference/hui-yi-ji-lu.md) ## 更新日誌 - [更新日誌](https://docs.maiagent.ai/release-note/readme.md): MaiAgent 平台更新及新功能上線說明 - [2026 年](https://docs.maiagent.ai/release-note/archives/2026.md): MaiAgent 平台 2026 年各月份更新說明 - [2026 年 9 月](https://docs.maiagent.ai/release-note/archives/2026/09.md): MaiAgent 平台 2026 年 9 月更新說明 - [2026 年 8 月](https://docs.maiagent.ai/release-note/archives/2026/08.md): MaiAgent 平台 2026 年 8 月更新說明 - [2026 年 7 月](https://docs.maiagent.ai/release-note/archives/2026/07.md): MaiAgent 平台 2026 年 7 月更新說明 - [2026 年 6 月](https://docs.maiagent.ai/release-note/archives/2026/06.md): MaiAgent 平台 2026 年 6 月更新說明 - [2026 年 5 月](https://docs.maiagent.ai/release-note/archives/2026/05.md): MaiAgent 平台 2026 年 5 月更新說明 - [2026 年 4 月](https://docs.maiagent.ai/release-note/archives/2026/04.md): MaiAgent 平台 2026 年 4 月更新說明 - [2026 年 3 月](https://docs.maiagent.ai/release-note/archives/2026/03.md): MaiAgent 平台 2026 年 3 月更新說明 - [2026 年 2 月](https://docs.maiagent.ai/release-note/archives/2026/02.md): MaiAgent 平台 2026 年 2 月更新說明 - [2026 年 1 月](https://docs.maiagent.ai/release-note/archives/2026/01.md): MaiAgent 平台 2026 年 1 月更新說明 - [2025 年](https://docs.maiagent.ai/release-note/archives/2025.md): MaiAgent 平台 2025 年各月份更新說明 - [2025 年 11 月](https://docs.maiagent.ai/release-note/archives/2025/11.md): MaiAgent 平台 2025 年 11 月更新說明 ## License - [License](https://docs.maiagent.ai/license/readme.md): MaiAgent 私有雲與地端部署的版本政策、維運支援政策、部署環境需求，以及各季度版本的版本說明與升級說明。 - [版本政策](https://docs.maiagent.ai/license/policies/version-policy.md): MaiAgent 私有雲與地端採季度版本：發布節奏、版本命名、支援政策、每一版提供的文件，以及與雲端版的差異。 - [維運支援政策](https://docs.maiagent.ai/license/policies/support-policy.md): MaiAgent 私有雲與地端版本發布後的維運方式：季度版本、修正版與緊急更新的節奏，以及問題分級的定義。 - [部署環境需求](https://docs.maiagent.ai/license/deployment/requirements.md): 部署 MaiAgent 私有雲／地端 2026 Q3 的環境需求：主機、作業系統、網路與連接埠、網域與憑證、Kubernetes、寄信、模型服務相容性、登入方式，以及未開通服務時的系統行為。 - [版本說明](https://docs.maiagent.ai/license/id-2026-q3/release-notes.md): MaiAgent 私有雲／地端 2026 Q3 的版號、驗證範圍、需開通或另行部署的功能、不包含的項目與修正紀錄。 - [從 2026 Q2 升級](https://docs.maiagent.ai/license/id-2026-q3/upgrade-from-2026-q2.md): 從 MaiAgent 私有雲／地端 2026 Q2 升級到 2026 Q3：升級前後要配合的事、新功能、行為變更與介面變更截圖對照。 --- # 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 This site has an agentic ask interface you may use to query the documentation dynamically 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/index.md?ask=&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.