함수 호출을 사용하면 생성형 모델에서 구조화된 데이터 출력을 더 쉽게 가져올 수 있습니다. 그런 다음 이러한 출력을 사용하여 다른 API를 호출하고 관련 응답 데이터를 모델에 반환할 수 있습니다. 즉, 함수 호출을 사용하면 생성형 모델을 외부 시스템에 연결하여 생성된 콘텐츠에 최신 정보와 정확한 정보를 포함할 수 있습니다.
Gemini 모델에 함수 설명을 제공할 수 있습니다. 앱의 언어로 작성하는 함수입니다 (즉, Google Cloud Functions가 아님). 모델이 쿼리를 처리하는 데 도움이 되도록 함수를 호출하고 결과를 다시 전송하도록 요청할 수 있습니다.
아직 확인하지 않았다면 함수 호출 소개를 참고하여 자세히 알아보세요.
조명 제어 API 예시
애플리케이션 프로그래밍 인터페이스 (API)가 있는 기본 조명 제어 시스템이 있고 사용자가 간단한 텍스트 요청을 통해 조명을 제어할 수 있도록 허용하려고 한다고 가정해 보겠습니다. 함수 호출 기능을 사용하여 사용자의 조명 변경 요청을 해석하고 이를 API 호출로 변환하여 조명 값을 설정할 수 있습니다. 이 가상의 조명 제어 시스템을 사용하면 조명의 밝기와 색온도를 제어할 수 있습니다. 색온도는 두 개의 별도 매개변수로 정의됩니다.
| 매개변수 | 유형 | 필수 | 설명 |
|---|---|---|---|
brightness |
숫자 | 예 | 밝기 수준(0~100) 0은 꺼짐이고 100은 최대 밝기입니다. |
colorTemperature |
문자열 | 예 | 조명기구의 색상 온도(daylight, cool 또는 warm)입니다. |
편의상 이 가상의 조명 시스템에는 조명이 하나만 있으므로 사용자는 방이나 위치를 지정할 필요가 없습니다. 다음은 조명 제어 API에 전송하여 일광 색온도를 사용하여 조명 수준을 50%로 변경할 수 있는 JSON 요청의 예입니다.
{
"brightness": "50",
"colorTemperature": "daylight"
}
이 튜토리얼에서는 Gemini API의 함수 호출을 설정하여 사용자 조명 요청을 해석하고 이를 API 설정에 매핑하여 조명의 밝기 및 색온도 값을 제어하는 방법을 보여줍니다.