• Chỉ dẫn hệ thống (system prompt): đoạn văn bản được gửi kèm mọi tin
  nhắn để AI biết vai trò và cách trả lời, người dùng không nhìn thấy.
• Tên công cụ được phép: danh sách tool AI được gọi khi trả lời, ví dụ
  tra cứu bài viết kiến thức, tìm sản phẩm.

Kỹ năng hoạt động thế nào

flowchart LR
    subgraph Skill["Kỹ năng AI"]
        SP["Chỉ dẫn hệ thống"]
        TL["Tên công cụ được phép"]
    end
    Skill -->|gắn vào| P["Chat profile"]
    P --> CHAT["Mỗi lượt chat"]
    SP --> SM["System message gửi cho AI"]
    TL --> TOOLS["Tool AI được gọi"]
    CHAT --> SM
    CHAT --> TOOLS

• Chỉ dẫn hệ thống của tất cả kỹ năng gắn với profile được ghép lại và đặt
  trước system message của lượt chat.
• AI chỉ thấy các tool nằm trong hợp các tool được phép của những kỹ
  năng đó. Không có kỹ năng nào cho phép tool thì AI trả lời thuần văn bản,
  không gọi tool.
• Nếu cấu hình topic guard (ezyai_topic_guard_allowed_topics), chỉ dẫn
  giới hạn chủ đề được thêm vào sau cùng.

Danh sách kỹ năng

• Lọc theo Trạng thái: tất cả, bản nháp, đã xuất bản, ...
• Chọn Số lượng mỗi trang: 12, 24, 50, 100, 200.
• Dùng nút Trước / Sau để chuyển trang.

Tạo kỹ năng

Viết chỉ dẫn hệ thống

• Nêu vai trò rõ ràng: AI là ai, phục vụ ai, mục tiêu là gì.
• Nói rõ khi nào dùng tool: ví dụ "khi khách hỏi về sản phẩm, luôn tìm
  trong dữ liệu cửa hàng trước khi trả lời". AI chỉ gọi được tool đã được
  tick ở phần công cụ được phép.
• Quy định cách trình bày: độ dài, giọng văn, ngôn ngữ, có kèm link
  nguồn hay không.
• Mỗi kỹ năng một mục đích: tách vai trò, giọng văn, chính sách thành
  các kỹ năng riêng để dễ tái sử dụng cho nhiều profile.
• Không đưa thông tin nhạy cảm (api key, mật khẩu, dữ liệu cá nhân) vào
  chỉ dẫn, vì nội dung này được gửi tới nhà cung cấp AI ở mọi tin nhắn.

Bạn là trợ lý tư vấn của cửa hàng. Trả lời bằng tiếng Việt, ngắn gọn,
thân thiện.

Khi khách hỏi về sản phẩm, bài viết hay chính sách, hãy dùng công cụ tìm
kiếm dữ liệu của cửa hàng trước khi trả lời. Luôn giữ nguyên link nguồn
trong câu trả lời. Nếu không tìm thấy thông tin, hãy nói rõ là chưa có
thông tin thay vì tự đoán.

Chọn công cụ được phép

1. Chọn Nguồn công cụ:

   Nguồn	Lấy danh sách tool từ
   Admin	Các tool đăng ký ở admin, qua /graphql/api/v1/mcp/tools
   Web	Các tool đăng ký ở web, qua /graphql/api/v1/mcp/web/tools
   Socket	Các tool trong zone socket, qua command mcpToolList của socket monitor (cần bật socket ở admin)

   Nguồn	Lấy danh sách tool từ
   Admin	Các tool đăng ký ở admin, qua /graphql/api/v1/mcp/tools
   Web	Các tool đăng ký ở web, qua /graphql/api/v1/mcp/web/tools
   Socket	Các tool trong zone socket, qua command mcpToolList của socket monitor (cần bật socket ở admin)

2. Tick các tool muốn cho phép. Di chuột lên tên tool để xem mô tả. Có nút
   Chọn tất cả và Bỏ chọn tất cả.
3. Có thể đổi nguồn để tick thêm tool ở nguồn khác, các lựa chọn trước đó
   vẫn được giữ.
4. Bấm Lưu ở mục này để lưu danh sách tool.

sequenceDiagram
    participant A as Admin
    participant UI as Trang chi tiết kỹ năng
    participant SRC as Nguồn tool<br/>(admin / web / socket)
    participant API as Admin API

    A->>UI: Mở trang chi tiết
    UI->>API: GET /api/v1/ai-skills/{skillId}/allowed-tool-names
    A->>UI: Chọn nguồn công cụ
    UI->>SRC: Lấy danh sách tool
    SRC-->>UI: name, description
    A->>UI: Tick tool, bấm Lưu
    UI->>API: PUT /api/v1/ai-skills/{skillId}/allowed-tool-names

Gắn kỹ năng vào chat profile

1. Vào EzyAI → Các dịch vụ AI chat, chọn dịch vụ, mở chi tiết profile.
2. Ở mục Các kỹ năng AI, gõ tên kỹ năng vào ô Tìm kỹ năng AI, chọn
   kỹ năng rồi bấm Thêm.
3. Lặp lại để gắn nhiều kỹ năng. Có thể gỡ kỹ năng khỏi profile ở bảng bên
   dưới.

Sửa và xoá kỹ năng

• Sửa: bấm biểu tượng sửa ở danh sách, hoặc vào
  /ezyai/ai-skills/{skillId}/edit. Form giống form thêm. Danh sách tool
  được sửa ở trang chi tiết.
• Xoá: bấm Xoá ở danh sách hoặc trang chi tiết, xác nhận ở hộp
  thoại. Kỹ năng và toàn bộ tool được phép của nó bị xoá. Nên gỡ kỹ năng
  khỏi các profile trước khi xoá.

Kiểm tra kỹ năng

API liên quan

{
  "displayName": "Tư vấn sản phẩm",
  "description": "Dùng cho chatbot bán hàng",
  "systemPrompt": "Bạn là nhân viên tư vấn của cửa hàng...",
  "status": "PUBLISHED"
}

{
  "allowedToolNames": [
    "search_knowledge_data_list",
    "search_knowledge_data_by_type_and_id"
  ]
}