# Kỹ năng AI > Tạo và quản lý các kỹ năng tuỳ chỉnh để mở rộng khả năng của chatbot AI. **Menu:** `Trợ lý AI > Kỹ năng` **URL:** `/manage/ai/skills` *** ## Tổng quan **Kỹ năng (Skill)** là gói năng lực tái sử dụng, được gắn vào chatbot để mở rộng khả năng của trợ lý AI. Thay vì cấu hình lại từng chatbot riêng lẻ, bạn tạo kỹ năng một lần rồi gắn vào nhiều chatbot khác nhau. Hệ thống hỗ trợ hai loại kỹ năng: | Loại | Tên hiển thị | Mô tả | | ---------------- | ------------ | ------------------------------------------------------------------------------------------------------------ | | **Prompt Skill** | Prompt Skill | Đoạn prompt chuyên biệt được chèn vào system prompt của chatbot, bổ sung kiến thức hoặc phong cách giao tiếp | | **Tool Skill** | Tool Skill | Nhóm các công cụ (tools) từ AI Admin registry, cho phép chatbot thực hiện hành động cụ thể trong hệ thống | ### Khi nào dùng Prompt Skill? Dùng khi bạn muốn chatbot có thêm kiến thức chuyên sâu hoặc phong cách riêng mà không cần hành động trong hệ thống. Ví dụ: * Chuyên gia Luật Lao động Việt Nam * Phong cách giao tiếp doanh nghiệp * Hướng dẫn xử lý khiếu nại nội bộ ### Khi nào dùng Tool Skill? Dùng khi bạn muốn chatbot có thể truy vấn hoặc thực hiện thao tác trực tiếp trên dữ liệu hệ thống. Ví dụ: * Quản lý Nhân sự (`employee.list`, `employee.get`, ...) * Quản lý Đào tạo (`enrollment.create`, ...) * Thông báo nội bộ (`announcement.create`, ...) *** ## Danh sách kỹ năng Trang **Kỹ năng** có hai tab chính: | Tab | Chức năng | | ------------- | ----------------------------------------------------------------------- | | **Tổng quan** | Giới thiệu hai loại kỹ năng, ví dụ sử dụng, quy trình và thao tác nhanh | | **Danh sách** | Xem toàn bộ kỹ năng đã tạo, tìm kiếm, lọc, tạo mới | ### Tìm kiếm và lọc Khi ở tab **Danh sách**, bạn có thể: * **Tìm kiếm** theo tên kỹ năng bằng ô tìm kiếm (gõ tự động tìm sau 400ms) * **Lọc theo loại**: chọn **"Tất cả loại"**, **"Prompt Skill"** hoặc **"Tool Skill"** * **Số bản ghi mỗi trang**: chọn 10, 20 hoặc 50 ### Bảng danh sách | Cột | Nội dung | | -------------- | ------------------------------ | | **STT** | Số thứ tự | | **Tên** | Tên kỹ năng và mô tả ngắn | | **Loại** | `Prompt` hoặc `Tool` | | **Danh mục** | Danh mục phân loại (nếu có) | | **Trạng thái** | `Hoạt động`, `Tắt` hoặc `Nháp` | | **Ngày tạo** | Ngày tạo kỹ năng | ### Các thao tác trên từng kỹ năng * **"Chi tiết"** — Mở trang cấu hình kỹ năng * **"Nhân bản"** — Tạo bản sao của kỹ năng (tên tự động thêm " (bản sao)") * **"Xóa"** — Xóa kỹ năng; hệ thống cảnh báo kỹ năng sẽ bị gỡ khỏi tất cả chatbot đang dùng *** ## Tạo kỹ năng mới 1. Vào tab **Danh sách**, nhấp **"Tạo Skill"** ở góc phải 2. Hộp thoại **"Tạo Skill mới"** xuất hiện, điền các trường: | Trường | Bắt buộc | Mô tả | | ------------- | -------- | ------------------------------------------------- | | **Tên skill** | Có | Tên kỹ năng, ví dụ: `Quản lý Nhân sự` | | **Loại** | Có | Chọn `Prompt Skill` hoặc `Tool Skill` | | **Mô tả** | Không | Mô tả ngắn giúp admin nhận biết kỹ năng | | **Danh mục** | Không | Nhãn phân loại, ví dụ: `hr`, `training`, `custom` | 3. Nhấp **"Tạo"** để tạo kỹ năng và mở trang cấu hình ngay > **Lưu ý:** Loại kỹ năng (`Prompt Skill` / `Tool Skill`) không thể thay đổi sau khi đã tạo. Hãy chọn đúng loại trước khi nhấp **"Tạo"**. *** ## Cấu hình kỹ năng Sau khi tạo, hệ thống chuyển sang trang cấu hình chi tiết của kỹ năng. Trang có hai tab: | Tab | Nội dung | | ------------------------------------ | ---------------------------------------------------- | | **Thông tin chung** | Tên, mô tả, danh mục, trạng thái, mô tả cho AI Agent | | **Nội dung Prompt** *(Prompt Skill)* | Vị trí chèn và nội dung prompt | | **Danh sách Tools** *(Tool Skill)* | Thêm và quản lý danh sách tool từ registry | *** ### Tab: Thông tin chung Áp dụng cho cả Prompt Skill và Tool Skill. | Trường | Mô tả | | ------------------------------ | ------------------------------------------------------------------------------ | | **Tên skill** | Tên hiển thị của kỹ năng | | **Mô tả** | Mô tả ngắn cho admin | | **Loại** | Chỉ hiển thị, không thể thay đổi sau khi tạo | | **Danh mục** | Nhãn phân loại tuỳ chỉnh | | **Trạng thái** | `Hoạt động` — kỹ năng có hiệu lực; `Tắt` — vô hiệu hoá; `Nháp` — đang soạn | | **Mô tả cho AI Agent routing** | Mô tả ngắn giúp AI Agent định tuyến tin nhắn đúng chatbot khi dùng multi-agent | Sau khi chỉnh sửa, nhấp **"Lưu thay đổi"** để lưu. *** ### Tab: Nội dung Prompt (chỉ Prompt Skill) | Trường | Mô tả | | ------------------- | -------------------------------------------------------------- | | **Vị trí inject** | Vị trí chèn prompt vào system prompt của chatbot | | **Nội dung prompt** | Nội dung prompt sẽ được chèn vào chatbot (tối đa 10.000 ký tự) | #### Vị trí inject | Tuỳ chọn | Hành vi | | --------------------------------- | --------------------------------------------------------------------------- | | **Prepend (trước system prompt)** | Chèn prompt kỹ năng vào đầu, trước nội dung system prompt chính của chatbot | | **Append (sau system prompt)** | Chèn prompt kỹ năng vào cuối, sau nội dung system prompt chính | > **Lưu ý:** Chọn **Prepend** khi kỹ năng cần định hình vai trò tổng thể của chatbot (ví dụ: "Bạn là chuyên gia Luật Lao động"). Chọn **Append** khi kỹ năng bổ sung hướng dẫn xử lý cụ thể. Sau khi soạn xong, nhấp **"Lưu nội dung"** để lưu. *** ### Tab: Danh sách Tools (chỉ Tool Skill) Chatbot chỉ có thể sử dụng những tool được liệt kê trong kỹ năng. Các tool lấy từ AI Admin registry. #### Thêm tool 1. Nhập tên tool vào ô **"Thêm tool"** (ví dụ: `employee.list`) 2. Nhấp **"Thêm"** hoặc nhấn **Enter** 3. Tool xuất hiện trong danh sách **"Tools hiện tại"** #### Xóa tool Nhấp biểu tượng **X** cạnh tên tool để gỡ tool khỏi kỹ năng. Sau khi chỉnh sửa danh sách, nhấp **"Lưu thay đổi"** để lưu. > **Lưu ý:** Tên tool phải khớp chính xác với tên đã đăng ký trong AI Admin registry. Liên hệ quản trị viên hệ thống để lấy danh sách tool hợp lệ. *** ## Gắn kỹ năng vào chatbot Sau khi tạo và cấu hình kỹ năng, bạn cần gắn kỹ năng vào chatbot để kỹ năng có hiệu lực. ### Quy trình 1. **Tạo kỹ năng** — Tạo và đặt tên kỹ năng phù hợp với mục đích 2. **Cấu hình nội dung** — Viết prompt (Prompt Skill) hoặc thêm danh sách tool (Tool Skill) 3. **Gắn vào Chatbot** — Vào trang cài đặt chatbot, tìm mục **Skills**, chọn kỹ năng cần gắn 4. **Kiểm tra** — Thử nghiệm chatbot để xác nhận kỹ năng hoạt động đúng > **Lưu ý:** Kỹ năng phải ở trạng thái **Hoạt động** thì mới có hiệu lực khi gắn vào chatbot. Kỹ năng ở trạng thái **Nháp** hoặc **Tắt** sẽ không được chatbot sử dụng. ### Điều hướng đến cài đặt chatbot Từ trang Kỹ năng, nhấp **"Quản lý Trợ lý AI"** ở tab **Tổng quan** để chuyển sang trang quản lý chatbot. Hoặc điều hướng theo đường dẫn `Trợ lý AI > Danh sách` rồi chọn chatbot cần cấu hình. *** ## Trường hợp sử dụng ### Trợ lý HR Chatbot hỗ trợ các nghiệp vụ nhân sự như tra cứu thông tin nhân viên, quản lý hợp đồng. Tạo một **Tool Skill** chứa các tool liên quan nhân sự (`employee.list`, `employee.get`, ...) và gắn vào chatbot HR. Chatbot sẽ chỉ truy cập dữ liệu nhân sự, không thao tác được với các module khác. ### Tư vấn Pháp lý Chatbot tư vấn nội quy, quy định lao động cho nhân viên. Tạo một **Prompt Skill** với nội dung là các quy định pháp luật lao động Việt Nam và nội quy công ty, chèn ở vị trí **Prepend** để chatbot luôn đóng vai chuyên gia pháp lý trước khi trả lời. ### Hướng dẫn Onboarding Chatbot hỗ trợ nhân viên mới trong 30 ngày đầu. Tạo **Tool Skill** gồm tool HR và tool Đào tạo (`enrollment.create`, ...) để chatbot có thể tra cứu thông tin nhân viên và hỗ trợ ghi danh khoá học ngay trong một cuộc trò chuyện. *** ## Xem thêm * [Tạo trợ lý AI (Chatbot)](https://docs.noova.vn/tri-tue-nhan-tao/06-ai-tro-ly/tao-chatbot) * [Cơ sở tri thức](https://docs.noova.vn/tri-tue-nhan-tao/06-ai-tro-ly/co-so-tri-thuc) * [Tổng quan AI](https://docs.noova.vn/tri-tue-nhan-tao/06-ai-tro-ly/tong-quan-ai)