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

# Tùy chỉnh Agent

> Chỉnh sửa cách các agent mặc định giao tiếp, chọn những gì chúng có thể truy cập và tạo agent của riêng bạn

Năm agent mặc định hoạt động ngay khi được thiết lập. Tùy chỉnh cho phép bạn thay đổi **cách chúng giao tiếp** (giọng điệu, quy tắc, ngôn ngữ) và **những gì chúng có thể truy cập** (kết nối). Khi các agent mặc định không đủ, bạn có thể tự xây dựng agent của mình.

Mở [Agents](https://app.cloudthinker.io/agents) để bắt đầu. Bảng bên trái nhóm agent thành **Core Team** (năm agent mặc định) và **Custom** (agent của bạn). Nhấp vào bất kỳ agent nào để mở hộp thoại cài đặt — hai tab (**Identity**, **Connections**). Personality (Instructions, Language, Learning mode) nằm ở cuối tab **Identity**.

<Note>
  Tùy chỉnh agent yêu cầu quyền **workspace admin**. Thành viên có thể chat với agent nhưng không thể chỉnh sửa chúng.
</Note>

***

## Những gì bạn có thể thay đổi

| Trường                                | Agent mặc định (Alex, Oliver, Tony, Kai, Anna)        | Agent tùy chỉnh                             |
| ------------------------------------- | ----------------------------------------------------- | ------------------------------------------- |
| @mention                              | Bị khóa                                               | Đặt một lần khi tạo, không thể thay đổi sau |
| Tên, Vai trò, Mục tiêu                | Bị khóa                                               | Có thể chỉnh sửa                            |
| Instructions, Language, Learning mode | Có thể chỉnh sửa                                      | Có thể chỉnh sửa                            |
| Connections                           | Gắn / tách (Anna chỉ đọc — kế thừa từ các agent khác) | Gắn / tách                                  |
| Trạng thái hoạt động                  | Tự động — tắt khi không có kết nối (Anna luôn bật)    | Thủ công                                    |

Các agent mặc định được tối ưu hóa trước cho các nhiệm vụ chuyên biệt (đám mây, bảo mật, cơ sở dữ liệu, Kubernetes, và Anna cho điều phối). Danh tính của chúng bị khóa để không mất đi sự tinh chỉnh — bạn vẫn có thể điều chỉnh **Instructions**, **Language**, **Learning mode** và **Connections** để phù hợp với quy trình làm việc của mình.

***

## Bậc gói dịch vụ

Chỉnh sửa agent mặc định hoạt động trên **mọi gói**. Chỉ số lượng agent tùy chỉnh thay đổi.

| Gói        | Agent tùy chỉnh |
| ---------- | --------------- |
| Free       | 1               |
| Team       | 5               |
| Scale      | 10              |
| Scale +    | 10              |
| Enterprise | Không giới hạn  |

Đạt giới hạn? Xóa agent không sử dụng hoặc [nâng cấp gói của bạn](/vi/guide/billing/pricing).

***

## Tạo agent tùy chỉnh

Cần agent cho những việc mà các agent mặc định không đáp ứng được — một nhà phân tích thanh toán, người tóm tắt on-call, chuyên gia tài liệu? Hãy tự xây dựng.

Nhấp vào **+** bên cạnh **Custom** trên trang [Agents](https://app.cloudthinker.io/agents), rồi chọn cách tạo.

<Tabs>
  <Tab title="Tạo với AI">
    Phù hợp nhất khi bạn biết **agent cần làm gì** nhưng không muốn tự điền từng trường.

    Mô tả những gì bạn muốn trong một câu — Anna sẽ tiếp tục từ đó. Cô ấy thường xác nhận:

    * **Tên và @mention** — đề xuất các lựa chọn dựa trên mô tả của bạn.
    * **Vai trò và Mục tiêu** — soạn cả hai để bạn phê duyệt hoặc tinh chỉnh.
    * **Model Tier** — khuyến nghị Light / Pro / Ultra dựa trên độ phức tạp của nhiệm vụ.
    * **Instructions** — tạo bản nháp đầu tiên bạn có thể chỉnh sửa.
    * **Connections** — hỏi nên gắn kết nối nào (đám mây, cơ sở dữ liệu, K8s, MCP).
    * **Learning mode** — Auto hoặc Offer.

    Ví dụ prompt: *"Tôi cần một agent theo dõi chi tiêu AWS và thông báo cho tôi khi chi phí hàng ngày tăng hơn 20%."*

    Bạn có thể chỉnh sửa bất kỳ trường nào sau đó từ hộp thoại cài đặt agent.
  </Tab>

  <Tab title="Tạo thủ công">
    Phù hợp nhất khi bạn muốn kiểm soát hoàn toàn mọi trường từ đầu. Hộp thoại hướng dẫn bạn qua ba bước. Phần tiêu đề hiển thị hạn ngạch agent tùy chỉnh cho gói hiện tại (ví dụ: "1 of 10 custom agents used" trên Scale).

    <Steps>
      <Step title="Identity">
        * **Avatar** — nhấp vào ô để thay đổi (mặc định là chữ viết tắt của bạn trên nền gradient).
        * **Name** — ví dụ: "Cost Guardian".
        * **@mention** — tên gọi trong chat (ví dụ: `@cost-guardian`). Phải là duy nhất và không được trùng với `@alex`, `@oliver`, `@tony`, `@kai`, `@anna`. **Đặt một lần — không thể thay đổi sau.**
        * **Role** — tiêu đề ngắn gọn (ví dụ: "FinOps Specialist").
        * **Goal** — một câu về những gì agent này làm.

        Nhấp **Next**.

        <Frame>
          <img src="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/agents/create-custom-agent-dialog-1.png?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=4ebff25696c53485fb958b013d81461e" alt="Trình hướng dẫn Tạo Agent Tùy chỉnh, bước 1 Identity — ô avatar, các trường Name, @mention, Role và Goal" style={{ maxWidth: '400px' }} width="1064" height="1408" data-path="images/agents/create-custom-agent-dialog-1.png" />
        </Frame>
      </Step>

      <Step title="Configuration">
        * **Model Tier** — chọn **Light** (nhanh, chi phí credit thấp nhất), **Pro** (cân bằng), hoặc **Ultra** (khả năng tối đa, chi phí credit cao nhất). Xem [Pricing](/vi/guide/billing/pricing) để biết hệ số nhân credit hiện tại.
        * **Instructions** — một vùng văn bản mô tả cách agent nên hoạt động: tập trung vào gì, cách phản hồi, những gì cần tránh. Viết bằng câu văn thường — hướng dẫn, ràng buộc, giọng điệu và định dạng phản hồi đều nằm ở đây.
        * **Language** — ngôn ngữ phản hồi.
        * **Learning mode** — **Auto** tự động lưu kỹ năng mới; **Offer** hỏi trước khi lưu.

        Nhấp **Next**.

        <Frame>
          <img src="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/agents/create-custom-agent-dialog-2.png?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=552c149b155a128882a008db96f0ae99" alt="Trình hướng dẫn Tạo Agent Tùy chỉnh, bước 2 Configuration — Model Tier, Instructions, Language và Learning mode" style={{ maxWidth: '400px' }} width="1002" height="1462" data-path="images/agents/create-custom-agent-dialog-2.png" />
        </Frame>
      </Step>

      <Step title="Connect">
        Tùy chọn. Dùng các tab **Builtin** và **MCP** để chọn kết nối mà agent này có thể truy cập. Bạn có thể gắn thêm sau từ Agent Settings.

        Nhấp **Skip and Create** để hoàn tất.

        <Frame>
          <img src="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/agents/create-custom-agent-dialog-3.png?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=826b24cfbf405f20e6aebe0dab61fe1a" alt="Trình hướng dẫn Tạo Agent Tùy chỉnh, bước 3 Connect — các tab Builtin và MCP với danh sách kết nối để gắn" style={{ maxWidth: '500px' }} width="1010" height="932" data-path="images/agents/create-custom-agent-dialog-3.png" />
        </Frame>
      </Step>
    </Steps>

    Agent xuất hiện dưới **Custom** và có thể được gọi qua tên @mention trong chat.
  </Tab>
</Tabs>

***

## Chỉnh sửa agent mặc định

Thay đổi giọng điệu, quy tắc, ngôn ngữ và nhiều hơn nữa. Danh tính của agent (tên, @mention, vai trò, mục tiêu) giữ nguyên — chỉ cách nó nói chuyện và hoạt động thay đổi.

<Steps>
  <Step title="Mở agent">
    Vào [Agents](https://app.cloudthinker.io/agents) và nhấp vào một agent trong **Core Team**. Hộp thoại mở trên tab **Identity**.
  </Step>

  <Step title="Chỉnh sửa các trường mở khóa">
    Trên tab **Identity**, Name, Role và Goal bị khóa với gợi ý "Set by CloudThinker, can't be changed"; @mention hiển thị "Set once, can't be changed later". Cuộn xuống trên cùng tab để chỉnh sửa:

    * **Instructions** — một vùng văn bản cho các quy tắc của tổ chức, giới hạn cứng, giọng điệu và định dạng phản hồi. Viết bằng câu văn thường (ví dụ: *"Reply in terse bullet points. Never propose changes that need write access. Escalate anomalies over \$500."*).
    * **Language** — ngôn ngữ phản hồi.
    * **Learning mode** — **Auto** tự động lưu kỹ năng mới; **Offer** hỏi trước khi lưu.
  </Step>

  <Step title="Lưu">
    Nhấp **Save** ở góc dưới phải. Các thay đổi của bạn được áp dụng vào tin nhắn tiếp theo.
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/cloudthinker/aLd-ttc-SCW-aFky/images/agents/customize-agent-dialog.png?fit=max&auto=format&n=aLd-ttc-SCW-aFky&q=85&s=96a5b8a2e737a3f4fa2dec77f6374926" alt="Hộp thoại Agent Settings hiển thị các tab Identity và Connections, các trường Name/@mention/Role/Goal bị khóa, và các trường Instructions/Language/Learning mode có thể chỉnh sửa bên dưới trong tab Identity" width="2698" height="1366" data-path="images/agents/customize-agent-dialog.png" />
</Frame>

***

## Gắn kết nối

Kết nối là cách agent truy cập đám mây, cơ sở dữ liệu, Kubernetes hoặc máy chủ MCP của bạn. Alex, Oliver, Tony và Kai bắt đầu không có kết nối — bạn quyết định mỗi agent có thể truy cập gì.

<Steps>
  <Step title="Mở tab Connections">
    Từ hộp thoại agent, nhấp **Connections**. Phần tiêu đề hiển thị số lượng (ví dụ: "3 connections").
  </Step>

  <Step title="Chọn Builtin hoặc MCP">
    Dùng các tab phụ để chuyển giữa **Builtin** (đám mây, cơ sở dữ liệu, Kubernetes) và **MCP**.
  </Step>

  <Step title="Thêm hoặc xóa">
    Nhấp **Add** để gắn, **Remove** để tách. Lưu để áp dụng.
  </Step>
</Steps>

<Note>
  Agent mặc định **không có kết nối sẽ tự động tắt**. Gắn ít nhất một kết nối để bật lại.
</Note>

<Warning>
  **Kết nối của Anna được quản lý cho bạn.** Anna điều phối các agent khác và kế thừa phạm vi truy cập của chúng, vì vậy tab Connections của cô ấy chỉ đọc. Thay vào đó, hãy gắn kết nối cho Alex, Oliver, Tony hoặc Kai.
</Warning>

***

## Ví dụ

| Bạn muốn gì                                                 | Phải làm gì                                                                                                                          |
| ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Tony phản hồi bằng tiếng Việt với định dạng SQL nghiêm ngặt | Đặt **Language** thành Vietnamese; thêm một dòng trong Instructions: *"Format SQL with uppercase keywords and one clause per line."* |
| Oliver chỉ khuyến nghị, không bao giờ thay đổi              | Thêm vào Instructions: *"Recommend only — never propose changes that need write access."*                                            |
| Alex báo cáo chi phí bằng EUR với bản tóm tắt hàng tuần     | Thêm vào Instructions: *"Report cost in EUR. Summarize spend weekly."* Gắn kết nối đám mây.                                          |

***

## Những điều cần lưu ý

* Các chỉnh sửa áp dụng vào **tin nhắn tiếp theo** — các cuộc trò chuyện đang diễn ra hoàn thành theo cài đặt cũ.
* Chọn @mention của agent tùy chỉnh cẩn thận — nó được đặt một lần và bạn sẽ sống với nó.

***

## Bước tiếp theo

<CardGroup cols={2}>
  <Card title="Thiết lập kết nối" icon="plug" href="/vi/guide/connections/overview">
    Kết nối đám mây, cơ sở dữ liệu, Kubernetes và MCP
  </Card>

  <Card title="Gặp gỡ các agent mặc định" icon="robot" href="/vi/guide/agents">
    Hồ sơ của Alex, Oliver, Tony, Kai và Anna
  </Card>

  <Card title="Kỹ năng tùy chỉnh" icon="brain" href="/vi/guide/skills/custom-skills">
    Thêm kiến thức chuyên môn cho bất kỳ agent nào
  </Card>

  <Card title="CloudThinker language" icon="code" href="/vi/guide/language">
    Cú pháp @agent #tool
  </Card>
</CardGroup>