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

Cần gì trước khi bắt đầu

1. Một tài khoản trên console này. Đăng ký bằng email và mật khẩu ở trang đầu.
2. Gadget đã được nạp firmware trỏ về bridge của bạn, và đã vào được Wi-Fi.
3. Biết bạn muốn gadget nói tiếng Việt hay tiếng Anh — điều này chọn ở agent, không phải trên gadget.

Tài khoản, và ai nhìn thấy gì

Mỗi tài khoản là user hoặc admin. Tài khoản mới là user. Quyền admin do một admin hiện có cấp ở trang Tài khoản, hoặc do người vận hành deployment cấp; console không có cách nào để tự cấp quyền cho chính mình.

User chỉ thấy những gì của mình: thiết bị, agent (prompt, chủ đề và model), kết nối model riêng, và lịch sử hội thoại của mình.

Admin thấy thiết bị của mọi tài khoản — ai sở hữu, agent nào đang trả lời, và hội thoại — và có thể đổi tên, gán agent, ghép cặp hoặc giải phóng bất kỳ thiết bị nào. Admin cũng thấy mọi tài khoản kèm số thiết bị và số agent, và duyệt các yêu cầu claim đang chờ.

Thêm thiết bị bằng mã 6 số

Một gadget mới chưa thuộc về ai. Lần đầu bật máy, nó sẽ hiện một mã 6 số trên màn hình và đọc to từng số.

1. Bật gadget và để nó kết nối Wi-Fi.
2. Đọc mã 6 số trên màn hình (hoặc nghe nó đọc).
3. Vào mục Thiết bị, nhập mã vào ô “Mã 6 số trên màn hình gadget”, bấm Thêm.
4. Yêu cầu của bạn được ghi lại và hiện dưới “Đang chờ duyệt”. Quản trị viên duyệt thì gadget mới thuộc về bạn.
5. Sau khi được duyệt, đánh thức gadget một lần nữa để nó kết nối.

Agent: gadget nói bằng gì

Mỗi gadget được trả lời bởi một agent. Agent giữ lời dặn cho model, ngôn ngữ nó được nghe, model trả lời, và cách trả lời. Bộ chuyển giọng thành văn bản và giọng đọc là cấu hình của account, không phải lựa chọn riêng của agent.

1. Vào mục Agent, bấm “Tạo agent”.
2. Đặt tên, và viết prompt: đây là lời dặn mà model nhận được trước mọi câu hỏi.
3. Chọn runtime — nơi xử lý và trả lời lượt nói. Danh sách ngôn ngữ bên dưới là của runtime đó.
4. Chọn ngôn ngữ. Bộ chuyển giọng thành văn bản và giọng đọc được cấu hình một lần cho account ở mục Nhà cung cấp.
5. Chọn cách trả lời: “Sinh câu trả lời” cho hội thoại thường, “Đọc từ tài liệu” khi agent cần trả lời dựa trên tài liệu đã nạp.
6. Điền “Topics” nếu agent cần tra cứu tri thức: mỗi dòng một chủ đề. Để trống nghĩa là không tra cứu gì, chứ không phải tra cứu tất cả.
7. Mở thiết bị của bạn, chọn agent vừa tạo, bấm Gán agent.

Bộ chuyển giọng thành văn bản và giọng đọc

Gadget nghe qua một bộ chuyển giọng thành văn bản và nói qua một giọng đọc, cấu hình một lần cho account ở mục Nhà cung cấp.

1. Mở Nhà cung cấp và điền phần nhận giọng nói: endpoint, model, và key chỉ khi dịch vụ cần.
2. Điền phần giọng đọc: endpoint, model và tên giọng.
3. Bấm “Nghe thử” để kiểm tra giọng trước khi gadget dùng.
4. Để trống một form nghĩa là dùng mặc định của deployment; bấm “Dùng mặc định của deployment” để quay lại.

Model trả lời: mặc định hay của bạn

Trong form agent có ô “Model trả lời”. Để “Mặc định của runtime”, agent dùng model mà nhà vận hành đã cấu hình — bạn không cần key và không phải trả tiền cho phần đó.

1. Muốn dùng model của riêng bạn: mở Nhà cung cấp, ở mục “Model trả lời”, bấm “Thêm model”.
2. Nhập base URL của endpoint OpenAI-compatible (ví dụ https://api.openai.com/v1), model, và API key.
3. Nhiệt độ (temperature) có thể để trống để dùng mặc định của nhà cung cấp.
4. Quay lại agent, chọn kết nối vừa tạo ở ô “Model trả lời”.

Nói chuyện với gadget

Đánh thức gadget bằng wake word của nó, rồi nói bình thường. Bridge tự biết khi bạn ngừng nói và gửi lượt đi; bạn không phải bấm gì.

Một số câu ngắn do bridge hoặc gadget tự xử lý, không gửi tới model: phát nhạc và dừng nhạc (nếu bridge có thư viện nhạc), và đổi mức âm lượng hay độ sáng màn hình (“to hơn”, “nhỏ hơn”, “sáng hơn”, “tối hơn”).

Gadget có thể làm gì

Model không chỉ trả lời bằng lời. Khi bạn yêu cầu một việc, nó có thể gọi một công cụ mà gadget hoặc bridge cung cấp, rồi nói lại kết quả cho bạn nghe.

Công cụ của gadget do firmware của nó khai, và mỗi board một khác: board có màn hình thì có độ sáng và giao diện hiển thị, board có camera thì có công cụ chụp ảnh, còn âm lượng và trạng thái máy thì board nào cũng có. Danh sách đúng của một máy nằm ở trang của chính nó — mục “Thiết bị này làm được”.

Công cụ của bridge là thư viện nhạc trên máy chạy bridge: phát một bài, dừng nhạc, và liệt kê những bài đang có để model chọn đúng tên. Nhạc phát ra loa của chính gadget. Nếu deployment không cấu hình thư viện nhạc thì ba công cụ này không tồn tại.

Cho hai gadget nói chuyện với nhau

1. Cả hai gadget phải thuộc cùng một tài khoản.
2. Mở trang của một thiết bị, ở ô “Ghép cặp với” chọn chiếc còn lại, bấm Ghép cặp.
3. Khi một chiếc trả lời xong, chiếc kia tiếp lời bằng chính nội dung câu trả lời đó.

Đọc lại hội thoại

Trang của mỗi thiết bị có mục “Hội thoại”: những gì bạn nói và những gì gadget đáp, mới nhất ở trên. Chỉ văn bản được lưu, không lưu âm thanh.

Cập nhật firmware

Firmware do quản trị viên vận hành console cài, không phải chủ thiết bị. Khi một phiên bản khác được chọn cho loại bo của thiết bị, nó sẽ cài ở lần khởi động kế tiếp.

1. Quản trị viên tải ảnh lên và chọn nó làm bản chạy cho loại bo.
2. Tắt rồi bật lại gadget, hoặc để nó tự khởi động lại, để nó hỏi server xem cần chạy bản nào.
3. Gadget tải ảnh, ghi vào phân vùng không đang chạy, rồi khởi động lại lần nữa.
4. Phiên bản mới sẽ hiện trên trang của thiết bị.

Giải phóng thiết bị

Giải phóng một thiết bị nghĩa là nó không còn thuộc tài khoản của bạn, và toàn bộ lịch sử hội thoại của nó bị xoá.

1. Mở trang thiết bị, bấm “Giải phóng thiết bị” và xác nhận.
2. Thiết bị rời khỏi danh sách.
3. Muốn dùng lại, bật gadget để nó hiện mã mới rồi thêm lại như lần đầu.

Lỗi thường gặp