activeagents/activeagent

해결하는 문제

Active Agent는 Ruby on Rails 애플리케이션에 AI를 통합하기 위한 구조화된 프레임워크를 제공합니다. LLM을 비구조적으로 통합하는 대신 "에이전트 지향 프로그래밍"을 도입하여, 에이전트를 모듈화되고 재사용 가능한 컴포넌트( Rails의 컨트롤러와 유사)로 다루어 AI 기반 앱의 코드 유지보수성과 확장성을 향상시킵니다.

작동 방식

이 프레임워크는 개발자가 기본 에이전트 클래스를 상속하는 Ruby 클래스로 에이전트를 정의할 수 있도록 합니다. 이러한 에이전트는 구성 파일을 통해 다양한 LLM 제공자(OpenAI, Anthropic, Ollama 등)를 사용하도록 구성할 수 있습니다. 개발자는 이러한 에이전트 클래스 내의 메서드로 "작업"을 정의하여 특정 AI 작업을 캡슐화합니다. 시스템은 ERB를 사용한 프롬프트 템플릿, ActionCable를 통한 스트리밍 응답, 구조화된 JSON 출력을 지원합니다.

대상 사용자

AI 로직에 구조화된 아키텍처 계층을 적용하고자 하며, 익숙한 객체 지향 Ruby 패턴을 사용하고자 하는 Ruby on Rails 개발자.

주요 기능

• 에이전트 지향 프로그래밍: 익숙한 패턴을 사용해 AI 로직을 Rails 프레임워크에 통합.
• 다중 제공자 지원: OpenAI, Anthropic, Ollama, RubyLLM와 호환.
• 다중 모달 기능: 이미지, PDF, 텍스트에서 데이터 추출을 지원.
• 에이전트 위임: 주 에이전트가 정의된 계약과 예산(비용/지연 시간)을 가진 하위 에이전트에게 작업을 위임할 수 있음.
• 도구/함수 호출: 에이전트가 도구를 통해 외부 서비스와 상호작용할 수 있음.
• 관측성 대시보드: 선택적 보조 gem(actionagent)은 추적, 토큰 사용량, 에이전트별 메트릭을 제공.