한 장의 그림으로 이해하기

그림 크게 보기 ↗ (새 탭)
모델·API · 판정 관망
그림을 글로 풀면
호출 제안과 실행 결과
Gemini의 사용자 정의 함수 호출 제안과 앱의 실제 실행 결과를 나눠 기록합니다.
- 대상
- 모델에 자체 조회 도구를 연결하는 개발자
- 무엇이 바뀜
- 함수 이름과 인수를 받아 앱에서 실행합니다.
- 왜 중요한가
- 호출 제안만으로 업무 완료를 확정할 수 없습니다.
- 지금 할 일
- 허용 함수·인수를 검토하고 실행 결과를 연결하세요.
- 한계·미확인
- 개념 비유. Gemini API·함수 호출·자료 조회 시험 없음.
- 공식 출처
- ai.google.dev
- 확인일
- 2026-10-16
작업 제안서가 왔을 때 남길 상태
가상의 문서 조회 도구에서 모델이 조회 함수와 검색 조건을 반환했다고 가정합니다. 그림 왼쪽의 자료함은 아직 닫혀 있습니다. 이 시점에 작업을 완료로 저장하면 앱이 실제 자료를 읽었는지 빠뜨릴 수 있습니다. AINOW는 제안을 받음, 실행을 시도함, 결과를 확인함을 구분하는 기록을 제안합니다.
사용자 정의 함수는 앱에서 실행하기
Gemini 공식 문서의 사용자 정의 함수 흐름에서는 모델이 함수 자체를 실행하지 않습니다. 앱이 반환된 이름과 인수를 꺼내 자신의 실행 코드를 호출하고 결과를 모델로 보내 후속 응답을 받습니다. 이 글은 그 수동 연결 흐름을 설명합니다. SDK의 자동 처리 기능을 쓰는 경우에는 해당 설정과 실제 실행 기록을 확인해야 하며 서버 내장 도구의 동작과도 구분해야 합니다.
반환값을 확인한 뒤 업무 결과로 연결하기
AINOW는 실행 전에 허용한 함수인지, 인수 형식과 접근 범위가 맞는지 확인하고 실행 후 성공·실패 결과를 원래 호출과 연결하도록 제안합니다. 실패했거나 실행하지 않은 조회를 빈 결과로 꾸미지 마세요. 모델의 자연어 완료 문구도 실제 시스템 기록과 대조해야 합니다. 이번 확인은 공식 문서 열람이며 API 요청, 자료 조회나 실행 실패 재현은 하지 않았습니다.
참고 원문: Google Gemini 공식 문서 — 사용자 정의 함수 호출 흐름 · 원문 게시일 상시 문서(확인일 기준) · 확인일 2026-10-16
AI 작성·자동 검증: 공식 자료와의 대조 및 게시 구조 검사. 사람의 개별 검수와 제품 실행 시험은 수행하지 않았습니다. 그림은 신규 생성한 개념 일러스트입니다.
이 글의 검증 카드
- 자료 버전
- Gemini Function calling 상시 문서, 2026-10-16 확인. 사용자 정의 함수의 수동 실행 흐름·앱 책임. API·도구 실행 없음
- 확인일
- 2026-10-16
- 검증 상태
- 개발자 주장
- 한계·주의
- 개념 비유. Gemini API·함수 호출·자료 조회 시험 없음.
함께 더 정확하게
질문·오류 제보
그림에서 이해되지 않는 부분이나 달라진 내용을 알려 주세요. 관리자가 확인하고 승인한 글만 공개됩니다.
개발에서는 이메일 인증 가입 또는 관리자 발급 계정으로 참여할 수 있습니다. 계정·이용 문의
아직 계정이 없으신가요? 회원가입
공개된 질문·제보
아직 공개된 질문·제보가 없습니다. 궁금한 부분을 먼저 남겨 주세요.