Hướng dẫn

Tích hợp qua REST API: agent và dữ liệu ngay trong hệ thống của bạn

Tạo khóa API, gọi bất kỳ agent nào (có streaming), đẩy dữ liệu tự động, cùng danh sách đầy đủ các endpoint.

2 Tháng 11 2026 · 2 phút đọc

Mọi thứ trong console đều có sẵn qua REST API, nên bạn có thể dùng các agent ngay trong website, ứng dụng di động, CRM hay trung tâm liên hệ của mình, đồng thời đẩy dữ liệu vào tự động.

1. Tạo khóa

Trong console, mở API & keys, đặt cho khóa một tên cho biết nó được dùng ở đâu (ví dụ mobile-app-prod) rồi nhấn Create key. Copy ngay lúc này: hệ thống chỉ lưu một fingerprint, nên khóa sẽ không thể hiển thị lại lần nữa. Hãy giữ khóa trong phần secrets của máy chủ, tuyệt đối không đặt trong website hay ứng dụng mà khách hàng có thể tải về.

2. Gọi một agent

curl https://servicebuddy.com/api/v1/agents/auto/runs \
  -H "Authorization: Bearer $API_KEY" -H "Content-Type: application/json" \
  -d '{"messages":[{"role":"user","content":"Where is my order 1004?"}]}'
  • auto cho phép router tự chọn agent; hoặc bạn dùng một key cụ thể như personal-shopper.
  • Thêm "stream": true để nhận câu trả lời theo từng token (server-sent events), kèm theo các sự kiện sản phẩm, cửa hàng và đổi trả mà bạn có thể hiển thị dạng thẻ (card).

3. Đẩy dữ liệu

curl https://servicebuddy.com/api/v1/datasets -H "Authorization: Bearer $API_KEY" \
  -F entity=product -F [email protected]

Tệp sẽ được tự động ánh xạ và xử lý. Kiểm tra tiến độ bằng GET /api/v1/datasets/{id}.

Các endpoint

Method Path Mục đích
GET /api/v1/schema mô hình dữ liệu chuẩn
GET / POST /api/v1/datasets liệt kê / tải dữ liệu lên
GET /api/v1/datasets/{id} trạng thái và báo cáo chất lượng
GET /api/v1/agents danh mục cùng mức độ sẵn sàng
POST / DELETE /api/v1/agents/{key}/install cài đặt / gỡ bỏ
POST /api/v1/agents/{key}/runs chạy một agent (JSON hoặc stream)
GET /api/v1/usage số lượt chạy theo agent và kênh

Thu hồi khóa

Nhấn Revoke bên cạnh khóa đó. Các lệnh gọi dùng khóa đó sẽ dừng ngay lập tức.

#onboarding#api#developers#integration

Dùng thử trên danh mục của bạn. Khám phá các tác tử

AI Agent Buddies phổ biến

🛍️ ● Demo trực tiếp

Khách hàng · Khám phá & mua sắm

Trợ lý mua sắm cá nhân

Tìm sản phẩm theo nhu cầu, ngân sách, màu sắc và dịp; so sánh các lựa chọn và gợi ý phù hợp nhất.

Cho khách hàng
Dùng thử trực tiếp →
💬 ● Demo trực tiếp

Khách hàng · Dịch vụ

Chăm sóc khách hàng

Trả lời câu hỏi về chính sách từ tài liệu của chính nhà bán lẻ, kiểm tra đơn hàng và điều kiện đổi trả.

Cho khách hàng
Dùng thử trực tiếp →
🚚 ● Demo trực tiếp

Khách hàng · Dịch vụ

Trạng thái đơn hàng

“Đơn của tôi đâu rồi?”: trạng thái, ngày và bước tiếp theo.

Cho khách hàng
Dùng thử trực tiếp →
📍 ● Demo trực tiếp

Khách hàng · Dịch vụ

Tìm cửa hàng

Cửa hàng gần nhất, đang mở hay đóng theo giờ địa phương, giờ mở cửa và dịch vụ.

Cho khách hàng
Dùng thử trực tiếp →
👗 ● Demo trực tiếp

