Giới thiệu

OMICX AI Assistant là trợ lý AI dạng hội thoại (chatbot) của OMICX. Đối tác bên thứ ba có thể tích hợp trực tiếp qua API để gửi tin nhắn và quản lý cuộc trò chuyện thay mặt người dùng cuối của mình.

Base URL

https://api.omicx.one/v1/agent

Tất cả endpoint đều yêu cầu xác thực qua header X-Api-Key — xem chi tiết tại trang Xác thực.

Cuộc trò chuyện (Conversation)

Mỗi cuộc trò chuyện được nhóm theo conversationId. Gửi tin nhắn đầu tiên không kèm conversationId để bắt đầu cuộc trò chuyện mới — response trả về conversationId được tạo, dùng cho các tin nhắn tiếp theo trong cùng cuộc trò chuyện. Mỗi cuộc trò chuyện gắn với một userId do đối tác tự định danh (người dùng cuối phía đối tác) — dùng để phân tách dữ liệu giữa các người dùng khác nhau.

Chế độ phản hồi (Response mode)

• streaming (khuyên dùng) — trả kết quả dần theo dạng SSE (text/event-stream), dùng task_id để gọi Dừng khởi tạo luồng văn bản nếu cần dừng giữa chừng.
• blocking — chờ xử lý xong, trả kết quả trong 1 response.