Tạo & cấu hình Agent

Hướng dẫn tạo Agent và tổng quan Builder. Mỗi tab Builder có trang riêng (link cuối).

Tạo Agent mới

1. AI & Tự động hóa → Trợ lý AI (/app/ai-agent).
2. Bấm + Tạo Agent.
3. Modal “Tạo AI Agent mới” hiện ra, có 3 trường:
   • Tên Agent * (placeholder “VD: Chăm Sóc Bán Hàng”).
   • Mô tả (tùy chọn).
   • Mẫu theo ngành (tùy chọn) — chọn 1 trong các template, hoặc “— Mặc định (trung lập) —”.
4. Bấm Tạo & Mở Builder.

Provider/Model ở đâu?

Form tạo không hỏi provider/model. Trong Builder có box “Model & Engine” nhưng ghi chú “Provider & Model được quản lý bởi Admin hệ thống” — shop dùng model chung của TrolyPage. Muốn dùng model riêng → liên hệ Admin hệ thống (UI hiện không tự cấu hình BYOK).

Trang danh sách Agent

Mỗi card Agent hiện:

• Chip trạng thái: Hoạt động / Tạm dừng (Preset hệ thống luôn bật).
• Chip năng lực: Tools / Kiến thức / Memory / Kỹ năng.
• 4 ô thống kê: Theo dõi / Công cụ / Kiến thức / Nhiệt độ.
• Footer Cập nhật + thời gian.
• 2 nút: Thử (mở chat thử) + Builder (vào trình soạn).
• Menu ⋮: Nhân bản / Bật-Tắt agent / Xóa agent.

Có 2 nhóm: AI Agent Mặc định (Hệ thống) + AI Agent của tôi.

Agent Builder — 8 tab

Builder (/app/agent-builder/{id}) có thanh toggle Build / Chạy thử ở header + nút Lưu. Sidebar trái 8 tab:

#	Tab	Mô tả ngắn
1	Prompt	Hướng dẫn cốt lõi
2	Công cụ	Khả năng của agent
3	Kiến thức	Tài liệu tham khảo
4	Kích hoạt	Tự động hoá
5	Cảnh báo	—
6	Bộ nhớ	—
7	Tiến hoá Agent	Học từ kết quả
8	Biến	—

Cuối sidebar: Nâng cao + Cần trợ giúp.

1. Prompt

System prompt — cách AI hành xử:

• Giọng văn, phạm vi trả lời, cấu trúc câu.
• Nút Tinh chỉnh với AI — bạn mô tả ý, AI viết lại prompt chuyên nghiệp.
• Nút Thử Agent — test ngay.
• Lịch sử phiên bản — badge HIỆN TẠI, nút Khôi phục / Xem tất cả (N).

Version tự lưu

Không có nút “Lưu version” — version tự tạo khi bấm Lưu. Modal tinh chỉnh dùng nút Áp dụng prompt / Áp dụng cấu hình / Áp dụng tất cả.

2. Công cụ

Hành động AI được phép:

• Mẫu cấu hình nhanh (badge Gợi ý) — bộ tool theo ngành.
• Công cụ tích hợp sẵn — builtin (mỗi tool có toggle, chip Luôn bật hoặc link cấu hình / Hướng dẫn:).
• Công cụ tuỳ chỉnh — tự định nghĩa, toggle Bật/Tắt.
• Nút Thêm Công cụ.

Gate theo kênh

Một số tool chỉ hoạt động với kênh hỗ trợ (vd “Gửi sticker” chỉ Zalo Personal). Tool tự ẩn nếu kênh không hỗ trợ.

3. Kiến thức

Gắn Knowledge Base — bộ não của Agent. Đây là phần quan trọng nhất quyết định AI trả lời đúng không.

• Upload file / Markdown / Text.
• Import website (Trang đơn / Nhiều trang / Sitemap).
• AI trích xuất Facts → bạn duyệt.

Mỗi knowledge row có inline Facts (Knowledge V4) — bấm Xem để mở FactReviewPanel duyệt fact.

Chi tiết: Knowledge V4 + Thêm nội dung.

4. Kích hoạt

Khi nào Agent tự chạy. Bấm Thêm kích hoạt → modal “Chọn loại kích hoạt”:

• Định kỳ: Mỗi 10 phút / Mỗi giờ / Hàng ngày / Hàng tuần / Hàng tháng / Tùy chỉnh.
• Tiếp cận Chủ động: Không hoạt động / Sự kiện-Sinh nhật / Phát sóng.

5. Cảnh báo

Agent có thể bắn cảnh báo khi có dấu hiệu bất thường (keyword nhạy cảm, khách im lâu, AI lỗi). Được qua nhiều kênh (bell trong app, Telegram, email).

6. Bộ nhớ

• Bộ nhớ Dài hạn (toggle Bật Bộ nhớ Dài hạn) — nhớ qua nhiều hội thoại. Có Ký ức đã lưu + Thêm ký ức.
• Bộ nhớ Tình huống (Phiên gần đây).
• Bộ nhớ Ngắn hạn — nhớ trong 1 hội thoại.

7. Tiến hoá Agent

AI tự đề xuất cải tiến (sửa prompt, thêm Fact, đề xuất tool) dựa trên hội thoại thực tế. Bạn duyệt proposal → áp dụng. Xem Tiến hoá Agent.

8. Biến

Định nghĩa biến dùng trong prompt/reply: {ten_khach}, {ma_don}, {giam_gia}…

Test trước khi bật

Toggle header sang Chạy thử → chat với Agent như khách → xem trả lời ra sao. Chỉnh prompt/kiến thức nếu chưa ưng.

Gắn Agent với kênh

Sau khi cấu hình:

1. Vào Cài đặt → Kênh (/app/channels).
2. Sửa kênh → chọn AI Agent (select) → lưu.

Khách nhắn vào kênh đó → Agent phụ trách trả lời.

Nhân bản Agent

Trong danh sách Agent → menu ⋮ → Nhân bản → đặt tên mới (default “Agent Copy”) → tạo bản sao cấu hình.

Bước tiếp theo

• Trợ lý AI tổng quan — nếu chưa đọc.
• Agent Builder — 10 tab tổng quan — cấu hình chi tiết.
• Công cụ AI (40 tools) — bật/tắt tool.
• AI gửi ảnh trong chat — cú pháp [IMAGE:url].
• Handoff & Telegram notify — chuyển người thật.
• Knowledge V4 — “bộ não” của Agent.
• Tiến hoá Agent — tự cải tiến.