spring-ai-community/spring-ai-agent-utils

해결하는 문제

Spring AI Agent Utils는 Claude Code에서 영감을 받은 일련의 사전 구축된 도구와 기능을 제공하여, Java 개발자가 로컬 환경과 상호 작용하고, 작업을 관리하며, 장기 기억을 유지하는 정교한 AI 에이전트를 구축할 수 있도록 합니다. 이는 고수준 에이전트 프레임워크와 Spring AI 생태계 사이의 간극을 메우며, 에이전트가 코딩 어시스턴트나 범용 자율 에이전트로 작동하는 데 필요한 "기술"을 제공합니다.

작동 방식

이 라이브러리는 Spring AI ChatClient에 등록할 수 있는 일련의 도구를 구현합니다. 이러한 도구를 통해 모델은 파일 읽기/쓰기, 셸 명령 실행, 웹 검색, 구조화된 할 일 목록 관리와 같은 작업을 수행할 수 있습니다. 또한 복잡한 작업을 전문 에이전트에 위임하기 위한 하위 에이전트 시스템과 샌드박스 파일 기반 스토리지를 사용하여 대화 전반에 걸쳐 정보를 유지하는 메모리 시스템을 도입합니다.

대상 사용자

AI 코딩 어시스턴트, 자율 작업 관리자 또는 확장 가능한 지식 모듈을 갖춘 전문 AI 에이전트와 같은 에이전트 애플리케이션을 구축하려는 Spring AI 사용 Java 개발자.

주요 특징

• 핵심 환경 도구: FileSystemTools, ShellTools, LgrepTool, GlobTool을 포함하여 로컬 파일 시스템 및 셸과 깊이 있게 상호 작용합니다.
• 웹 액세스: BraveWebSearchTool 및 SmartWebFetchTool이 통합되어 실제 정보 검색이 가능합니다.
• 장기 기억: AutoMemoryTools 및 AutoMemoryToolsAdvisor는 세션 전반에 걸쳐 유지되는 파일 기반의 영구 메모리를 제공합니다.
• 에이전트 오케스트레이션: TaskTools 및 TodoWriteTool을 통해 구조화된 작업 관리와 전문 하위 에이전트로의 위임이 가능합니다.
• 확장 가능한 기술: SkillsTool을 사용하면 YAML front-matter가 포함된 Markdown으로 정의된 재사용 가능한 지식 모듈을 추가할 수 있습니다.
• 취소 가능한 턴: InterruptAdvisor를 통해 에이전트 루프를 협력적으로 취소(예: 정지 버튼이나 예산 가드 등을 통해)할 수 있습니다.
• 관측 가능성: ToolCallListener는 모든 도구 호출에 대한 감사 로그와 메트릭을 제공합니다.