> 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 是建置企業自己 Agent 的平台：定義角色、知識、工具與權限，串接資料庫與企業系統，上線前有測試、上線後有監控。

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

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

## 產品 <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 一次定義，用設定組出可上線的 Agent。</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>測試資料集、自動評估、Agent 監控與工具執行記錄；Hook 在訊息進出 AI 時把關個資與內容。</td><td><a href="/build/agent-ops.md">AgentOps</a></td></tr><tr><td><strong>MaiAgent MCP</strong></td><td>讓 Claude、Cursor 等外部 AI 工具透過 MCP 直接操作平台，例如建立 Agent、管理知識庫（技術人員手冊）。</td><td><a href="https://docs.maiagent.ai/tech/mcp/maiagent-mcp">https://docs.maiagent.ai/tech/mcp/maiagent-mcp</a></td></tr></tbody></table>

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

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

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

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

{% stepper %}
{% step %}

### 建立 Agent <a href="#create-agent" id="create-agent"></a>

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

{% step %}

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

掛上 [知識庫](/build/knowledge-base/km.md)，需要查資料或做事時再加上 [資料庫](/build/database.md)、[工具](/build/tools.md) 與 [技能](/build/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) 驗證回答品質，再 [發布到對話平台](/build/choose-channel.md) 對外上線，並在 [對話與轉真人設定](/build/conversation-settings.md) 調整各平台的行為；或給員工在 [MaiAgent Work](/work/overview.md) 使用。對外客服的完整上線步驟，見 [MaiAgent Serve](/serve/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>

Agent、知識庫與對話平台可依角色分配存取權限，組織擁有者也能限定成員與 Agent 可調用的模型。詳見 [角色資源存取權限](/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 Key、API 呼叫紀錄與 OAuth 應用程式見 [開發者工具](/org/developer.md)；串接方式請看技術人員手冊與 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/mcp/self-hosted-mcp-server)
* [API 文件](https://docs.maiagent.ai/api)

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

* [外部資料串接](/build/integrate.md)：把外部 API 資料接進 Agent
* [Agent 優化顧問](/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 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/overview.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.