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

# 收到邀請：加入組織

收到公司管理員的邀請後，如何註冊或登入並加入組織：邀請信與邀請連結的差別、有效期限與重寄限制、公司使用單一登入（SSO）時的登入方式，以及屬於多個組織時如何切換。

公司管理員把你加進 MaiAgent 組織時，你可能會收到一封邀請信、一條邀請連結，或一封請你設定密碼的開通信。本頁給**被邀請的員工**看：依你手上的東西完成註冊或登入，登入後就能使用組織開放給你的 Agent 與 MaiGPT。管理員端怎麼發出邀請，請見 [成員管理](/org/overview/member.md)。

{% hint style="info" %}
如果你**已經有 MaiAgent 帳號**，管理員用 Email 邀請你時，系統會直接把你加入組織，**不會寄信**。重新整理頁面或重新登入後，就能在組織切換選單看到新組織（見 [屬於多個組織時切換](#switch-organization)）。
{% endhint %}

## 先確認你收到的是哪一種邀請 <a href="#invitation-types" id="invitation-types"></a>

| 你收到的東西              | 代表什麼                  | 怎麼做                                                 |
| ------------------- | --------------------- | --------------------------------------------------- |
| 主旨含「邀請您加入」的信        | 管理員用 Email 邀請你，你還沒有帳號 | 點信中的連結註冊，見 [用邀請信或邀請連結註冊](#register-from-invitation) |
| 同事或公告轉給你的組織邀請連結     | 管理員產生的共用連結，多人可用同一條    | 點連結註冊，步驟同上                                          |
| 主旨含「歡迎加入，請設定您的密碼」的信 | 管理員已用名單替你建好帳號         | 點信中的連結設定密碼，見 [設定密碼後登入](#set-password)               |
| 沒收到信，但組織已出現在你的組織清單  | 你原本就有帳號，已被直接加入        | 直接切換到該組織使用                                          |

## 用邀請信或邀請連結註冊 <a href="#register-from-invitation" id="register-from-invitation"></a>

{% stepper %}
{% step %}

### 開啟邀請連結 <a href="#open-invitation-link" id="open-invitation-link"></a>

點邀請信中的連結，或直接開啟管理員分享的邀請連結。瀏覽器會打開 MaiAgent 的註冊畫面，<mark style="color:blue;">邀請碼</mark> 欄位已自動帶入。
{% endstep %}

{% step %}

### 填寫註冊資料 <a href="#fill-registration" id="fill-registration"></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> | 建議至少 9 個字元，並混用大寫字母、小寫字母、數字與特殊符號（例如 `!@#$`）；強度不足時會顯示「請輸入有效密碼」 |
| <mark style="color:blue;">邀請碼</mark>                                      | 保留自動帶入的內容，不要修改或刪除                                            |

{% hint style="warning" %}
邀請碼欄位下方的說明文字（推薦用途、不會自動加入組織）是針對**個人推薦碼**。從組織邀請連結帶入的邀請碼，註冊後會把你加入該組織；從邀請信開啟時，則是依你填的公司信箱加入。
{% endhint %}
{% endstep %}

{% step %}

### 同意條款並送出 <a href="#submit-registration" id="submit-registration"></a>

勾選「<mark style="color:blue;">我已經閱讀且同意</mark> 隱私政策 和 服務條款」後，<mark style="color:blue;">註冊</mark> 按鈕才能按。畫面若出現人機驗證，請先完成。出現 <mark style="color:blue;">註冊成功</mark> 提示後，按下提示視窗的按鈕會回到登入頁。
{% endstep %}

{% step %}

### 登入 <a href="#first-login" id="first-login"></a>

在登入頁輸入剛才的 <mark style="color:blue;">公司信箱</mark>，按 <mark style="color:blue;">繼續</mark>，再輸入密碼按 <mark style="color:blue;">登入</mark>。你會直接進入組織，並擁有管理員邀請時指定的角色權限。
{% endstep %}
{% endstepper %}

## 設定密碼後登入 <a href="#set-password" id="set-password"></a>

管理員用 Excel 名單批次加入成員時，系統會直接替還沒有帳號的人建立帳號，並寄出主旨含「歡迎加入，請設定您的密碼」的信。

1. 點信中的連結，進入設定密碼的畫面。
2. 輸入新的 <mark style="color:blue;">密碼</mark> 與 <mark style="color:blue;">確認密碼</mark>（規則同上），按 <mark style="color:blue;">重置</mark>。
3. 回到登入頁，用該信箱與新密碼登入。

設定密碼的連結有使用期限。連結失效時，在登入頁點 <mark style="color:blue;">忘記密碼?</mark>，用同一個信箱重新設定即可，見 [忘記密碼](/start/forget-password.md)。

## 邀請的有效期限 <a href="#invitation-validity" id="invitation-validity"></a>

| 邀請方式   | 何時失效                                           |
| ------ | ---------------------------------------------- |
| 邀請信    | 沒有到期日。你用該信箱註冊加入後即完成；管理員撤銷後失效                   |
| 組織邀請連結 | 到期日由管理員建立時設定（預設 7 天）。過期或被管理員停用後無法使用；未失效前可供多人註冊 |

邀請信沒收到時，管理員可以在 <mark style="color:blue;">邀請狀態</mark> 對這筆邀請按 <mark style="color:blue;">重新發送</mark>。同一筆邀請**連同第一次寄出最多寄 3 次**，且距離上次寄出需滿 **5 分鐘**；未滿 5 分鐘或已寄滿 3 次時，<mark style="color:blue;">重新發送</mark> 不會出現。

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

公司已設定單一登入時，通常**不需要在註冊頁設定密碼**：

1. 到 [登入頁](/start/login.md) 輸入公司信箱，按 <mark style="color:blue;">繼續</mark>。
2. 若公司信箱的網域已綁定單一登入，畫面會提示將以單一登入驗證，按鈕變成 <mark style="color:blue;">前往 Acme SSO 登入</mark>（Acme 為你的組織名稱）。按下後到公司的身分驗證頁登入。
3. 第一次 SSO 登入時，系統會自動建立你的帳號；管理員若已用**同一個信箱**寄出 Email 邀請，你會同時加入該組織並取得指定角色。

公司若使用其他登入方式（例如 EIP、Keycloak），請改用公司提供的登入網址，流程說明見 [第三方登入（SSO）](/org/sso.md#first-login)。

{% hint style="warning" %}
組織邀請連結只在註冊頁使用。公司走 SSO 時，請管理員改用 Email 邀請你的公司信箱，SSO 第一次登入時才會自動加入。
{% endhint %}

畫面顯示「此組織的單一登入暫停使用，請洽系統管理員。」時，單一登入暫時無法使用，只有設過平台密碼的帳號能用密碼登入；請聯絡公司 IT 或組織管理員。

## 屬於多個組織時切換 <a href="#switch-organization" id="switch-organization"></a>

每個組織的角色、Agent、Credits 額度與 API 金鑰各自獨立，操作前請先確認目前所在的組織。

* **切換組織**：左側選單最上方的下拉選單顯示目前組織。點開後選擇要前往的組織（可直接輸入名稱搜尋），頁面會重新載入到該組織的首頁。左側選單收合時，改點最上方的建築圖示。
* **把常用組織排在前面**：點右上角頭像 → <mark style="color:blue;">帳號</mark> → <mark style="color:blue;">我的組織</mark>，對組織按 <mark style="color:blue;">釘選</mark>。釘選的組織會排在切換選單最上方並顯示圖釘；釘選只記在目前這台裝置的瀏覽器。

更多帳號設定請見 [個人帳號設定](/start/profile.md)。

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

### 一直沒收到邀請信？ <a href="#faq-no-email" id="faq-no-email"></a>

先檢查垃圾郵件匣，再請管理員到 <mark style="color:blue;">邀請狀態</mark> 查看這筆邀請：顯示 <mark style="color:blue;">信件寄送失敗</mark> 或仍為 <mark style="color:blue;">待接受</mark> 時可以重新發送（受上方 3 次與 5 分鐘限制）。狀態為 <mark style="color:blue;">待接受</mark> 時，你也可以直接到登入頁點 <mark style="color:blue;">註冊</mark>，用**受邀的信箱**完成註冊，系統一樣會把你加入組織。

### 註冊時出現「無效的推薦碼。」？ <a href="#faq-invalid-code" id="faq-invalid-code"></a>

邀請碼已失效：邀請連結已過期或被停用，或這封邀請信已被撤銷、已經用過。請管理員重新邀請或提供新的邀請連結。

### 註冊完成，卻看不到公司的組織？ <a href="#faq-org-missing" id="faq-org-missing"></a>

從邀請信註冊時，最常見的原因是填了和收信不同的信箱。請把你實際註冊的信箱告訴管理員，由管理員重新邀請；因為你已經有帳號，系統會直接把你加入組織。

### 我已經有帳號，邀請連結卻無法註冊？ <a href="#faq-existing-account" id="faq-existing-account"></a>

邀請連結只能用來註冊新帳號。已有帳號的人請管理員用 Email 邀請你目前的登入信箱，就會直接加入組織。

### 剛加入就有一筆 Credits 額度，是正常的嗎？ <a href="#faq-initial-quota" id="faq-initial-quota"></a>

是。組織若設定了「新成員預設額度」，或邀請你的管理員在邀請時另設了額度，你加入當下就會自動拿到一份個人額度，有效期間從加入時間起算。查看方式見 [成員自查個人額度](/others/credits/member-credit-quota.md#member-self-check)；若組織開啟了「未分發額度前禁止消耗」而你沒有拿到額度，使用 AI 時會被擋下，請聯絡管理員分發，見 [成員 Credits 額度管理](/others/credits/member-credit-quota.md#new-member-default-quota)。

### 加入組織後登入，卻看到「無存取權限」？ <a href="#faq-no-access" id="faq-no-access"></a>

你已經在組織裡，但管理員還沒替你的角色開任何功能。這一頁能做什麼、要請管理員做什麼，見 [如何登入平台：登入後出現「無存取權限」頁面？](/start/login.md#faq-no-access)。

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

* [如何登入平台](/start/login.md)
* [忘記密碼](/start/forget-password.md)
* [個人帳號設定](/start/profile.md)
* [成員管理（管理員）](/org/overview/member.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/invitation.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.