Skip to Content
Tools

Tools

Tools are functions the model can call during a conversation. They run on the device, call public data sources directly and return a short answer that the character reads aloud. No extra API keys are needed.

Daily life (Vietnam)

ToolWhat it doesSource
vn.lunar_dateLunar date, can-chi year, lunar festivals for any solar dateon-device algorithm
vn.lunar_to_solarConverts a lunar date to the solar calendar (“when is Tết next year?”)on-device algorithm
vn.weatherCurrent weather and a 3-day forecast, anywhereOpen-Meteo
vn.air_qualityAQI and PM2.5, with advice on masks and windowsOpen-Meteo
vn.newsLatest headlines by topic (latest, world, business, sports, tech…)VnExpress RSS
vn.exchange_rateForeign exchange rates (USD, EUR, JPY, KRW, CNY…)Vietcombank
vn.gold_priceSJC bars, 9999 rings and other gold pricesPNJ
vn.gold_price_hai_hongGold and silver board of the Hải Hồng jewellery shopshop price board
vn.stocksVN-Index, VN30, HNX-Index, UPCoMCafeF
vn.lotteryLatest lottery results, north, central or southRSS feed
sports.footballFixtures and scores in Vietnam time: Premier League, Champions League, La Liga, Serie A, Bundesliga, Ligue 1ESPN

Time, notes and memory

ToolWhat it does
timer.setCountdown timer (“remind me in 10 minutes”)
alarm.setAlarm or reminder at a time of day, optionally daily
timer.listLists running timers and alarms
timer.cancelCancels one, or all with number=0
notes.add, notes.list, notes.removeA small to-do / shopping list (up to 30 items)
memory.save, memory.forgetLong-term facts about you (name, likes, family), added to every session

Music, radio and apps

ToolWhat it does
music.searchSearches Zing MP3 and reads back a short list
music.playPlays a song from Zing MP3 by name or by id, with synced lyrics
music.sd_cardPlays music from the SD card, offline, accent-insensitive search
radio.playPlays a radio station (VOV1–3, VOV traffic, Hanoi FM, RFI)
music.stopStops music or radio
app.openOpens a voice app
character.switchSwitches to another character

Device and extensions

ToolWhat it does
system.wifi_setupPuts the device in Wi-Fi setup mode (only when asked explicitly)
extension.callCalls a webhook you declared in the web settings (Home Assistant, n8n, your own server)
self.camera.take_photoTakes a photo and lets the model look at it (upstream tool)
self.audio_speaker.set_volume, self.screen.set_brightnessVolume and brightness (upstream tools)

Tool names are English group.action identifiers. Gemini function names cannot contain dots, so the bridge turns vn.weather into vn_weather and back. The descriptions, which the model reads to decide when to call a tool, are written in Vietnamese with example phrases.

With a paid (billing-enabled) key you can turn on Google Search grounding in the web settings. If a session is rejected with search on, the device turns it off and retries once.

Test a tool without talking

The web server exposes the device’s MCP server:

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"}}'