> ## Documentation Index
> Fetch the complete documentation index at: https://agentbase.vn/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cài đặt Workspace

> Quản lý thông tin tổ chức, thành viên, vai trò, gói dịch vụ, thanh toán, API keys và audit logs.

Trang Cài đặt Workspace là nơi quản lý toàn bộ cấu hình của tổ chức — từ thông tin cơ bản, thành viên, gói dịch vụ đến API keys và bảo mật.

## Truy cập

**Sidebar → Cài đặt Workspace** → chọn tab con.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/workspace/settings-overview.png" alt="Tổng quan Cài đặt Workspace" />
</Frame>

***

## General (Tổng quan)

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/workspace/settings-general.png" alt="Cài đặt tổng quan workspace" />
</Frame>

### Tên workspace

Tên hiển thị trên dashboard và trong email thông báo. Nhấn **Lưu** để áp dụng.

### URL workspace

URL slug xuất hiện trong địa chỉ trình duyệt (ví dụ: `cong-ty-abc` trong `/dashboard/cong-ty-abc/`).

<Warning>
  Thay đổi URL workspace sẽ làm tất cả link và bookmark cũ không còn hoạt động.
</Warning>

### Xóa workspace

Xóa vĩnh viễn workspace và **toàn bộ dữ liệu** bên trong — agents, hội thoại, nguồn dữ liệu, cài đặt. Chỉ **Owner** mới có quyền xóa. Yêu cầu nhập tên workspace để xác nhận.

***

## Members (Thành viên)

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/workspace/settings-members.png" alt="Quản lý thành viên" />
</Frame>

### Vai trò mặc định

| Vai trò    | Quyền hạn                                                                                           |
| ---------- | --------------------------------------------------------------------------------------------------- |
| **Owner**  | Toàn quyền — chỉnh cài đặt workspace, thay đổi billing, xóa workspace, quản lý tất cả agents        |
| **Member** | Cập nhật dữ liệu, xem analytics, xóa agents — **không thể** thay đổi cài đặt workspace              |
| **Viewer** | Chỉ đọc — xem resources và analytics, test trong Playground — **không thể** chỉnh sửa bất cứ thứ gì |

### Vai trò tùy chỉnh (Enterprise)

Gói Enterprise cho phép tạo vai trò tùy chỉnh với quyền chi tiết theo từng chức năng:

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/workspace/settings-custom-roles.png" alt="Vai trò tùy chỉnh" />
</Frame>

Các nhóm quyền có thể cấu hình:

* Agents, Nguồn dữ liệu, Chat Logs, Danh bạ, Tích hợp
* Thanh toán, Gói dịch vụ, Thành viên, Webhooks
* Cài đặt Workspace, API Keys, Hành động, Analytics, Leads

### Mời thành viên

<Steps>
  <Step title="Nhấn Mời thành viên">
    Mở form mời — có thể mời nhiều người cùng lúc bằng nút **Thêm thành viên**.
  </Step>

  <Step title="Nhập email và chọn vai trò">
    Nhập email cho từng người và chọn vai trò phù hợp.
  </Step>

  <Step title="Gửi lời mời">
    Nhấn **Gửi**. Người được mời nhận email với link tham gia.

    Link mời có hiệu lực **24 giờ**. Bạn có thể gửi lại hoặc thu hồi lời mời từ danh sách.
  </Step>
</Steps>

### Xóa thành viên

Nhấn menu **⋯** bên cạnh thành viên → chọn **Xóa**. Owner không thể bị xóa hoặc hạ vai trò bởi thành viên khác.

<Info>
  **Lưu ý billing:** Khi xóa thành viên, số slot thành viên dư **không tự động giảm** — phí vẫn giữ nguyên cho đến khi bạn điều chỉnh thủ công trong trang Plans.
</Info>

***

## Plans (Gói dịch vụ)

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/workspace/settings-plans.png" alt="Gói dịch vụ" />
</Frame>

### Quản lý đăng ký

* **Chuyển đổi chu kỳ:** Hàng tháng hoặc hàng năm. Đăng ký hàng năm tiết kiệm — tương đương trả 10 tháng cho 12 tháng sử dụng.
* **Nâng cấp gói:** Có hiệu lực ngay lập tức.
* **Hạ cấp gói:** Áp dụng vào cuối chu kỳ hiện tại, phần phí dư được ghi có vào hóa đơn tiếp theo theo tỷ lệ.
* **Hủy đăng ký:** Tắt tự động gia hạn. Dịch vụ tiếp tục đến hết chu kỳ đã thanh toán, sau đó về gói Free.

### Add-ons (Dịch vụ bổ sung)

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/workspace/settings-addons.png" alt="Add-ons" />
</Frame>

