Agent Builder — tổng quan

Agent Builder (/app/agent-builder/) là nơi bạn tinh chỉnh 1 Agent AI — từ system prompt, bộ công cụ, đến khi nào tự kích hoạt, khi nào chuyển người thật. Có 10 tab ở thanh bên trái.

10 tab của Agent Builder

#	Tab	Mô tả ngắn	Chi tiết
1	Prompt	Tên + avatar + System Prompt (16k ký tự) + chọn Model/Engine	Tinh chỉnh AI ở create-howto
2	Công cụ	40 tools AI có thể gọi — bật/tắt từng cái, config riêng	👉 Tools tổng quan
3	Kiến thức	Nguồn kiến thức (file/text/URL) + duyệt Fact V4	👉 Kiến thức tổng quan
4	Kích hoạt	Lịch chạy định kỳ + proactive trigger + webhook	—
5	Cảnh báo	Rule alert (lỗi/ngưỡng/từ khoá) → Telegram/Email/Webhook	—
6	Bộ nhớ	Nhớ dài hạn + template nhớ ngắn hạn + session	—
7	Tiến hoá Agent	AI tự đề xuất cải thiện (prompt/knowledge/skill)	👉 Tiến hoá
8	Biến	Biến tuỳ chỉnh `{{key}}` tái sử dụng trong prompt	—
9	Nâng cao	Temperature, Max Tokens, Multi-Agent routing	👉 Handoff & routing
10	Cần trợ giúp	Link docs + Telegram support	—

Tab 1 — Prompt

Trang gốc của Agent. Cấu hình:

Tên + mô tả + avatar — hiển thị ở sidebar và chat.
System Prompt — khối markdown lớn (giới hạn 16.000 ký tự) — инструкции cho AI: bạn là ai, nói chuyện thế nào, quy tắc nào tuân.
Model & Engine — chọn provider (OpenAI/Gemini/Claude) + model (gpt-4o/mini…). Quản lý ở tầng platform.
AI Refine chat — chat với AI để tinh chỉnh prompt (“làm giọng thân mật hơn”).
Lịch sử phiên bản prompt — xem + khôi phục phiên bản cũ.
Compact — nén prompt dài thành ngắn gọn.

Tab 2 — Công cụ

AI không chỉ nói chuyện — nó có thể gọi tool để làm việc: gửi ảnh, tạo đơn, tra giá ship, handoff người thật… Xem chi tiết ở Tools tổng quan.

Tab 3 — Kiến thức

Nơi AI học về shop bạn: file PDF/Word, text, URL website. AI dùng kiến thức này để trả lời chính xác thay vì bịa. Xem Kiến thức tổng quan.

Tab 4 — Kích hoạt (Triggers)

Mặc định AI chỉ hoạt động khi khách nhắn tới. Tab này cho AI chủ động hơn:

Recurring — chạy định kỳ (mỗi 10 phút / giờ / ngày / tuần / tháng / custom).
Proactive — chủ động khi khách idle 1 lúc, khi có event, theo lịch.
Approval gate — yêu cầu Boss duyệt trước khi AI chạy trigger.
Webhook token — gọi trigger từ hệ thống ngoài.

Tab 5 — Cảnh báo (Alerts)

Tạo rule để được thông báo khi có sự cố:

Loại alert	Khi nào trigger
error (Lỗi)	AI gặp lỗi runtime
threshold (Ngưỡng)	Vượt số lần/giới hạn nào đó
keyword (Từ khoá)	Khách nhắn từ khoá nhạy cảm
inactivity (Không hoạt động)	AI không phản hồi quá lâu

Mỗi alert chọn kênh: Telegram · Email · Webhook.

Tab 6 — Bộ nhớ (Memory)

Long-term memory — bật/tắt + cấu hình recall limit/budget.
Short-term templates — template nhớ ngắn hạn theo loại shop:
- customer_support — hỗ trợ khách.
- lead_qualification — phân loại lead.
- matchmaking — ghép nối.
Episodic sessions — nhớ theo phiên hội thoại.

Tab 7 — Tiến hoá Agent

AI tự học từ thực tế → đề xuất cải thiện:

Prompt patch — đề xuất sửa system prompt.
Knowledge — đề xuất thêm kiến thức.
Skill — đề xuất skill mới.

Bạn duyệt trước khi áp dụng. Xem Tiến hoá Agent.

Tab 8 — Biến (Variables)

Tạo biến tuỳ chỉnh {{ten_bien}} dùng lại trong prompt:

Loại: text / number / boolean / secret.
Vd: {{ten_shop}}, {{sdt_hotline}}, {{api_key_secret}}.

Tab 9 — Nâng cao (Advanced)

Temperature — độ sáng tạo (0 = chính xác, 1 = sáng tạo).
Max Tokens — giới hạn độ dài phản hồi.
skills_config — JSON cấu hình skill nâng cao.
Multi-Agent routing — định tuyến giữa nhiều Agent. Xem Handoff & routing.

Tab 10 — Cần trợ giúp

Link tới docs + Telegram support.

Bước tiếp theo

Tools tổng quan — 40 tools AI có thể gọi.
AI gửi ảnh trong chat — cú pháp [IMAGE:url].
Handoff & Telegram notify — chuyển người thật + thông báo.
Tạo Agent how-to — wizard tạo Agent đầu tiên.
Kiến thức tổng quan — dạy AI về shop.