Module 01: Chatbot Service (API)1.5 GraphQL API & Code Examples
Module 01 • API Gateway
Danh Mục GraphQL API & Code Mẫu
Hệ thống Pango Chatbot Service cung cấp 7 thao tác GraphQL cốt lõi được thiết kế chuẩn mực. Mỗi thao tác đều hỗ trợ chuyển đổi giữa GraphQL Query/Mutation thô và Code TypeScript/Axios hoàn chỉnh.
1. Bảng Tóm Tắt 7 Thao Tác GraphQL
| Thao Tác | Kiểu | Mô Tả Chức Năng | Yêu Cầu Token |
|---|---|---|---|
| 1.5.1 AgentConfigDetail | Query | Kiểm tra cấu hình bật/tắt của bot AI (Pre-flight check) | Không |
| 1.5.2 ExternalLogin | Mutation | Đăng nhập tài khoản đối tác & cấp Access Token | Không (Cần Checksum MD5) |
| 1.5.3 SendAiMessage | Mutation | Gửi câu hỏi cho AI và nhận session ID khởi tạo | Bắt buộc |
| 1.5.4 MyConversation | Query | Tải danh sách lịch sử hội thoại phân trang | Bắt buộc |
| 1.5.5 MyChatSessionDetail | Query | Tải toàn bộ tin nhắn thuộc một Session chỉ định | Bắt buộc |
| 1.5.6 SubmitAiFeedback | Mutation | Gửi đánh giá 1-5 sao và phản hồi chất lượng câu trả lời | Bắt buộc |
| 1.5.7 CloseChatSession | Mutation | Đóng phiên làm việc hiện tại khi người dùng làm mới chat | Bắt buộc |
2. Quy Ước Chung Khi Gọi GraphQL API
- Endpoint Duy Nhất:
https://staging-cps-ai-svc-v2.mydatalakes.com/graphql - Phương Thức: Luôn sử dụng HTTP POST.
- Cấu Trúc Body Chuẩn:
{ "query": "query TênThaoTác(...) { ... }", "variables": { ... }, "operationName": "TênThaoTác" } - Cấu Trúc Response Thành Công:
{ "data": { "tênThaoTác": { ... } } } - Cấu Trúc Response Khi Gặp Lỗi:
{ "errors": [ { "message": "Thông điệp mô tả lỗi", "locations": [{ "line": 2, "column": 3 }], "extensions": { "code": "UNAUTHENTICATED" } } ], "data": null }