Agents-Flex란?
Agents-Flex는 통일된 모델 호출을 시작점으로 하여, 필요에 따라 에이전트, RAG, 멀티모달, OCR, Skills 및 관찰 가능 기능을 자유롭게 조합할 수 있도록 지원합니다. 비즈니스 아키텍처를 명확히 유지하면서도 비동기 작업 메커니즘을 통해 장시간 작업에 대한 복구 및 생산 수준의 실행 보장을 제공합니다.
주요 기능
인간 승인, 예산 제어, 재시도, 일시 중단 및 재개를 지원하는 에이전트 런타임(Agent Runtime)을 제공합니다.
문서 추출, 분할, Embedding, Rerank 및 다양한 벡터 데이터베이스(Vector Store)와의 통합을 제공하는 RAG 및 지식 저장 기능을 갖추고 있습니다.
활용 사례와 대상
Java 개발자, 특히 생산 환경에서 관찰 가능하고 거버넌스가 가능하며 오케스트레이션 가능한 AI 애플리케이션과 에이전트를 구축해야 하는 기업급 팀에게 적합합니다.
- Java 개발자를 대상으로 AI 애플리케이션과 에이전트를 구축하며, 모델 호출, 에이전트 오케스트레이션, RAG 지식 검색, 멀티모달 처리(이미지 생성/OCR/음성/TTS/STT/비디오) 및 Skills의 패키징과 격리 실행을 지원합니다.
- 생산 환경에서 비디오 생성, OCR 처리와 같은 장시간 비동기 작업을 실행하며, 일시 중지, 재개, 인력 승인 및 예산 관리를 지원합니다.
- 통합 Java 인터페이스를 통해 다양한 기능을 통합합니다: ChatModel 대화, ImageModel 이미지 생성, OcrModel 문서 인식, VideoModel 비디오 생성, TextToSpeech 음성 합성 등.
텍스트 프롬프트(Prompt), 이미지 파일(PNG/JPG/PDF), 음성 오디오 스트림, 비디오 생성 요청 파라미터, OCR 요청 객체(OcrRequest), Skill 스크립트 및 리소스(scripts/, assets/) 등을 지원합니다.
스트리밍 또는 동기식 텍스트 응답(ChatModel), 이미지 생성(ImageModel), 음성 합성 오디오(TextToSpeech), 음성 인식 텍스트(SpeechToText), OCR 해석 결과(텍스트/마크다운/리소스 링크), 비디오 작업 상태 및 다운로드 주소(VideoModel), 구조화된 Tool Calling 출력, 관찰 가능성 이벤트 및 스냅샷(Turn Store, Events) 등을 제공합니다.
자주 묻는 질문
Agents-Flex은 반드시 Spring 프레임워크에 의존하나요?
아니요, Agents-Flex는 Spring을 강제로 의존하지 않으며, 단지 선택적인 Spring AI 호환 계층만 제공합니다.
OCR 및 비디오 생성과 같은 기능의 결과는 어떻게 얻을 수 있나요?
OCR 및 비디오 생성은 비동기 작업으로, 제출 후 TaskStatus를 통해 상태를 조회한 뒤, 완료된 후에야 OcrResponse 또는 비디오 리소스를 얻을 수 있습니다.
사용 방법
- 01
Agents-Flex Java SDK를 가져옵니다(지원 버전: JDK 8+, 라이선스: Apache 2.0 오픈소스).
- 02
OpenAIChatConfig 또는 기타 모델을 구성합니다(.apiKey(System.getenv("AI_API_KEY")) 및 .model("your-model" 등).
- 03
model.chat("Agents-Flex을 한 문장으로 소개해 주세요.")를 호출하여 기본 대화를 시작합니다.
- 04
필요에 따라 확장 가능: RAG 저장소 연동, Skill 스크립트 정의, Sandbox 격리 실행 활성화 또는 Agent 실행 시 정책 추가.
공식 웹사이트 및 출처
자료 업데이트 2026-10-30
