Bắt đầu nhanh

Chào mừng bạn đến Miracle Network — nền tảng tự động hóa workflow, AI agent, và ứng dụng vertical (Commerce, Social Listening, Room Rental, …) trên một identity và entitlement thống nhất. Hướng dẫn này giúp bạn đi từ zero tới workflow chạy được trong khoảng 30 phút, không cần kiến thức sâu về DevOps.

Miracle Network là gì?

Tóm lại, nền tảng gồm ba lớp bạn thường chạm tới:

Hub / Dashboard — quản lý org, user, marketplace app, billing entitlement
Automation & AI — workflow, template, companion «Hỏi AI»
Module nghiệp vụ — Commerce, DCG, Rent, … — mỗi module có shell và data riêng nhưng dùng chung đăng nhập

Bạn không cần bật tất cả module cùng lúc. Hầu hết team bắt đầu từ Discover + một module pilot.

Bước 1 — Tạo tài khoản và tham gia tổ chức

Truy cập trang chủ Miracle Network và chọn Đăng ký
Xác minh email (nếu bật trên môi trường của bạn)
Admin mời bạn vào workspace (tổ chức) — mỗi workspace gom dữ liệu và quyền riêng
Sau login, kiểm tra menu góc phải: đúng workspace và vai trò (xem / chỉnh sửa / quản trị)

Guest-safe: Không chia sẻ link invite có token qua kênh công khai. Admin rotate invite khi nghi ngờ lộ.

Bước 2 — Làm quen Discover và Hub

Discover (/) là mặt tiền marketing + launcher app. Hub (/dashboard) là trung tâm điều hành:

Khu vực	Mục đích
Tổng quan	Snapshot app đang entitled
Marketplace	Cài thêm SKU / workflow pack
Cài đặt	Profile, tích hợp org-level
Hỏi AI	Companion onboarding (nếu bật)

Dành 5 phút click qua menu — quan sát mobile quick nav nếu bạn hay dùng điện thoại; Miracle Network thiết kế mobile-first cho list và L0 header.

Bước 3 — Cài app hoặc template đầu tiên

Hai lối vào phổ biến:

A. Marketplace app

Vào /marketplace hoặc Hub → Marketplace
Chọn app phù hợp pilot (ví dụ Commerce lite, automation pack)
Hoàn tất entitlement — admin org phê duyệt nếu cần
Mở app từ launcher — URL thường dạng /commerce, /dongcafegroup, …

B. Workflow template

Mở /templates
Lọc theo category (Trading, AI, Business)
Use template — fork vào workspace automation của org
Điền credential qua Organization Secret — không hardcode trong node

Bước 4 — Chạy workflow đầu tiên

Giả sử bạn chọn template thông báo đơn giản:

Mở Automation Hub (hoặc n8n workspace được liên kết — tùy triển khai)
Kiểm tra trigger (schedule, webhook, manual)
Execute once — quan sát log từng node
Nếu fail: đọc message lỗi → thường là thiếu credential hoặc URL webhook sai môi trường

Khuyến nghị: gắn nhãn workflow pilot-<team>-<date> để dễ audit sau này.

Bước 5 — Bật AI companion (tuỳ chọn)

Nếu org có entitlement docs.ask hoặc Discover companion:

Mở /support hoặc icon Hỏi AI trên header
Hỏi thử: «Làm sao cài template?» — câu trả lời nên trích dẫn /docs công khai
Companion không thay thế tài liệu ops nội bộ — corpus RAG tách biệt tier public docs

Chi tiết tạo agent: xem Tạo AI agent đầu tiên.

Bước 6 — Phân quyền và an toàn sớm

Ngay từ ngày đầu, thiết lập:

Vai trò người dùng — ai được cài app marketplace, ai chỉ vận hành workflow
Kho credential — mọi API key lưu trong secret của workspace, đổi định kỳ
Môi trường thử — chạy pilot trên workspace test trước khi bật cho toàn bộ khách hàng

Team kỹ thuật nên đọc Self-hosting nếu tự quản lý hạ tầng.

Checklist 30 phút

Login + đúng org
Mở Hub và Discover không lỗi layout mobile
Cài 1 template hoặc app pilot
Chạy workflow test PASS
(Tuỳ chọn) Hỏi AI 3 câu FAQ
Mời đồng đội thứ hai với role Member

Troubleshooting nhanh

Triệu chứng	Hướng xử lý
Không thấy app trên launcher	Kiểm tra entitlement marketplace + đúng org
Workflow 401/403	Credential hết hạn hoặc thiếu quyền workspace
Chat AI «không biết»	Corpus chưa index — dùng `/docs` hoặc support
Trang trắng sau deploy	Hard refresh; admin kiểm tra health API

Bước tiếp theo

Cài đặt và truy cập — tài khoản và workspace
Tạo workflow đầu tiên — lab 15 phút
Self-hosting & vận hành — nếu bạn sở hữu hạ tầng
Tạo AI agent đầu tiên — mở rộng companion
Duyệt thư viện /templates cho use case ngành bạn

Cần hỗ trợ trực tiếp? Ghé /support — đội Miracle Network phản hồi qua kênh bạn đã cấu hình trong org.