Khách hàng · Khám phá & mua sắm

Stylist phối đồ

Phối một bộ trang phục hoàn chỉnh quanh bất kỳ sản phẩm hay dịp nào, chỉ dùng sản phẩm có thật trong danh mục.

Cho khách hàng
Dùng thử trực tiếp →
📊 ● Demo trực tiếp

Kinh doanh & danh mục hàng

Trợ lý kinh doanh hàng hóa

Trả lời câu hỏi về danh mục hàng và hiệu quả bằng số liệu, sau đó đề xuất hành động.

Cho đội ngũ
Dùng thử trực tiếp →
🚨 ● Demo trực tiếp

Tồn kho & chuỗi cung ứng

Cảnh báo hết hàng

Cảnh báo SKU có nguy cơ hết hàng dựa trên tồn kho hiện có so với tốc độ bán gần đây.

Cho đội ngũ
Dùng thử trực tiếp →
🤝 ● Demo trực tiếp

Vận hành cửa hàng

Trợ lý chăm sóc khách thân thiết

Chuẩn bị hồ sơ tóm tắt khách hàng (hạng, đơn đã mua) và gợi ý sản phẩm để giới thiệu cho khách quen.

Cho đội ngũ
Dùng thử trực tiếp →
👥 ● Demo trực tiếp

Marketing & CRM

Tạo phân khúc khách hàng

Tạo phân khúc khách hàng theo hạng, thành phố và hành vi mua, kèm số lượng.

Cho đội ngũ
Dùng thử trực tiếp →

Bài viết liên quan

🧭Hướng dẫn
Hướng dẫn · 2 phút đọc

Cách hoạt động của quá trình triển khai: từ cuộc gọi đầu tiên đến AI Agent trực tuyến

Sáu bước từ cuộc trò chuyện đầu tiên đến khi AI Agent phục vụ khách hàng của bạn: workspace, dữ liệu, AI Agent, kiểm thử, ra mắt và đội ngũ. Phần lớn nhà bán lẻ đều ra m…

🧭Hướng dẫn
Hướng dẫn · 2 phút đọc

Kết nối dữ liệu của bạn: tệp, API và ánh xạ tự động

Nên tải những bảng nào, mỗi bảng mở khóa tính năng gì, cách ánh xạ cột và báo cáo chất lượng hoạt động ra sao, và cách giữ dữ liệu luôn mới.

🧭Hướng dẫn
Hướng dẫn · 2 phút đọc

Cài đặt và cấu hình AI Agent Buddy cho doanh nghiệp của bạn

Duyệt qua danh mục agent, cài đặt những AI Agent Buddies mà dữ liệu của bạn hỗ trợ, rồi tinh chỉnh chúng bằng hướng dẫn của riêng bạn.

🧭Hướng dẫn
Hướng dẫn · 1 phút đọc

Thử nghiệm AI Agent trong Playground trước khi go-live

Một khung chat riêng tư với toàn bộ AI Agent của bạn, hiển thị agent nào đã trả lời và đã dùng công cụ nào, kèm danh sách kiểm tra trước khi ra mắt.

🧭Hướng dẫn
Hướng dẫn · 1 phút đọc

Mời nhóm của bạn: vai trò và phân quyền

Cấp cho mỗi đồng nghiệp tài khoản đăng nhập riêng với vai trò phù hợp: chủ sở hữu, quản trị viên, phân tích viên hoặc người xem.

🧭Hướng dẫn
Hướng dẫn · 2 phút đọc

Ngôn ngữ và thiết lập quốc tế

Giải thích về ngôn ngữ của console, người mua và danh mục sản phẩm, kèm thiết lập được khuyên dùng cho châu Âu, vùng Vịnh, Ấn Độ và Đông Nam Á.

🧭Hướng dẫn
Hướng dẫn · 2 phút đọc

Ra mắt trợ lý mua sắm AI trên website hoặc qua một đường link

Chọn ngôn ngữ và thương hiệu, sau đó dán một dòng mã hoặc chia sẻ đường link được lưu trữ. Khách mua sắm sẽ thấy gì và cách tạm dừng.