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

# MaiAgent Build 總覽

MaiAgent Build 是建置企業自己 AI 助理的平台：定義角色、知識、工具與權限，串接資料庫與企業系統，上線前有測試、上線後有監控。

**把你的想法，建成企業級 Agent。**

MaiAgent Build 給 IT 人員與技術夥伴建置企業自己的 AI 助理：定義角色、知識、工具與權限，連接資料庫與企業系統，讓 AI 助理能查資料、呼叫系統、照流程處理事情。MaiAgent Work 與 MaiAgent Serve 使用的 AI 助理，也都在這裡建置與管理。

## 產品 <a href="#products" id="products"></a>

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Agent Builder</strong></td><td>角色指令、知識庫、資料庫、工具、技能與 Agent Teams 一次定義，用設定組出可上線的 AI 助理。</td><td><a href="/build/agent-builder.md">Agent Builder</a></td></tr><tr><td><strong>AI Gateway</strong></td><td>接入組織自己的模型供應商或自架模型，管理模型目錄與備援模型群組，並監看流量與異常。</td><td><a href="/build/ai-gateway.md">AI Gateway</a></td></tr><tr><td><strong>AgentOps 與治理</strong></td><td>測試資料集、自動評估、AI 助理監控與工具執行記錄；Hook 在訊息進出 AI 時把關個資與內容。</td><td><a href="/build/agent-ops.md">AgentOps</a></td></tr><tr><td><strong>開發者工具</strong></td><td>查詢 API 呼叫紀錄，或透過 MaiAgent MCP 讓 Claude、Cursor 等外部 AI 工具直接操作平台。</td><td><a href="/build/developer/maiagent-mcp.md">MaiAgent MCP</a></td></tr></tbody></table>

## Agent Builder 的模組 <a href="#modules" id="modules"></a>

| 模組                                                                                                                            | 讓 AI 助理能…                                                                |
| ----------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [AI 助理](/build/agent-builder/agent.md)                                                                                        | 依角色指令理解需求、產生回覆；可設定 [代理排程](/build/agent-builder/agent/schedule.md) 定時執行任務 |
| [知識庫](/build/agent-builder/knowledge-base.md)                                                                                 | 根據企業文件、FAQ 與網頁內容回答                                                       |
| [資料庫](/build/agent-builder/database.md)                                                                                       | 用自然語言查詢結構化資料（Text to SQL）                                                |
| [工具](/build/agent-builder/tools.md)                                                                                           | 透過 MCP 或 API 呼叫外部系統、執行動作                                                 |
| [技能](/build/agent-builder/skills.md)                                                                                          | 照一套多步驟流程（SOP）處理事情                                                        |
| [Code Interpreter](/build/agent-builder/agent/code-interpreter.md)、[Browser Tool](/build/agent-builder/agent/browser-tool.md) | 執行程式處理檔案，或操作瀏覽器完成網頁流程                                                    |
| [Agent Teams](/build/agent-builder/teams.md)                                                                                  | 多個專長不同的 AI 助理分工協作                                                        |
| [Hook 訊息攔截](/build/agent-builder/hook.md)                                                                                     | 在內容進入 AI 前、回覆送出前自動遮罩個資或攔截                                                |

不確定該用哪個模組，請看 [我要做 X，該用什麼？](/build/agent-builder/decision-guide.md)。

## 建置流程 <a href="#build-flow" id="build-flow"></a>

{% stepper %}
{% step %}

### 建立 AI 助理 <a href="#create-agent" id="create-agent"></a>

[建立 AI 助理](/build/agent-builder/agent/setup.md) 並撰寫 [角色指令](/build/agent-builder/agent/system-prompt.md)；也可以從 [Agent 模板庫](/build/agent-builder/agent/agent-templates.md) 套用官方模板再修改。
{% endstep %}

{% step %}

### 接上知識與能力 <a href="#connect-capabilities" id="connect-capabilities"></a>

掛上 [知識庫](/build/agent-builder/knowledge-base/km.md)，需要查資料或做事時再加上 [資料庫](/build/agent-builder/database.md)、[工具](/build/agent-builder/tools.md) 與 [技能](/build/agent-builder/skills.md)。
{% endstep %}

{% step %}

### 上線前測試 <a href="#test-before-launch" id="test-before-launch"></a>

用 [測試資料集](/build/agent-ops/test-datasets.md) 與 [自動評估](/build/agent-ops/evaluations.md) 驗證回答品質，再透過 [MaiAgent Serve](/serve/overview.md) 的通路對外上線，或給員工在 [MaiAgent Work](/work/overview.md) 使用。
{% endstep %}

{% step %}

### 上線後持續監控 <a href="#monitor-after-launch" id="monitor-after-launch"></a>

在 [AgentOps](/build/agent-ops.md) 查看回應品質、[工具執行記錄](/build/agent-ops/tool-execution-records.md)，把答不好的對話 [加入 FAQ](/build/agent-ops/add-to-faq.md) 持續改進。
{% endstep %}
{% endstepper %}

## 權限與治理 <a href="#governance" id="governance"></a>

AI 助理、知識庫與對話平台可依角色分配存取權限，組織擁有者也能限定成員與 AI 助理可調用的模型。詳見 [角色資源存取權限](/org/roles/group-resource-access.md)、[模型調用權限](/org/model-access.md) 與 [第三方登入（SSO）](/org/sso.md)；誰在什麼時間改了哪些設定，可在 [活動日誌](/org/activity-log.md) 查詢與匯出。

## 進一步整合 <a href="#further-integration" id="further-integration"></a>

以程式串接 MaiAgent 時，請看技術人員手冊與 API 文件：

* [API 快速上手](https://docs.maiagent.ai/tech/api-integration/quickstart)
* [AI Gateway：OpenAI 相容 API 串接](https://docs.maiagent.ai/tech/ai-gateway/ai-gateway-openai-compatible)
* [自架 MCP Server 接入規格](https://docs.maiagent.ai/tech/api-integration/self-hosted-mcp-server)
* [API 文件](https://docs.maiagent.ai/api)

## 應用實例 <a href="#use-cases" id="use-cases"></a>

* [外部資料串接](/build/integrate.md)：把外部 API 資料接進 AI 助理
* [AI 助理優化顧問](/build/optimizer-assistant.md)：自動診斷回答品質，提出角色指令與知識庫調整建議


---

# 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/build/overview.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.