Skip to Content
도구 추가

도구 추가

도구는 기기의 MCP 서버에 등록되고 자동으로 함수 선언이 되어 Gemini에 전달됩니다. 프로토콜 코드는 건드릴 필요가 없습니다.

C++가 정말 필요한가요? 모델을 위한 고정 대본이라면 앱(데이터만)으로, 자신의 서비스를 호출하려면 웹 설정에 웹훅을 등록해 extension.call로 부르면 됩니다.

1. 등록하기

assistant::RegisterTools()(firmware/src/assistant/assistant_tools.cc)에서:

mcp.AddTool("vn.fuel_price", "Xem giá xăng dầu bán lẻ hôm nay tại Việt Nam (RON 95, E5, dầu DO). Dùng khi người " "dùng hỏi giá xăng.", PropertyList({Property("kind", kPropertyTypeString, std::string(""))}), [](const PropertyList& p) -> ToolResult { auto body = HttpGet("https://example.vn/fuel.json"); if (!body) return std::unexpected(body.error()); // ... parse with cJSON, build a short spoken answer ... return std::string("Xăng RON 95 hôm nay 21.000 đồng một lít."); });
구성메모
이름영어 group.action, 소문자 ASCII (vn.weather, timer.set). Gemini에서는 점이 _가 되므로 변환 후에도 고유하고 64자 이내여야 합니다.
설명언제 쓰는지 사용자가 실제로 하는 말과 함께 한두 문장으로. 모델이 보는 것은 이것뿐입니다.
Property(name, kPropertyTypeString)필수 문자열
Property(name, kPropertyTypeString, std::string(""))기본값이 있는 선택 문자열
Property(name, kPropertyTypeInteger, min, max)범위가 있는 필수 정수
Property(name, kPropertyTypeInteger, default, min, max)선택 정수
Property(name, kPropertyTypeBoolean, false)선택 불리언
반환ReturnValue(문자열, bool, int, cJSON*) 또는 ToolResult. 오류면 std::unexpected("message")

도우미: HttpGet(url)(TLS 세션 재사용, 한 번 재시도), UrlEncode(), Between(), CleanXmlText(), Now(&tm)(시간 동기화 전에는 false), 작은 영구 목록용 ListItems()/StoreItems(), 사용자 도시용 LoadConfig().

지침

  • 짧고 읽기 좋은 텍스트를 돌려주세요. 소리 내어 읽힙니다.
  • 네트워크 호출은 약 10초 이내로, 나중 일은 스케줄러에 맡기세요.
  • 코드에 비밀을 넣지 마세요. 공개 엔드포인트나 NVS에 저장된 키를 쓰세요.
  • 웹 UI만 호출해야 하는 도구: mcp.AddUserOnlyTool(...).
  • 도구 목록은 세션마다 전송되니 설명은 간결하게.

2. 테스트

python3 firmware/scripts/validate_data.py # also checks tool names mentioned in prompts firmware/build.sh && firmware/ota.sh bap-xxxx.local curl -s -X POST http://bap-xxxx.local/api/tool -H 'X-Bap: 1' -H 'Content-Type: application/json' \ -d '{"name":"vn.fuel_price","arguments":{"kind":"RON 95"}}'

그다음 자연스럽게 물어보고 시리얼 로그에서 Tool call: vn_fuel_price를 찾으세요.

Last updated on