도구는 Gemini 모델의 기능을 확장하여 모델이 실제 상황에서 조치를 취하고, 실시간 정보에 액세스하고, 복잡한 계산 작업을 실행할 수 있도록 지원합니다. 모델은 Live API를 사용하여 표준 요청-응답 상호작용과 실시간 스트리밍 세션 모두에서 도구를 사용할 수 있습니다.
도구는 모델이 질문에 답변하는 데 사용할 수 있는 특정 기능 (예: Google 검색 또는 코드 실행)입니다. Gemini API는 완전 관리형 기본 제공 도구 모음을 제공하며, 함수 호출을 사용하여 맞춤 도구를 정의할 수도 있습니다.
다단계 목표 지향 시스템을 빌드하려면 에이전트 개요를 참고하세요.
사용 가능한 기본 제공 도구
| 도구 | 설명 | 사용 사례 |
|---|---|---|
| Google 검색 | 웹의 최신 이벤트와 사실에 기반하여 대답을 그라운딩하여 할루시네이션을 줄입니다. | \- 최근 이벤트에 대한 질문에 답변 \- 다양한 소스를 통해 사실 확인 |
| Google 지도 | 장소를 찾고, 길을 안내하고, 풍부한 지역 컨텍스트를 제공할 수 있는 위치 인식 어시스턴트를 빌드하세요. | - 여러 경유지가 있는 여행 일정 계획 - 사용자 기준에 따라 현지 비즈니스 찾기 |
| 코드 실행 | 모델이 Python 코드를 작성하고 실행하여 수학 문제를 해결하거나 데이터를 정확하게 처리하도록 허용합니다. | \- 복잡한 수학 방정식 풀이 \- 텍스트 데이터를 정확하게 처리하고 분석 |
| URL 컨텍스트 | 모델이 특정 웹페이지 또는 문서의 콘텐츠를 읽고 분석하도록 지시합니다. | \- 특정 URL 또는 문서를 기반으로 질문에 답변 \- 여러 웹페이지에서 정보 검색 |
| 컴퓨터 사용 (미리보기) | Gemini가 화면을 보고 웹브라우저 UI와 상호작용하는 작업을 생성하도록 지원합니다 (클라이언트 측 실행). | \- 반복적인 웹 기반 워크플로 자동화 \- 웹 애플리케이션 사용자 인터페이스 테스트 |
| 파일 검색 | 자체 문서를 색인 생성하고 검색하여 검색 증강 생성 (RAG)을 사용 설정합니다. | - 기술 설명서 검색 - 독점 데이터를 기반으로 한 질의 응답 |
특정 도구와 관련된 비용에 대한 자세한 내용은 가격 책정 페이지를 참고하세요.
도구 실행 작동 방식
도구를 사용하면 모델이 대화 중에 작업을 요청할 수 있습니다. 흐름은 도구가 내장되어 있는지 (Google에서 관리) 또는 맞춤설정되어 있는지 (사용자가 관리)에 따라 다릅니다.
기본 제공 도구 흐름
기본 제공 도구 (Google 검색, Google 지도, URL 컨텍스트, 파일 검색, 코드 실행)의 경우 전체 프로세스가 하나의 API 호출 내에서 이루어집니다.
- 사용자가 프롬프트를 보냅니다. 'GOOG의 최신 주가의 제곱근은 뭐야?'
- Gemini는 도구가 필요하다고 판단하고 Google 서버에서 도구를 실행합니다(예: 주가를 검색한 다음 Python 코드를 실행하여 제곱근을 계산).
- Gemini가 도구 결과를 기반으로 한 최종 대답을 다시 보냅니다.
맞춤 도구 흐름 (함수 호출)
맞춤 도구 및 Computer Use의 경우 애플리케이션에서 실행을 처리합니다.
- 사용자가 함수 (도구) 선언과 함께 프롬프트를 전송합니다.
- Gemini는 항상 고유한
id와 함께 특정 함수(예:{"name": "get_order_status", "args": {"order_id": "123"}})를 호출하기 위해 구조화된 JSON을 다시 전송할 수 있습니다. - 사용자가 애플리케이션 또는 환경에서 함수를 실행합니다.
- 사용자는 함수 호출과 동일한
id를 사용하여 함수 결과를 Gemini에 다시 보냅니다. - Gemini는 결과를 사용하여 최종 대답이나 다른 도구 호출을 생성합니다.
자세한 내용은 함수 호출 가이드를 참고하세요.
기본 제공 도구와 맞춤 도구 흐름 결합
기본 제공 도구와 맞춤 도구 (함수 호출)를 결합하는 요청의 경우 모델은 도구 컨텍스트 순환을 사용하여 다양한 환경에서 실행을 조정합니다.
- 사용자가 프롬프트를 보내고 사용 설정하려는 내장 도구와 맞춤 함수를 선언하여 조합 지원을 사용 설정하는 플래그를 설정합니다.
- Gemini는 내장 도구를 실행하고 클라이언트 측 함수 호출이 생성되면 사용자에게 양보합니다 (먼저 실행되는 것은 프롬프트와 모델의 결정에 따라 다름). 다음과 같은 응답을 다시 보냅니다.
- 도구 호출 확인
- 도구 응답 결과 (모델에서 병렬 함수 호출을 두 개 생성한 경우 JSON 뒤에 올 수 있음)
- 함수를 호출하는 구조화된 JSON
- 컨텍스트를 보존하기 위해 암호화된 생각 서명
- 사용자가 애플리케이션 또는 환경에서 함수를 실행합니다.
- 사용자는 Gemini의 응답의 모든 부분과 함수 호출 결과를 반환합니다.
- Gemini는 결합된 모든 컨텍스트를 사용하여 최종 대답을 생성합니다.
도구 조합 가이드를 읽고 기본 제공 도구와 맞춤 도구 조합 지원을 사용 설정하는 방법과 컨텍스트 순환의 예를 알아보세요.
구조화된 출력과 함수 호출 비교
Gemini는 구조화된 출력을 생성하는 두 가지 방법을 제공합니다. 모델이 자체 도구 또는 데이터 시스템에 연결하여 중간 단계를 실행해야 하는 경우 함수 호출을 사용합니다. 맞춤 UI를 렌더링하는 등 모델의 최종 대답이 특정 스키마를 엄격하게 준수해야 하는 경우 구조화된 출력을 사용하세요.
도구를 사용한 구조화된 출력
구조화된 출력을 내장 도구와 결합하여 외부 데이터 또는 계산에 기반한 모델 응답이 엄격한 스키마를 준수하도록 할 수 있습니다.
코드 예시는 도구를 사용한 구조화된 출력을 참고하세요.