Skip to Content
工具

工具

工具是模型在对话中可以调用的函数。它们在设备上运行,直接访问公开数据源,返回一段简短的回答让角色读出来。 不需要额外的 API 密钥。

日常生活(越南)

工具功能来源
vn.lunar_date任意公历日期对应的农历、干支纪年和农历节日设备端算法
vn.lunar_to_solar农历转公历(“明年春节是哪天?”)设备端算法
vn.weather任何地点的当前天气和 3 天预报Open-Meteo
vn.air_qualityAQI 和 PM2.5,附戴口罩、开窗建议Open-Meteo
vn.news按主题的最新头条(最新、国际、商业、体育、科技…)VnExpress RSS
vn.exchange_rate外汇汇率(USD、EUR、JPY、KRW、CNY…)Vietcombank
vn.gold_priceSJC 金条、9999 金戒等金价PNJ
vn.gold_price_hai_hongHải Hồng 金店的金银报价牌店铺报价牌
vn.stocksVN-Index、VN30、HNX-Index、UPCoMCafeF
vn.lottery北部、中部或南部的最新彩票结果RSS
sports.football越南时间的赛程和比分:英超、欧冠、西甲、意甲、德甲、法甲ESPN

时间、笔记与记忆

工具功能
timer.set倒计时(“10 分钟后提醒我”)
alarm.set指定时刻的闹钟或提醒,可每天重复
timer.list列出正在运行的计时器和闹钟
timer.cancel取消一项,number=0 取消全部
notes.add、notes.list、notes.remove待办或购物清单(最多 30 条)
memory.save、memory.forget关于你的长期记忆(名字、喜好、家人),每次会话都会带上

音乐、电台与应用

工具功能
music.search在 Zing MP3 搜索并读出简短列表
music.play按歌名或 id 播放 Zing MP3 歌曲,同步歌词
music.sd_card播放 SD 卡里的音乐,离线可用,搜索忽略声调符号
radio.play播放电台(VOV1–3、VOV 交通台、河内 FM、RFI)
music.stop停止音乐或电台
app.open打开一个语音应用
character.switch切换到另一个角色

设备与扩展

工具功能
system.wifi_setup让设备进入 Wi-Fi 配置模式(仅在明确要求时)
extension.call调用你在网页设置中声明的 Webhook(Home Assistant、n8n、自己的服务器)
self.camera.take_photo拍照并让模型查看(上游工具)
self.audio_speaker.set_volume、self.screen.set_brightness音量和亮度(上游工具)

工具名是英文的 group.action 标识符。Gemini 函数名不能包含点,所以桥接层会把 vn.weather 转成 vn_weather 再转回来。模型用来判断何时调用工具的描述用越南语写成,并附有示例说法。

可选:Google 搜索

有开通结算的密钥时,可以在网页设置中打开 Google 搜索。如果开启搜索后会话被拒绝,设备会关闭搜索并重试一次。

不用说话也能测试工具

网页服务器开放了设备的 MCP 服务器:

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