> 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/tech/platform-development/environments.md).

# 平台環境（SaaS/私有雲/地端）

平台環境比較：SaaS、私有雲與地端部署的隱私性、成本與擴展性差異，以及私有雲與地端的功能差異。

MaiAgent 提供多種部署環境以滿足不同客戶需求。使用公有雲的 SaaS 模式，客戶可以快速上線並以較低的初始成本享受最大可擴展性。對於需處理敏感資料的客戶，可選擇在專屬私有雲上部署，擁有高隱私性和可客製化的環境。若有更高的安全性要求，客戶可選擇地端部署，雖然部署複雜度和成本較高，但能提供最高的隱私性和配合法規限制的解決方案。

|        | **公有雲（SaaS）**                                                                             | **私有雲**                                                                                                      | **地端**                                                                                         |
| ------ | ----------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------- |
| 平台部署位置 | MaiAgent 雲端                                                                               | 客戶雲端(AWS, Azure, GCP, Oracle)                                                                                | 客戶機房                                                                                           |
| 大型語言模型 | <p><mark style="color:red;"><strong>全部模型</strong></mark></p><p>GPT 系列、Claude、Gemini 等</p> | <p><mark style="color:red;"><strong>雲端模型與自建模型</strong></mark></p><p>GPT 系列、Claude、Gemini 等（以客戶自有的雲端金鑰串接）</p> | <p>開放權重模型</p><p>gpt-oss、Gemma、Qwen 等<br><br>亦可串接 GPT 系列、Claude、Gemini 等雲端模型（需放行主機到雲端服務的連線）</p> |
| 回覆效果   | <mark style="color:red;">**最優**</mark>                                                    | <mark style="color:red;">**最優**</mark>                                                                       | 優（最優，取決於使用模型）                                                                                  |
| 部署複雜度  | 標準                                                                                        | 中                                                                                                            | 高                                                                                              |
| 初始成本   | <mark style="color:red;">**低**</mark>                                                     | 中                                                                                                            | 高                                                                                              |
| 使用成本   | 按用量                                                                                       | 按用量                                                                                                          | <mark style="color:red;">**固定**</mark>                                                         |
| 上線時間   | <mark style="color:red;">**快速**</mark>                                                    | 標準                                                                                                           | 高                                                                                              |
| 可擴展性   | <mark style="color:red;">**最高**</mark>                                                    | 高                                                                                                            | 低                                                                                              |
| 維護難度   | 標準                                                                                        | 高                                                                                                            | 最高                                                                                             |
| 隱私性    | 標準                                                                                        | 高                                                                                                            | <mark style="color:red;">**最高**</mark>                                                         |
| 適用場景   | 通用                                                                                        | 敏感資料、特定行業                                                                                                    | 高度機密、法規限制                                                                                      |
| 報價方式   | 固定價格                                                                                      | 固定價格                                                                                                         | 依專案報價                                                                                          |

## 私有雲與地端的功能差異 <a href="#private-cloud-vs-onprem-features" id="private-cloud-vs-onprem-features"></a>

私有雲與地端都用同一套部署包安裝，差別在部署時設定的部署類別：

* **私有雲**：主機可以連到雲端服務，語音 Agent、通話中心、雲端語音辨識、雲端連接器可依需要開啟。
* **地端**：視為連不到雲端服務的環境，上述四項功能一律關閉；語音轉文字改用部署在主機內的離線語音辨識。

和 SaaS 相比，私有雲與地端共通的差異：

* **版本**：私有雲與地端使用季度版（例如 `2026.Q3`），SaaS 上的新功能會在之後的季度版納入，例如 Office 線上編輯目前只在 SaaS 提供。版本與升級方式見[版本與升級](https://docs.maiagent.ai/tech/platform-development/onprem-versioning-and-upgrades.md)。
* **模型**：由客戶自建模型服務，或以客戶自有的金鑰串接雲端模型，見[地端模型服務接入](https://docs.maiagent.ai/tech/platform-development/onprem-model-services.md)。

完整的功能對照表與部署型態（Docker 單機、Docker 分散式、Kubernetes）的選擇方式，見[部署型態與功能對照](https://docs.maiagent.ai/tech/platform-development/onprem-deployment-types.md)。

## 之後能不能換環境 <a href="#switching-environments" id="switching-environments"></a>

換模型算力（雲端模型改地端模型，或反過來）不等於搬平台：模型隨時可以換（Embedding 除外，見[地端模型服務接入](https://docs.maiagent.ai/tech/platform-development/onprem-model-services.md#hybrid-cloud-setup)），平台本身要搬則依情況而定：

| 從 → 到                      | 支援程度                                                                                                                                                                     |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 私有雲 ↔ 地端（同一套部署包）           | 主機位置不影響；差別只在部署設定的部署類別，而這個類別在第一次安裝時定案，之後要改請洽 MaiAgent，見[部署型態與功能對照](https://docs.maiagent.ai/tech/platform-development/onprem-deployment-types.md#private-cloud-vs-onprem) |
| Docker 單機／分散式 → Kubernetes | 部署包提供搬遷流程：先建好 Kubernetes 叢集與資料服務，再把 PostgreSQL、上傳的檔案與搜尋索引搬過去（快取不搬），搬遷期間停機；請與 MaiAgent 排程                                                                                 |
| 換主機（同一種部署型態）               | 用內建的備份在新主機還原，見[維運重點：備份與還原](https://docs.maiagent.ai/tech/platform-development/onprem-operations.md#backup-and-restore)                                                   |
| SaaS → 私有雲或地端              | 沒有整個組織一鍵搬移的功能；技能可以匯出技能包後在新環境匯入，知識庫文件要重新上傳，Agent 設定、對話紀錄、成員帳號與對話平台串接要重新建立。範圍與作法依專案評估，請洽 MaiAgent                                                                          |
| 私有雲或地端 → SaaS              | 同上                                                                                                                                                                       |

搬遷前請先確認目標環境的功能差異（例如地端沒有語音 Agent、通話中心與雲端連接器），見[私有雲與地端的功能差異](#private-cloud-vs-onprem-features)。


---

# 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/tech/platform-development/environments.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.
