googleapis/java-genai

해결하는 문제

Google의 Gemini Developer API 및 Gemini Enterprise Agent Platform API와 상호작용할 수 있는 Java에 적합한 소프트웨어 개발 키트(SDK)를 제공하여, 이러한 생성형 AI 모델에 접근하기 위해 원시 HTTP 요청을 작성할 필요가 없도록 합니다.

작동 방식

SDK는 Client 클래스를 사용하여 Gemini Developer 백엔드(API 키를 통해) 또는 Gemini Enterprise Agent Platform(프로젝트/위치 또는 API 키를 통해)에 연결을 관리합니다. API 호출을 Java 메서드로 추상화하여 개발자가 다음을 수행할 수 있도록 합니다:

• 콘텐츠 생성: 단일, 스트리밍, 비동기 호출을 사용하여 텍스트 또는 멀티모달 응답(텍스트 및 이미지)을 생성합니다.
• 모델 동작 구성: GenerateContentConfig를 통해 시스템 지시사항, 안전 설정, 사고 예산을 설정합니다.
• 도구 통합: Java 메서드를 도구로 전달하여 자동 함수 호출(AFC)을 구현할 수 있으며, SDK가 클라이언트 측에서 실행할 수 있습니다.
• 네트워크 맞춤 설정: HttpOptions(타임아웃, 재시도, 기본 URL) 및 ClientOptions(연결 풀, 프록시, 사용자 정의 OkHttpClient 인스턴스)를 사용하여 HTTP 동작을 세밀하게 조정합니다.

대상 사용자

개인 프로젝트에서 Developer API를 사용하거나 Google Cloud Platform에서 엔터프라이즈 수준 애플리케이션을 구축하는 Java 개발자.

주요 특징

• 이중 백엔드 지원: Gemini Developer와 Gemini Enterprise Agent Platform API 간을 원활하게 전환 가능.
• 자동 함수 호출: 모델이 로컬 Java 메서드를 자동으로 트리거할 수 있도록 도구 사용을 간소화.
• 유연한 실행: 표준, 스트리밍, 비동기 응답 패턴을 모두 지원.
• 구조화된 출력: 모델이 특정 형식으로 데이터를 반환하도록 보장하는 JSON 응답 스키마를 지원.
• 강력한 네트워킹: 내장된 재시도 로직과 사용자 정의 프록시 및 HTTP 클라이언트 지원을 포함.