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

# 組織概覽

一頁掌握組織的方案、用量、已啟用功能與常用管理入口

「組織概覽」是進入 <mark style="color:blue;">組織設定</mark> 後看到的第一個頁面，把組織的基本資訊、方案歷程、本月用量、已啟用的進階功能，以及常用的管理入口整合在同一頁，讓你一眼掌握組織的整體狀況。

## 怎麼進入 <a href="#how-to-access" id="how-to-access"></a>

從左側選單點選 <mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組織概覽</mark>。

***

## 頁面頂部：組織資訊 <a href="#org-info" id="org-info"></a>

頁面最上方顯示這個組織的基本資料：

| 項目                                      | 說明                                                                                                                                                         |
| --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 組織名稱                                    | 點名稱旁的編輯圖示即可修改；同一個視窗也能設定 [隱藏中國模型](/org/model-access.md#china-models)（僅組織擁有者可變更）與 [新助理的對話平台預設啟用](#new-agent-channel-default)，企業版組織還可設定 [組織品牌](#org-branding) |
| 方案版本                                    | 顯示目前訂閱的方案（例如「企業版」）                                                                                                                                         |
| 組織 ID                                   | 組織的唯一識別碼，點旁邊的圖示可一鍵複製，串接或聯繫客服時會用到                                                                                                                           |
| 建立於                                     | 組織的建立日期                                                                                                                                                    |
| <mark style="color:blue;">方案可使用至</mark> | 顯示最後可用日期與從今天起的可用天數（含今天），方便及早續約                                                                                                                             |

***

## 確認方案最後可用日 <a href="#plan-last-usable-day" id="plan-last-usable-day"></a>

組織管理者安排續約時，可以先進入<mark style="color:blue;">組織概覽</mark>，查看頁面頂部的<mark style="color:blue;">方案可使用至</mark>，再對照<mark style="color:blue;">方案歷程</mark>中的目前方案與<mark style="color:blue;">還可使用 N 天</mark>。兩處都以最後可用日為基準，讓管理者知道還有哪些日期可以使用服務。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-3b59222fb535b9ec132e513f6ac133cd19eef055%2Forg-plan-last-usable-day.png?alt=media" alt="方案可使用至區塊顯示最後可用日期，下面是可使用的天數"><figcaption><p>日期表示最後可用日；可用天數包含今天，會隨日期更新</p></figcaption></figure>

{% hint style="info" %}
「方案可使用至」表示最後可用日期，不是服務停止的時間。若方案在隔天凌晨到期，這裡顯示前一天；「天可使用」從今天起計算，包含今天；實際停止時間仍以方案設定為準，若在白天到期，服務可能在該日中途停止。未設定到期日的方案在方案歷程顯示<mark style="color:blue;">永久</mark>。
{% endhint %}

***

## 新助理的對話平台預設啟用 <a href="#new-agent-channel-default" id="new-agent-channel-default"></a>

「編輯組織」視窗中的 <mark style="color:blue;">新助理的對話平台與 API 串接預設啟用</mark>，決定這個組織之後新建或複製的 Agent，網頁 Widget 與 API 串接一建立是否就啟用：

* **未勾選（平台預設）**：新 Agent 只啟用內部對話，網頁 Widget 與 API 串接先停用，需由成員到 Agent 的 <mark style="color:blue;">對話平台</mark> 分頁手動開啟。
* **勾選**：新 Agent 建立後，網頁 Widget 與 API 串接即為啟用。
* **後台對話不受影響**：內部對話永遠啟用。
* **不溯及既有 Agent**：變更只影響之後新建或複製的 Agent，既有 Agent 的對話平台狀態不變。

成員在 <mark style="color:blue;">建立 AI 助理</mark> 視窗仍可逐一調整，這個設定只決定 <mark style="color:blue;">對話平台啟用</mark> 區塊兩個開關的初始值，見 [建立 Agent：設定對話平台啟用](/build/agent/setup.md#channel-activation)。

### 怎麼設定 <a href="#new-agent-channel-default-how-to" id="new-agent-channel-default-how-to"></a>

需要具備「組織概覽權限」的角色才能進入此頁並修改，組織擁有者預設具備；和「隱藏中國模型」不同，這個設定不限組織擁有者。權限設定見 [角色權限管理](/org/roles/role-permission.md)。

1. 進入 <mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組織概覽</mark>，點組織名稱旁的編輯圖示開啟 <mark style="color:blue;">編輯組織</mark>。
2. 勾選或取消勾選 <mark style="color:blue;">新助理的對話平台與 API 串接預設啟用</mark>。
3. 按 <mark style="color:blue;">確認</mark> 儲存。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-b207a5fcfbd7b72c915c1fbde6dae28f82c4c43b%2Forg-new-agent-channel-default.png?alt=media" alt="編輯組織視窗中未勾選的「新助理的對話平台與 API 串接預設啟用」勾選框，下方說明開啟與關閉時新建或複製助理的差異，以及後台對話永遠啟用、不影響既有助理"><figcaption><p>「編輯組織」視窗中的勾選框與說明；只裁切正在介紹的設定</p></figcaption></figure>

例如某公司的資訊主管希望所有新 Agent 都先在內部測試、確認後才對外開放。他確認 <mark style="color:blue;">編輯組織</mark> 中這個勾選框維持未勾選；之後同事打開 <mark style="color:blue;">建立 AI 助理</mark> 視窗，<mark style="color:blue;">對話平台啟用</mark> 會顯示 <mark style="color:blue;">僅內部對話</mark>，網頁 Widget 與 API 串接的開關都是關閉，要對外時再由同事自己打開。

{% hint style="info" %}
這個勾選框只出現在編輯既有組織時，建立新組織的視窗沒有這個選項。
{% endhint %}

***

## 組織品牌：Logo 與主題色 <a href="#org-branding" id="org-branding"></a>

企業版組織可以把後台換成自己公司的 Logo 與主色。成員登入並進入這個組織後，左上角的標誌，以及按鈕、選取狀態、連結與重點數字等支援品牌設定的介面元素，會套用組織的設定。

### 怎麼設定 <a href="#org-branding-how-to" id="org-branding-how-to"></a>

需要具備「組織概覽權限」的角色才能進入此頁並修改，組織擁有者預設具備，詳見 [角色權限管理](/org/roles/role-permission.md)。

1. 進入 <mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組織概覽</mark>，點組織名稱旁的編輯圖示。
2. 在 <mark style="color:blue;">編輯組織</mark> 視窗設定下列項目，按 <mark style="color:blue;">確認</mark> 儲存。

<table><thead><tr><th width="150">設定項目</th><th width="220">建議規格</th><th>顯示在哪裡</th></tr></thead><tbody><tr><td>正方形 Logo</td><td>比例 1:1，128×128 或 256×256 px</td><td>組織概覽頂部的組織圖示</td></tr><tr><td>橫式 Logo</td><td>比例 3:1 ~ 5:1，高度 32 px 以上</td><td>左側選單左上角的標誌；手機版則顯示在上方列與展開的選單頂部</td></tr><tr><td>主題色</td><td>用色票挑選、點選預設色塊，或直接輸入色碼（例如 <code>#0960bd</code>）；可留空，留空時使用系統設定</td><td>後台的按鈕、選取狀態、連結與重點數字等強調色。視窗內的「按鈕」「選取」兩個預覽標籤會即時反映顏色</td></tr></tbody></table>

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-adff3307b57743dabe8df146ef4fbe69cac1df3c%2Forg-branding-square-field.png?alt=media" alt="正方形 Logo 上傳欄位，標示 1:1 比例"><figcaption><p>正方形 Logo 的上傳欄位</p></figcaption></figure>

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-611b0f5ac91e223dfaa90acdcffe0da39588b4e5%2Forg-branding-horizontal-field.png?alt=media" alt="橫式 Logo 上傳欄位，標示 3:1 至 5:1 比例"><figcaption><p>橫式 Logo 的上傳欄位</p></figcaption></figure>

桌機版把左側選單收合成窄欄時不會顯示任何 Logo。

Logo 沒有上傳時，左上角會顯示平台原本的標誌，組織概覽頂部則顯示組織名稱的第一個字。視窗上方的「未設定時使用系統設定」指的就是這件事。

### 主題色留空：改用系統設定的主色 <a href="#org-theme-color-fallback" id="org-theme-color-fallback"></a>

主題色和 Logo 一樣可以留空。沒有設定主題色的組織，後台強調色會改用這個站台系統設定的主色；有明確設定過的組織則維持自己的顏色。對白牌或自有站台的客戶來說，這代表不必逐一替每個組織設定主題色，新建的組織一進來就是站台的品牌色。

想讓已經設定過主題色的組織改回系統設定：

1. 進入 <mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">組織概覽</mark>，點組織名稱旁的編輯圖示開啟 <mark style="color:blue;">編輯組織</mark>。
2. 在「主題色」色碼欄位右側點 <mark style="color:blue;">清空（使用系統設定）</mark>，色票與「按鈕」「選取」預覽會立刻改成留空後實際生效的顏色。
3. 按 <mark style="color:blue;">確認</mark> 儲存，後台強調色隨即退回系統設定的主色。

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-c772484133203b363b7667eb3646caafbc16fdd0%2Forg-theme-color-field.png?alt=media" alt="主題色欄位：色碼右側有清空圖示，右方顯示按鈕與選取預覽"><figcaption><p>主題色欄位的清空圖示與兩種預覽；只裁切正在介紹的設定區塊</p></figcaption></figure>

{% hint style="info" %}
升級前就已經有主題色的組織，一律視為「已設定」，升級後畫面不會變化；只有主動清空後才會改用系統設定。若站台的系統設定也沒有主色，後台會顯示平台內建的預設色。
{% endhint %}

### 適用範圍 <a href="#org-branding-scope" id="org-branding-scope"></a>

{% hint style="info" %}
**組織品牌只作用在「登入後的後台」**

登入頁、瀏覽器分頁上的圖示與標題、系統寄出的通知信，顯示的仍是平台品牌。這些畫面出現時，系統還不知道使用者屬於哪個組織，所以無法套用組織的設定。
{% endhint %}

<figure><img src="https://1593648278-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fmzb5NG9GDzFP2YDKeYVl%2Fuploads%2Fgit-blob-4e0aceec863413e36fdc025e7cca36ff8dfcc817%2Forg-branding-login-panel.png?alt=media" alt="正式區登入面板，上方是平台標誌，下方是空白公司信箱欄與繼續按鈕"><figcaption><p>登入頁不套用組織品牌，成員登入並進入組織後才會換成組織的 Logo 與主題色</p></figcaption></figure>

* **方案**：正方形 Logo、橫式 Logo 與主題色是企業版功能。其他方案打開「編輯組織」視窗時只能修改名稱，並會看到「此方案不提供組織層品牌設定，將使用系統設定」。想升級請聯繫您的業務窗口。
* **作用對象**：設定跟著組織走。同一位成員切換到另一個組織時，看到的是另一個組織的品牌。
* **對外的對話視窗另外設定**：放在官網上給客戶用的網頁對話視窗，是在各個對話平台的 [外觀設定](/build/conversation-settings/platform-settings/appearance-settings.md) 裡調整，不跟著組織品牌走。Logo、大頭貼、聊天按鈕圖示與配色各方案都能設定；聊天室底部的「技術支援 Logo」與「顯示技術支援標誌」開關是企業版功能。

***

## 方案歷程 <a href="#plan-lifecycle" id="plan-lifecycle"></a>

「方案歷程」以時間軸呈現組織方案的**過去、現在與未來預開**：

* 時間軸可**左右捲動**瀏覽，並以「今天」標記目前位置；捲遠了可點 <mark style="color:blue;">回到今天</mark>
* 每段方案顯示名稱與效期；試用方案帶「試用」標記，未設到期日的顯示「永久」，生效中的方案顯示<mark style="color:blue;">還可使用 N 天</mark>
* 歷史紀錄較多時預設收合，可點 <mark style="color:blue;">顯示較早的 N 筆</mark> 展開

***

## 用量總覽（本月份統計） <a href="#usage-overview" id="usage-overview"></a>

以三張卡片呈現本月的重點用量：

| 卡片             | 內容                                            |
| -------------- | --------------------------------------------- |
| **目前 AI 助理數目** | 已建立的 Agent 數量；方案有上限時顯示「已用 / 上限」，無上限則顯示「無使用限制」 |
| **本月對話數量**     | 本月累計的對話則數                                     |
| **已使用的知識庫容量**  | 目前知識庫已佔用的儲存空間；非 Credits 計費的組織另顯示可用容量與已使用百分比   |

AI 助理卡在方案有上限時，數字下方還會出現幾種提示：

| 提示                                             | 意思                                                               |
| ---------------------------------------------- | ---------------------------------------------------------------- |
| <mark style="color:blue;">還可新增 N 個</mark>      | 距離上限還能再建幾個 Agent                                                 |
| <mark style="color:blue;">還可新增 N 個 ○○助理</mark> | 方案限定只能建某幾種回覆模式的 Agent 時，一併標出還能建的模式                               |
| <mark style="color:blue;">已達上限</mark>          | 名額用完，要先刪除既有 Agent 或升級方案                                          |
| <mark style="color:blue;">另有 N 隻既存助理</mark>    | 這些 Agent 的回覆模式不在方案目前允許的範圍內（例如降級方案之前建的），會保留但唯讀，不計入上限；下一行會列出各模式的數量 |

{% hint style="info" %}
需要更完整的歷史趨勢與明細，請到 <mark style="color:blue;">組織設定</mark> → <mark style="color:blue;">用量統計</mark> 查看。
{% endhint %}

***

## 進階功能與 Credits <a href="#advanced-features-and-credits" id="advanced-features-and-credits"></a>

### 進階功能 <a href="#advanced-features" id="advanced-features"></a>

「進階功能」區塊列出這個組織已啟用的進階能力，依固定順序顯示：

| 功能              | 備註         |
| --------------- | ---------- |
| 通話中心            | 未開通時不顯示    |
| AI 語音助理         |            |
| 會議記錄            |            |
| Hook 訊息攔截／改寫    | 企業版功能      |
| AI Gateway      | 企業版功能，Beta |
| 團隊（Agent Teams） | Beta       |
| 自訂向量資料庫連線       | 企業版功能      |

已啟用的功能會正常顯示；未啟用的功能會以灰色呈現，企業版限定功能並會標上「企業版」標記。

{% hint style="info" %}
想開通某項未啟用的進階功能，請聯繫您的業務窗口。
{% endhint %}

### Credits 點數 <a href="#credits" id="credits"></a>

右側的「Credits 點數」卡片顯示目前的 <mark style="color:blue;">計費方式</mark>（點數模式或字數模式），並提供 <mark style="color:blue;">前往點數錢包</mark> 按鈕，點擊後可查看點數餘額與使用明細。詳細說明請參考 [Credits 計費制度](/others/credits.md)。

***

## 管理操作 <a href="#management-actions" id="management-actions"></a>

「管理操作」提供組織常用設定的快速入口，點擊即可前往對應頁面：

| 入口         | 前往頁面                                                                  |
| ---------- | --------------------------------------------------------------------- |
| 編輯成員       | [成員管理](/org/overview/member.md)                                       |
| 編輯角色權限     | [角色權限管理](/org/roles/role-permission.md)                               |
| 第三方登入設定    | [第三方登入（SSO）](/org/sso.md)（企業版組織才會顯示）                                  |
| 身份同步       | [身分同步（LDAP／SCIM）](/org/identity-sync.md)（企業版組織才會顯示）                   |
| 公告管理       | [公告管理](/org/overview/announcements.md)：發布給全組織或指定角色、成員的公告              |
| OAuth 應用程式 | [OAuth 應用程式](/org/developer/oauth-applications.md)：讓外部系統以組織成員身分呼叫 API |

這六個頁面都沒有左側選單入口，要從這裡進入；進入後左側選單仍以「組織概覽」為目前位置。

***

## 刪除組織 <a href="#delete-organization" id="delete-organization"></a>

頁面最下方為「刪除組織」區，僅組織擁有者可執行，且需輸入組織名稱確認。

{% hint style="danger" %}
刪除組織會永久移除所有 Agent、知識庫與成員資料，且無法復原。請務必確認後再執行。詳細流程請參考 [刪除組織](/org/overview/organization-management.md)。
{% endhint %}


---

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