| Add-on                         | Mô tả                                                             |
| ------------------------------ | ----------------------------------------------------------------- |
| **Tự động nạp credits**        | Tự động bổ sung credits khi xuống dưới ngưỡng được cài đặt        |
| **Thêm agents**                | Mở rộng số lượng agents vượt quá giới hạn gói                     |
| **Tên miền tùy chỉnh**         | Dùng domain riêng cho embed script và trang trợ giúp (Enterprise) |
| **Xóa "Powered by AgentBase"** | Ẩn thương hiệu AgentBase khỏi chat widget                         |

<Info>
  Add-ons phải có cùng chu kỳ thanh toán với gói chính — gói tháng chỉ dùng add-on tháng, gói năm chỉ dùng add-on năm.
</Info>

<Warning>
  Hủy add-on có hiệu lực **ngay lập tức**. Phần phí còn lại trong chu kỳ được hoàn vào tài khoản theo tỷ lệ ngày.
</Warning>

<Info>
  Người dùng Free cần nâng cấp lên gói trả phí trước khi có thể thêm bất kỳ add-on nào.
</Info>

***

## Billing (Thanh toán)

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/workspace/settings-billing.png" alt="Thanh toán" />
</Frame>

### Thông tin thanh toán

| Mục                   | Mô tả                                        |
| --------------------- | -------------------------------------------- |
| **Thông tin hóa đơn** | Tên công ty, địa chỉ — hiển thị trên hóa đơn |
| **Email thanh toán**  | Địa chỉ nhận email hóa đơn tự động           |
| **Mã số thuế**        | Tùy chọn — hiển thị trên hóa đơn nếu cần     |

### Phương thức thanh toán

* Thêm thẻ tín dụng/ghi nợ (Visa, Mastercard).
* Chỉ định một phương thức làm mặc định.
* Xóa phương thức không dùng (không thể xóa phương thức đang dùng cho gói active).

### Lịch sử hóa đơn

Danh sách tất cả hóa đơn với tùy chọn xem chi tiết và tải về PDF.

<Info>
  Từ ngày 05/01/2026, người dùng mới (hoặc người dùng chỉ có một gói) nhận **một hóa đơn hợp nhất** thay vì nhiều hóa đơn riêng lẻ.
</Info>

***

## API Keys

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/workspace/settings-api-keys.png" alt="Quản lý API Keys" />
</Frame>

<Info>
  API Keys chỉ có sẵn trên các gói có hỗ trợ API. Kiểm tra gói dịch vụ của bạn nếu tab này không hiển thị.
</Info>

### Tạo API Key

<Steps>
  <Step title="Nhấn Tạo API Key mới">
    Mở form tạo key mới.
  </Step>

  <Step title="Đặt tên">
    Đặt tên mô tả mục đích (ví dụ: "Production", "Development", "Mobile App").
  </Step>

  <Step title="Sao chép ngay">
    Key hiển thị **một lần duy nhất** — sao chép và lưu vào nơi an toàn ngay.
  </Step>
</Steps>

### Bảo mật API Key

<Warning>
  Không bao giờ commit API key vào source code, đưa vào biến public, hoặc chia sẻ qua kênh không bảo mật. Xóa key ngay nếu nghi ngờ bị lộ.
</Warning>

<CardGroup cols={2}>
  <Card title="Dùng biến môi trường" icon="lock">
    Lưu key trong environment variables (`process.env.AGENTBASE_API_KEY`), không hardcode trong source code.
  </Card>

  <Card title="Rotate định kỳ" icon="rotate">
    Tạo key mới, cập nhật ứng dụng, rồi xóa key cũ. Thực hiện định kỳ hoặc khi có nghi ngờ bảo mật.
  </Card>
</CardGroup>

***

## Audit Logs (Enterprise)

Theo dõi tất cả thay đổi trong workspace — ai đã làm gì, lúc nào.

<Frame>
  <img src="https://mintlify.s3.us-west-1.amazonaws.com/agentbase-6e6fb39b/images/workspace/settings-audit-logs.png" alt="Audit Logs" />
</Frame>

### Các thay đổi được ghi lại

* Cập nhật agent (tên, cài đặt AI, hướng dẫn)
* Tạo / xóa nguồn dữ liệu
* Tạo / xóa hành động (Actions)
* Tạo / xóa tích hợp kênh

### Thông tin mỗi bản ghi

| Cột              | Mô tả                                |
| ---------------- | ------------------------------------ |
| **Loại sự kiện** | Loại thay đổi (tạo, cập nhật, xóa)   |
| **Đối tượng**    | Loại và tên/ID đối tượng bị thay đổi |
| **Thành viên**   | Người thực hiện thay đổi             |
| **Thời gian**    | Ngày giờ chính xác                   |

### Tìm kiếm và lọc

* **Khoảng thời gian:** Lọc theo ngày cụ thể.
* **Agent:** Lọc theo agent bị ảnh hưởng.
* **Loại sự kiện:** Chỉ xem thêm/xóa/cập nhật.
* **Tìm kiếm:** Tìm theo tên hoặc ID đối tượng.