Aivigo Hướng dẫn sử dụng

Bắt đầu nhanh

Gọi trợ lý AI lần đầu trong 5 phút bằng API key Sandbox.

Lấy API key Sandbox

Đăng nhập Cổng đối tác → API Keys → tab Sandbox → Tạo khoá. Đặt tên gợi nhớ, chọn Ứng dụng (App) và giữ phạm vi agent:process. Sao chép khoá ngay — khoá chỉ hiện một lần.

export AIVIGO_API_KEY=ak_test_xxxxxxxxxxxxxxxx

Gửi câu hỏi đầu tiên

curl -X POST https://api.aivigo.tech/api/v1/agent/process \
  -H "Authorization: Bearer $AIVIGO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "input": { "type": "text", "text": "Khuyến mãi hôm nay có gì?" },
    "user":  { "ref": "kh001", "name": "An" }
  }'

Nếu khoá không gắn App, thêm "app": "<app_id>" vào body (App ID xem ở màn Ứng dụng & Trợ lý).

Đọc kết quả

{
  "turn_id": "0199…",
  "session_id": "0199…",
  "status": "completed",
  "agent": "sales",
  "reply": {
    "text": "Hôm nay có 2 chương trình khuyến mãi…",
    "ui": [{ "type": "promotion_list", "items": [] }]
  },
  "degraded": false
}
  • Hiển thị reply.text cho người dùng; vẽ thêm reply.ui nếu có (Khối giao diện).
  • Lưu session_id và gửi lại ở lượt sau để trợ lý nhớ ngữ cảnh hội thoại.

Hội thoại nhiều bước

curl -X POST https://api.aivigo.tech/api/v1/agent/process \
  -H "Authorization: Bearer $AIVIGO_API_KEY" -H "Content-Type: application/json" \
  -d '{ "session_id": "<session_id>", "input": { "type": "text", "text": "Đặt 2 hộp sữa tươi" }, "user": { "ref": "kh001" } }'

Khi trợ lý cần xác nhận (status: "awaiting_confirm"), gửi lại thao tác của người dùng:

{ "session_id": "<session_id>", "input": { "type": "event", "event": "ui.action", "data": { "action": "confirm" } }, "user": { "ref": "kh001" } }

Muốn thử không cần code?

Dùng Thử nghiệm Voicebox trên Cổng đối tác hoặc Sandbox tương tác ở docs.aivigo.tech.

Giới hạn Sandbox

Hạng mụcGiá trị mặc định
Lượt gọi60 lượt/phút, 2.000 lượt/ngày cho mỗi tenant
Hệ thống nghiệp vụMô phỏng (sản phẩm, đơn hàng, khuyến mãi mẫu)
Vượt hạn mức429 test_quota_exceeded kèm header Retry-After

Tiếp theo: Xác thực & API key.

Sửa trang này trên GitLab

Trong trang này