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_xxxxxxxxxxxxxxxxGử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.textcho người dùng; vẽ thêmreply.uinếu có (Khối giao diện). - Lưu
session_idvà 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ục | Giá trị mặc định |
|---|---|
| Lượt gọi | 60 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ức | 429 test_quota_exceeded kèm header Retry-After |
Tiếp theo: Xác thực & API key.