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베트남 시간 기준 경기 일정과 결과: 프리미어리그, 챔피언스리그, 라리가, 세리에 A, 분데스리가, 리그 1ESPN

시간, 메모, 기억

도구하는 일
timer.set카운트다운 타이머 (“10분 뒤에 알려 줘”)
alarm.set특정 시각의 알람이나 알림, 매일 반복 가능
timer.list실행 중인 타이머와 알람 목록
timer.cancel하나를 취소, number=0이면 전부
notes.add, notes.list, notes.remove할 일·장보기 목록 (최대 30개)
memory.save, memory.forget이름, 취향, 가족 등 당신에 대한 장기 기억. 모든 세션에 포함

음악, 라디오, 앱

도구하는 일
music.searchZing MP3에서 검색해 짧은 목록을 읽어 줘요
music.play이름이나 id로 Zing MP3 곡 재생, 가사 동기화
music.sd_cardSD 카드 음악 재생, 오프라인, 성조 무시 검색
radio.play라디오 재생 (VOV1–3, VOV 교통, 하노이 FM, RFI)
music.stop음악이나 라디오 정지
app.open음성 앱 열기
character.switch다른 캐릭터로 전환

기기와 확장

도구하는 일
system.wifi_setup기기를 Wi-Fi 설정 모드로 (명확히 요청할 때만)
extension.call웹 설정에 등록한 웹훅 호출 (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