Tạo AI agent đầu tiên

Miracle Network giúp bạn xây dựng AI agent — trợ lý tự động có thể trả lời câu hỏi, gọi workflow, và hỗ trợ vận hành doanh nghiệp — mà không cần viết hạ tầng từ đầu. Bài viết này hướng dẫn lộ trình guest-safe: bạn có thể làm thử trên tài khoản demo trước khi triển khai cho tổ chức.

Bạn sẽ đạt được gì

Sau khi hoàn thành, bạn sẽ có một agent có thể:

Trả lời câu hỏi thường gặp bằng tiếng Việt hoặc tiếng Anh
Gợi ý bước tiếp theo (mở workflow, xem tài liệu, liên hệ hỗ trợ)
Hoạt động trong phạm vi quyền mà admin đã cấp — không truy cập dữ liệu ngoài phạm vi

Chuẩn bị

Tài khoản Miracle Network — đăng ký miễn phí tại trang chủ hoặc dùng môi trường demo nếu team nội bộ cung cấp.
Quyền trong tổ chức — ít nhất quyền tạo/chỉnh companion hoặc automation trong module bạn sử dụng (Commerce, Discover, v.v.).
Mục tiêu rõ ràng — ví dụ: «Trả lời câu hỏi onboarding cho khách mới» thay vì «Làm mọi thứ».

Lưu ý bảo mật: Không đặt mật khẩu, API key, hay token vào prompt agent. Dùng Organization Secret và biến môi trường do admin cấu hình.

Bước 1 — Chọn surface phù hợp

Miracle Network có nhiều điểm vào AI:

Surface	Phù hợp khi
Discover / Hỏi AI	Khách và người dùng mới cần tìm hiểu sản phẩm
Companion trong module	Người vận hành cần hỗ trợ ngữ cảnh (Commerce, Social Listening, …)
Workflow + LLM node	Tự động hóa chuỗi bước có điều kiện

Với agent đầu tiên, khuyến nghị bắt đầu từ Hỏi AI (/support) hoặc companion Discover — phạm vi hẹp, dễ kiểm thử.

Bước 2 — Định nghĩa persona và guardrail

Viết mô tả ngắn (system prompt nội bộ) gồm:

Vai trò: «Bạn là trợ lý onboarding Miracle Network»
Phạm vi: chỉ trả lời về tính năng công khai; từ chối lịch sự nếu hỏi dữ liệu nội bộ
Giọng điệu: thân thiện, súc tích, tiếng Việt mặc định
Escalation: hướng người dùng tới /support hoặc form liên hệ khi không chắc

Tránh prompt dài hàng nghìn từ — chia thành knowledge snippet và liên kết tài liệu /docs thay vì nhồi hết vào một chỗ.

Bước 3 — Kết nối mô hình (LLM)

Trong cài đặt tổ chức, admin chọn nhà cung cấp LLM (cloud hoặc self-host qua Ollama nếu được bật). Người dùng thường không nhập key trực tiếp trên giao diện agent — key nằm ở secret vault.

Khuyến nghị cho agent đầu tiên:

Mô hình cân bằng chi phí/chất lượng (ví dụ lớp «coder» hoặc «general» tùy registry nội bộ)
Giới hạn token đầu ra để tránh câu trả lời quá dài
Bật streaming nếu UI hỗ trợ — trải nghiệm chat mượt hơn

Bước 4 — Gắn công cụ (tools) tối thiểu

Agent mạnh khi có tool — hành động có kiểm soát:

Tra cứu tài liệu công khai — chỉ index /docs đã publish, không mirror toàn bộ ops nội bộ
Mở deep link — ví dụ /templates, /pricing
Tạo ticket hỗ trợ — nếu module support đã bật

Mỗi tool nên có mô tả một dòng để LLM biết khi nào gọi. Không cấp tool xóa dữ liệu hoặc thay đổi billing trong agent onboarding.

Bước 5 — Kiểm thử trước khi mở rộng

Checklist smoke test:

Hỏi 5 câu FAQ — câu trả lời đúng, không bịa link
Hỏi câu ngoài phạm vi — agent từ chối lịch sự
Thử trên mobile (390px) — không tràn layout chat
Xác nhận không lộ secret trong log chat export

Ghi lại câu hỏi fail vào backlog — đó là corpus cải thiện prompt hoặc bài /docs mới.

Bước 6 — Xuất bản và theo dõi

Sau khi pass smoke:

Thông báo team vận hành biết phạm vi agent
Theo dõi metric: số phiên, tỷ lệ escalation sang human
Lên lịch review (mặc định 6 tháng) — cập nhật prompt khi sản phẩm đổi

Mở rộng tiếp theo

Gắn agent vào workflow (trigger Telegram, email, webhook)
Dùng template AI trong thư viện /templates
Đọc thêm Bắt đầu nhanh và Self-hosting nếu bạn quản lý hạ tầng

Cần trợ giúp?

Mở Hỏi AI tại /support hoặc liên hệ đội Miracle Network — chúng tôi hỗ trợ bạn hoàn thiện agent đầu tiên an toàn và đúng entitlement tổ chức.