Gemini Function Calling & 서드파티 API 커스텀 툴 융합 개발

Function Calling(함수 호출)의 동작 원리

AI 모델 자체는 실시간 날씨 데이터나 사내 데이터베이스를 직접 조회할 수 없습니다.

Function Calling 기능을 사용하면 Gemini가 유저의 질문을 분석한 후, "이 질문을 해결하려면 외부 함수 get_current_weather(city='Seoul')을 이 인자값으로 실행하라"는 실행 요청을 반환합니다.

4단계 Function Calling 시퀀스

1. 유저 질문: "현재 서울 마포구 날씨 어때?"
2. Gemini ➔ 앱: `get_weather(location="마포구")` 실행 명령 전달
3. 앱 ➔ 외부 API: 실제 기상청 REST API 호출 및 결과 "맑음, 24도" 수집
4. 앱 ➔ Gemini: 수집된 날씨 결과 전달
5. Gemini ➔ 유저: "현재 서울 마포구 날씨는 24도로 쾌청하고 맑습니다." 완성된 정답 응답

💡 핵심 Gemini AI 용어 사전 (Glossary)

• Function Calling (함수 호출): AI 모델이 외부 코드, API, 데이터베이스 쿼리를 직접 실행할 수 있도록 연결 고리를 제공하는 기능.
• Tool Use (도구 활용): AI 에이전트가 주도적으로 계산기, 웹 검색, 코드 실행기 등의 도구를 선택하여 문제를 해결하는 능력.
• Tool Declaration: Gemini에게 제공할 함수의 이름, 설명, 매개변수 타입을 정의하는 인터페이스 선언.

Function Calling 체크리스트

• [ ] 제공할 함수의 파라미터 타입과 docstring 설명이 명확한가?
• [ ] 외부 API 오류 발생 시 예외 처리 리턴값이 수립되어 있는가?