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

# 如何登入平台

登入 MaiAgent 平台的三種方式：帳號密碼、使用 Google 登入、公司單一登入（SSO）。登入頁會先請你輸入公司信箱，再依信箱判斷要輸入密碼還是前往公司的登入頁；也說明登入後如何切換組織。

MaiAgent 平台的登入頁：<https://admin.maiagent.ai/login>

登入頁一開始只有 <mark style="color:blue;">公司信箱</mark> 一個欄位。輸入信箱後按 <mark style="color:blue;">繼續</mark>（或按 Enter），系統會依信箱的網域判斷：公司已設定單一登入（SSO）就帶你到公司的登入頁，否則展開密碼欄讓你輸入密碼。

還沒有帳號？公司第一次使用請見 [申請帳號](/start/apply.md)；收到公司管理員的邀請請見 [收到邀請：加入組織](/start/invitation.md)。

## 選擇登入方式 <a href="#login-methods" id="login-methods"></a>

| 你的帳號                                     | 登入方式                                                |
| ---------------------------------------- | --------------------------------------------------- |
| 用 Email 註冊、設有平台密碼                        | [帳號密碼](#password-login)                             |
| 想用 Google 帳號登入                           | [使用 Google 登入](#google-login)                       |
| 公司已設定 SAML 單一登入                          | [輸入公司信箱，自動前往公司登入頁](#sso-login)                      |
| 公司使用 EIP、Keycloak 或 Cloudflare Access 登入 | 使用公司提供的登入網址，見 [第三方登入（SSO）](/org/sso.md#first-login) |

## 用帳號密碼登入 <a href="#password-login" id="password-login"></a>

1. 輸入 <mark style="color:blue;">公司信箱</mark>，按 <mark style="color:blue;">繼續</mark>。
2. 信箱判定為平台帳號時，畫面會顯示「本地帳號 — 請輸入密碼登入」，並展開 <mark style="color:blue;">密碼</mark> 欄位。
3. 輸入密碼。畫面若出現人機驗證，請先完成。
4. 按 <mark style="color:blue;">登入</mark>。成功後會出現 <mark style="color:blue;">登入成功</mark> 通知，並進入平台。

{% hint style="info" %}
也可以在 <mark style="color:blue;">公司信箱</mark> 欄位一次貼上「帳號 密碼」（中間用半形空白隔開），系統會自動拆開填入兩個欄位，再按 <mark style="color:blue;">登入</mark> 即可。
{% endhint %}

輸錯帳密時的處理方式見 [出現「電子郵件或密碼錯誤」，怎麼辦？](#faq-invalid-credentials)。忘記密碼時，點登入頁下方的 <mark style="color:blue;">忘記密碼?</mark>，步驟見 [忘記密碼](/start/forget-password.md)。

## 使用 Google 登入 <a href="#google-login" id="google-login"></a>

1. 輸入你的 Google 帳號信箱，按 <mark style="color:blue;">繼續</mark>。
2. 密碼欄展開後，下方「<mark style="color:blue;">其他登入方式</mark>」分隔線下會出現 <mark style="color:blue;">使用 Google 登入</mark> 按鈕，點它。
3. 在 Google 的畫面選擇帳號並完成驗證，會回到 MaiAgent 並自動登入。

* Google 帳號的信箱與既有的 MaiAgent 帳號相同時，會登入同一個帳號。
* 還沒有 MaiAgent 帳號時，第一次用 Google 登入會自動建立帳號，登入後依 [申請帳號](/start/apply.md#first-login) 加入或建立組織。
* 登入未完成時，畫面會顯示 <mark style="color:blue;">登入失敗</mark>，可以按 <mark style="color:blue;">重試</mark> 或 <mark style="color:blue;">返回登入</mark>。失敗畫面下方的說明文字代表：

| 畫面文字          | 代表什麼                                        | 怎麼做                                                      |
| ------------- | ------------------------------------------- | -------------------------------------------------------- |
| 登入流程未完成，請重新登入 | 從 Google 回來時缺少驗證資料，常見於直接開啟書籤或中途關掉 Google 視窗 | 按 <mark style="color:blue;">返回登入</mark> 重新走一次            |
| 登入失敗，請重新登入    | Google 已驗證，但 MaiAgent 無法用這個帳號完成登入（例如帳號已被停用） | 按 <mark style="color:blue;">重試</mark>；仍失敗時改用密碼登入或聯絡組織管理員 |
| 其他英文訊息        | MaiAgent 回傳的錯誤原因，會原樣顯示                      | 把畫面截圖交給管理員                                               |

{% hint style="info" %}
信箱網域已設定公司單一登入時，按 <mark style="color:blue;">繼續</mark> 會直接前往公司的登入頁，不會出現 <mark style="color:blue;">使用 Google 登入</mark>。請改用公司帳號登入。
{% endhint %}

## 公司單一登入（SSO） <a href="#sso-login" id="sso-login"></a>

公司的管理員設定 SAML 單一登入並綁定公司信箱網域後，員工登入時不需要輸入密碼：

1. 輸入 <mark style="color:blue;">公司信箱</mark>。畫面會提示這個信箱將以單一登入驗證（例如「Acme 帳號 — 將以 Entra ID 單一登入驗證。」，Acme 為你的組織名稱），按鈕會變成 <mark style="color:blue;">前往 Acme SSO 登入</mark>（系統辨識不到組織名稱時，按鈕維持 <mark style="color:blue;">繼續</mark>）。
2. 按下按鈕，在公司的身分驗證頁完成登入。
3. 驗證成功後會回到 MaiAgent 並進入平台。第一次 SSO 登入時，系統會自動建立你的帳號。

| 畫面提示                        | 代表什麼                                                         | 怎麼做                                                                                                  |
| --------------------------- | ------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
| 此組織的單一登入暫停使用，請洽系統管理員。       | 公司的單一登入暫時停用                                                  | 密碼欄會同時展開，設過平台密碼的帳號可以用密碼登入；其他人請洽公司 IT 或組織管理員                                                          |
| 暫時無法判斷登入方式，您可以直接以密碼登入或重試。   | 系統暫時查不到這個信箱該走哪種登入                                            | 可直接輸入密碼登入，或再按一次 <mark style="color:blue;">繼續</mark> 重新判斷                                             |
| 無法完成單一登入，請重試；若持續失敗請聯絡系統管理員。 | 公司登入頁驗證失敗                                                    | 按 <mark style="color:blue;">重試</mark>；設過平台密碼的帳號可以按 <mark style="color:blue;">改用密碼登入</mark>，回到登入頁輸入密碼 |
| 登入逾時，請重新登入。                 | 公司登入頁驗證成功，但回到 MaiAgent 時一次性的登入代碼已用過或逾時，常見於重新整理了「登入中」頁面或用了舊書籤 | 按 <mark style="color:blue;">重試</mark> 重新走一次單一登入                                                      |

公司使用 Keycloak、EIP 或 Cloudflare Access 時，失敗畫面的訊息見各自的說明：[Keycloak](/org/sso/sso-keycloak.md#error-messages)、[EIP](/org/sso/sso-eip.md#error-messages)、[Cloudflare Access](/org/sso/sso-cloudflare-access.md#error-messages)。

{% hint style="info" %}
只有 SAML 類型的單一登入會在輸入信箱後自動導向。公司若使用 EIP、Keycloak 或 Cloudflare Access，請使用公司提供的登入連結。管理員設定單一登入的方式見 [第三方登入（SSO）](/org/sso.md)。
{% endhint %}

## 登入之後 <a href="#after-login" id="after-login"></a>

* **還沒有加入任何組織**：會先看到歡迎畫面，可以把資料傳給公司管理員請他邀請你，或建立新的組織申請試用，見 [申請帳號](/start/apply.md#first-login)。
* **屬於多個組織**：從左側選單最上方的下拉選單切換組織。每個組織的角色、Agent 與額度各自獨立，切換方式與釘選常用組織見 [收到邀請：加入組織](/start/invitation.md#switch-organization)。
* **調整個人資料或變更密碼**：見 [個人帳號設定](/start/profile.md)。

### 頂端工具列 <a href="#header-toolbar" id="header-toolbar"></a>

登入後畫面右上角是一列固定的工具，不受左側選單與角色權限影響：

| 項目                                        | 說明                                                                                                                                                                |
| ----------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <mark style="color:blue;">Ask AI</mark>   | 組織有啟用後台 AI 助手時才會出現，點一下在畫面右側展開對話視窗，可直接問後台怎麼操作；再點一下收起。還沒加入任何組織時會提示先建立或加入組織                                                                                          |
| <mark style="color:blue;">Cookbook</mark> | 另開分頁前往 MaiAgent Cookbook，看各種應用情境的做法與範例                                                                                                                            |
| <mark style="color:blue;">文件</mark>       | 另開分頁前往本手冊（docs.maiagent.ai）                                                                                                                                       |
| <mark style="color:blue;">支援中心</mark>     | 另開分頁前往 MaiAgent Helpdesk 支援中心回報問題或查詢工單，會以目前帳號自動登入                                                                                                                 |
| 鈴鐺圖示                                      | 通知中心：系統公告與組織公告，見 [通知中心](/start/notifications.md)                                                                                                                  |
| 語言圖示                                      | 切換後台介面語言，切換後頁面會重新載入                                                                                                                                               |
| 頭像                                        | 使用者選單：<mark style="color:blue;">帳號</mark>（個人帳號設定）、<mark style="color:blue;">切換組織</mark>、<mark style="color:blue;">創建組織</mark>、<mark style="color:blue;">登出</mark> |

{% hint style="info" %}
Cookbook 與支援中心的連結由站台設定提供，自有站台或地端部署沒有設定時不會顯示這兩個項目。
{% endhint %}

Ask AI 能問什麼、支援中心怎麼開工單、介面語言有哪幾種，見 [頂端列工具：Ask AI、支援中心與介面語言](/start/header-tools.md)。

## 常見問題 <a href="#faq" id="faq"></a>

### 出現「電子郵件或密碼錯誤」，怎麼辦？ <a href="#faq-invalid-credentials" id="faq-invalid-credentials"></a>

當你輸入帳號與密碼，若其中一項資料錯誤，密碼欄下方會跳出「電子郵件或密碼錯誤」提示與 <mark style="color:blue;">忘記密碼?</mark> 按鈕。可以依以下方式處理：

1. **重新檢查資料**：確認 <mark style="color:blue;">公司信箱</mark> 與 <mark style="color:blue;">密碼</mark> 是否輸入正確。更新任一欄位後提示將自動收起，可再次點擊 <mark style="color:blue;">登入</mark>。
2. **快速重置密碼**：若忘記密碼，直接點擊提示旁邊的 <mark style="color:blue;">忘記密碼?</mark>，系統會開啟重置表單並自動帶入剛才輸入的信箱；後續操作步驟請參閱 [忘記密碼](/start/forget-password.md)。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-c9cce108de50a2948c35d4bab9c2edb1d1f8adbd%2Flogin-credentials-error.png?alt=media" alt="密碼欄下方顯示電子郵件或密碼錯誤，旁邊有忘記密碼連結"><figcaption><p>帳密錯誤時，直接從提示旁進入重置密碼表單</p></figcaption></figure>

{% hint style="info" %}
只有帳密錯誤使用這則表單內提示。若出現其他錯誤彈窗，請依畫面原因處理；例如人機驗證未完成，重設密碼無法解決。登入頁底部原本的 <mark style="color:blue;">忘記密碼?</mark> 入口仍可使用，但不會自動帶入信箱。
{% endhint %}

### 登入後出現「無存取權限」頁面？ <a href="#faq-no-access" id="faq-no-access"></a>

這表示你的帳號在**目前所在組織**沒有任何角色給你功能權限，常見於第一次用公司單一登入進來、或剛被加入組織但管理員還沒指派角色。這是正常的安全設計，不是登入失敗。頁面上會列出 <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> → <mark style="color:blue;">組織概覽</mark> → <mark style="color:blue;">管理操作</mark> → <mark style="color:blue;">編輯成員</mark>，找到你的帳號並用 <mark style="color:blue;">編輯成員角色</mark> 指派角色，見 [成員管理](/org/overview/member.md#member-list-actions)。

### 按了「繼續」，卻被帶到公司的登入頁？ <a href="#faq-redirected-to-sso" id="faq-redirected-to-sso"></a>

你的信箱網域已設定公司單一登入，請用公司帳號在該頁完成登入。若公司的登入頁故障，而你設過平台密碼，可以在失敗畫面按 <mark style="color:blue;">改用密碼登入</mark>。

### 找不到「使用 Google 登入」按鈕？ <a href="#faq-google-button" id="faq-google-button"></a>

這個按鈕在輸入信箱、按 <mark style="color:blue;">繼續</mark>、密碼欄展開後才會出現。信箱網域已設定公司單一登入時，不會出現這個按鈕。

### 第一次登入要用哪個信箱？ <a href="#faq-which-email" id="faq-which-email"></a>

用註冊時填的 <mark style="color:blue;">公司信箱</mark>。從邀請信註冊的人，請用收到邀請信的那個信箱，見 [收到邀請：加入組織](/start/invitation.md)。

## 延伸閱讀 <a href="#further-reading" id="further-reading"></a>

* [申請帳號](/start/apply.md)
* [收到邀請：加入組織](/start/invitation.md)
* [忘記密碼](/start/forget-password.md)
* [第三方登入（SSO）](/org/sso.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/start/login.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.