Skip to Content
Công cụ

Công cụ

Công cụ là các hàm mà mô hình có thể gọi trong lúc trò chuyện. Chúng chạy ngay trên thiết bị, gọi thẳng nguồn dữ liệu công khai và trả về câu trả lời ngắn để nhân vật đọc lên. Không cần API key nào khác.

Đời sống hằng ngày

Công cụLàm gìNguồn
vn.lunar_dateNgày âm, năm can chi, ngày lễ âm lịch của một ngày dương bất kỳthuật toán trên máy
vn.lunar_to_solarĐổi ngày âm sang dương (“Tết năm sau là ngày nào?”)thuật toán trên máy
vn.weatherThời tiết hiện tại và dự báo 3 ngày, ở bất kỳ đâuOpen-Meteo
vn.air_qualityAQI và bụi mịn PM2.5, kèm lời khuyên đeo khẩu trang, mở cửa sổOpen-Meteo
vn.newsTin mới nhất theo chủ đề (mới nhất, thế giới, kinh doanh, thể thao, công nghệ…)VnExpress RSS
vn.exchange_rateTỷ giá ngoại tệ (USD, EUR, JPY, KRW, CNY…)Vietcombank
vn.gold_priceVàng miếng SJC, nhẫn 9999 và các loại khácPNJ
vn.gold_price_hai_hongBảng giá vàng bạc của tiệm vàng Hải Hồngbảng giá của tiệm
vn.stocksVN-Index, VN30, HNX-Index, UPCoMCafeF
vn.lotteryKết quả xổ số mới nhất miền Bắc, Trung hoặc NamRSS
sports.footballLịch thi đấu và tỷ số theo giờ Việt Nam: Ngoại hạng Anh, C1, La Liga, Serie A, Bundesliga, Ligue 1ESPN

Thời gian, ghi chú và ghi nhớ

Công cụLàm gì
timer.setHẹn giờ đếm ngược (“nhắc mình sau 10 phút”)
alarm.setBáo thức hoặc lời nhắc vào giờ cụ thể, có thể lặp hằng ngày
timer.listDanh sách hẹn giờ và báo thức đang chạy
timer.cancelHủy một mục, hoặc tất cả với number=0
notes.add, notes.list, notes.removeDanh sách việc cần làm, đồ cần mua (tối đa 30 mục)
memory.save, memory.forgetGhi nhớ lâu dài về bạn (tên, sở thích, người thân), đưa vào mọi phiên

Nhạc, radio và ứng dụng

Công cụLàm gì
music.searchTìm bài trên Zing MP3 và đọc danh sách ngắn
music.playPhát bài từ Zing MP3 theo tên hoặc mã bài, kèm lời chạy theo nhạc
music.sd_cardPhát nhạc trong thẻ SD, không cần mạng, tìm không cần dấu
radio.playMở radio (VOV1–3, VOV Giao thông, FM Hà Nội, RFI)
music.stopTắt nhạc hoặc radio
app.openMở một ứng dụng giọng nói
character.switchĐổi sang nhân vật khác

Thiết bị và tiện ích mở rộng

Công cụLàm gì
system.wifi_setupĐưa máy vào chế độ cài Wi-Fi (chỉ khi được yêu cầu rõ ràng)
extension.callGọi webhook bạn khai báo trong trang cài đặt (Home Assistant, n8n, máy chủ riêng)
self.camera.take_photoChụp ảnh để mô hình xem (công cụ upstream)
self.audio_speaker.set_volume, self.screen.set_brightnessÂm lượng và độ sáng (công cụ upstream)

Tên công cụ là định danh tiếng Anh dạng nhóm.hành_động. Tên hàm của Gemini không được có dấu chấm, nên cầu nối đổi vn.weather thành vn_weather và ngược lại. Phần mô tả, thứ mô hình đọc để quyết định khi nào gọi công cụ, viết bằng tiếng Việt kèm câu nói mẫu.

Với key có bật thanh toán, bạn có thể bật tìm kiếm Google trong trang cài đặt. Nếu phiên bị từ chối khi bật tìm kiếm, thiết bị tự tắt nó và thử lại một lần.

Thử công cụ không cần nói

Web server mở cổng tới MCP server của thiết bị:

curl -s -X POST http://bap-xxxx.local/api/tool -H 'X-Bap: 1' -H 'Content-Type: application/json' \ -d '{"name":"vn.weather","arguments":{"place":"Hà Nội"}}'
Last updated on