Pango AI Platform — Tài Liệu Kỹ Thuật
Cổng tài liệu tích hợp chính thức từ Pango AI Team dành cho các kỹ sư phát triển phần mềm, đối tác tích hợp Web App, Mobile App và hệ thống doanh nghiệp.
Tài liệu cung cấp hướng dẫn kiến trúc, quy chuẩn bảo mật, danh mục API và mã nguồn mẫu chuẩn hóa cho 5 module thuộc hệ sinh thái Chatbot AI & Enterprise AI Agents.
Định Hướng Triển Khai
Hệ thống sẵn sàng vận hành theo hai hình thức linh hoạt:
- SaaS (Software as a Service): Kích hoạt nhanh chóng trên hạ tầng đám mây tối ưu sẵn của Pango AI.
- Custom Enterprise: Tùy biến sâu về giao diện, kiến trúc dữ liệu, tác tử AI và quy trình nghiệp vụ chuyên biệt cho từng doanh nghiệp.
1. Năm Phân Hệ Thành Phần Cốt Lõi
Hệ sinh thái của Pango AI Team gồm 5 module được định danh rõ ràng theo vai trò kỹ thuật và phạm vi triển khai:
| STT | Phân Hệ | Mô Hình | Vai Trò & Điểm Nhấn |
|---|---|---|---|
| 01 | Chatbot Service | SaaS / Custom | Hạ tầng API tích hợp: Cung cấp 7 GraphQL APIs, xác thực chữ ký số MD5 Checksum và streaming thời gian thực qua Firestore. |
| 02 | Chatbot Admin | SaaS / Custom | Cổng quản trị doanh nghiệp: Không gian chat trực quan tương tự ChatGPT, quản trị Agent AI đa phòng ban và kiểm soát hạn mức Quota. |
| 03 | Knowledgebase Hub | SaaS / Custom | Trung tâm dữ liệu RAG: Tích hợp Ingestion API, phân đoạn văn bản thông minh, lưu trữ vector (pgvector) và truy hồi tri thức chuẩn xác. |
| 04 | Chatbot Widget | Tùy biến UI/UX | SDK nhúng đối tác: Cung cấp widget nhúng vào CRM và Web App qua 1 dòng mã, cô lập an toàn trong Sandboxed Iframe. |
| 05 | Enterprise AI Agent | May đo Doanh nghiệp | Tác tử AI may đo thực tế: Đồng hành cùng doanh nghiệp lấy yêu cầu, phân tích tri thức, triển khai usecase mong đợi và kiểm thử hoàn thiện liên tục. |
2. Nguyên Tắc Thiết Kế Kỹ Thuật
Kiến trúc hệ thống được xây dựng trên 4 nguyên tắc bảo mật và tối ưu hiệu năng:
- Giao thức GraphQL Thống Nhất: Mọi truy vấn đọc (Query) và thao tác ghi (Mutation) tập trung trên một endpoint duy nhất, payload tinh gọn và kiểu dữ liệu chặt chẽ (Strongly-typed).
- Streaming Bất Đồng Bộ Thời Gian Thực: Quá trình sinh phản hồi của mô hình ngôn ngữ lớn (LLM) được phân phối theo thời gian thực qua Firebase Firestore, loại bỏ rủi ro nghẽn kết nối HTTP.
- Bảo Mật Đa Tầng: Xác thực kết hợp ba lớp:
Private Keydoanh nghiệp, chữ ký sốMD5 Checksumcó gắn dấu thời gian (Timestamp) chống tấn công Replay, vàBearer JWT Tokentheo phiên làm việc. - Cơ Chế Khóa Chống Trùng Lặp (Idempotency): Áp dụng
idempotencyKeycho từng tin nhắn, bảo vệ hạn mức token và ngăn chặn sinh phản hồi trùng lặp khi mạng gián đoạn.
3. Lộ Trình Tích Hợp Chuẩn Hóa
Để triển khai tích hợp, đội ngũ kỹ thuật đối tác tham khảo tuần tự các bước sau:
- 1.1 Môi Trường & Headers: Cấu hình endpoint kết nối và các HTTP Headers bắt buộc.
- 1.2 Xác Thực & Checksum: Triển khai thuật toán tính Checksum MD5 và cơ chế phục hồi token tự động.
- 1.3 Quy Trình Tích Hợp Toàn Trình: Nắm bắt sơ đồ tương tác giữa Client App, GraphQL Gateway và Firestore.
- 1.4 Danh Mục 7 GraphQL APIs: Khai thác chi tiết từng API với code mẫu TypeScript và cấu trúc JSON chuẩn Postman.
- 1.5 Lắng Nghe Firestore Stream: Thiết lập lắng nghe phản hồi từng từ theo thời gian thực.
- 1.6 Thực Hành Tốt Nhất (Best Practices): Checklist tối ưu hóa hiệu năng và trải nghiệm người dùng trước khi phát hành.
4. Kênh Hỗ Trợ Kỹ Thuật
- Đơn vị phát triển: Pango AI Engineering Team
- Hỗ trợ kỹ thuật:
ai-support@pango.vn(hoặc kênh hỗ trợ riêng của từng dự án) - Báo cáo sự cố: Liên hệ trực tiếp Kỹ sư phụ trách dự án đối tác