Pango AIPango AI Team
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ôCode TypeScript/Axios hoàn chỉnh.


1. Bảng Tóm Tắt 7 Thao Tác GraphQL

Thao TácKiểuMô Tả Chức NăngYêu Cầu Token
1.5.1 AgentConfigDetailQueryKiểm tra cấu hình bật/tắt của bot AI (Pre-flight check)Không
1.5.2 ExternalLoginMutationĐăng nhập tài khoản đối tác & cấp Access TokenKhông (Cần Checksum MD5)
1.5.3 SendAiMessageMutationGửi câu hỏi cho AI và nhận session ID khởi tạoBắt buộc
1.5.4 MyConversationQueryTải danh sách lịch sử hội thoại phân trangBắt buộc
1.5.5 MyChatSessionDetailQueryTải toàn bộ tin nhắn thuộc một Session chỉ địnhBắt buộc
1.5.6 SubmitAiFeedbackMutationGửi đánh giá 1-5 sao và phản hồi chất lượng câu trả lờiBắt buộc
1.5.7 CloseChatSessionMutationĐóng phiên làm việc hiện tại khi người dùng làm mới chatBắt buộc

2. Quy Ước Chung Khi Gọi GraphQL API

  1. Endpoint Duy Nhất: https://staging-cps-ai-svc-v2.mydatalakes.com/graphql
  2. Phương Thức: Luôn sử dụng HTTP POST.
  3. Cấu Trúc Body Chuẩn:
    {
      "query": "query TênThaoTác(...) { ... }",
      "variables": { ... },
      "operationName": "TênThaoTác"
    }
  4. Cấu Trúc Response Thành Công:
    {
      "data": {
        "tênThaoTác": {
          ...
        }
      }
    }
  5. 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
    }