Repolode
제출하기
activeagents

activeagents/activeagent

액션과 뷰를 갖춘 컨트롤러로 에이전트를 구현해 AI 기반 앱을 만드는 Ruby on Rails 프레임워크입니다.

GitHub에서 보기웹사이트
스타
986
포크
93
열린 이슈
45
마지막 커밋
13시간 전

어떤 프로젝트인가요?

Active Agent는 Rails에 AI 기능을 더합니다. 에이전트는 ApplicationAgent를 상속하는 Ruby 클래스로 작성하며, 컨트롤러 메서드처럼 동작하는 액션과 텍스트, JSON 또는 HTML 형식의 프롬프트를 구성하는 ERB 템플릿을 사용합니다.

이 프레임워크는 OpenAI, Anthropic, Ollama, DeepSeek, OpenRouter, RubyLLM 등 여러 생성형 AI 제공자를 지원해 하나의 인터페이스로 다양한 모델을 사용할 수 있습니다. 설정은 YAML 파일에 저장하며, 제너레이터가 기본 에이전트 클래스와 설정 파일을 생성합니다. 에이전트는 도구를 호출하고, ActionCable로 응답을 스트리밍하고, 대화 맥락을 유지하며, JSON Schema로 정의한 구조화된 출력을 반환할 수 있습니다.

별도의 gem인 actionagent는 트레이스, 토큰 사용량 지표, 평가 결과를 확인할 수 있는 마운트형 대시보드를 제공합니다. activeagent 커맨드라인 도구로 평가를 실행하고, 통과율이 지정한 기준보다 낮으면 CI 빌드를 실패 처리할 수 있습니다.

핵심 기능

  • 01Rails 스타일의 클래스와 액션, ERB 프롬프트 템플릿으로 에이전트를 정의합니다.
  • 02OpenAI, Anthropic, Ollama, DeepSeek, OpenRouter, RubyLLM 제공자를 지원합니다.
  • 03ActionCable을 통해 실시간으로 응답을 스트리밍합니다.
  • 04에이전트가 도구를 호출하고 선언된 스키마에 따라 하위 에이전트에 작업을 위임할 수 있습니다.
  • 05JSON Schema를 기반으로 구조화된 출력을 생성합니다.
  • 06CI에서 평가를 실행할 수 있는 커맨드라인 도구를 제공합니다.

활용 사례

  • 기존 Rails 애플리케이션에 채팅 또는 어시스턴트 기능을 추가합니다.
  • Rails 앱에서 이미지, PDF 또는 텍스트의 구조화된 데이터를 추출합니다.
  • 에이전트가 다른 에이전트에 작업을 위임하는 다단계 워크플로를 구축합니다.
  • CI 파이프라인의 일부로 에이전트 동작 평가 스위트를 실행합니다.

빠른 시작

  1. 1

    Gemfile에 activeagent gem을 추가합니다

    bundle add activeagent
  2. 2

    OpenAI와 같은 생성 provider gem을 추가합니다

    bundle add openai
  3. 3

    install generator를 실행해 설정 파일을 생성합니다

    rails generate active_agent:install
  4. 4

    액션이 포함된 첫 번째 에이전트를 생성합니다

    rails generate active_agent:agent TravelAgent search book confirm

사용 전 알아둘 점

  • Ruby 3.1 이상과 지원되는 Rails 버전(7.2, 8.0 또는 8.1)이 필요합니다.
  • 대부분의 provider는 API 키 또는 Ollama처럼 별도로 실행되는 서비스가 필요합니다.
  • 대시보드는 별도의 gem인 actionagent로 제공되며, 추가 설정과 데이터베이스 마이그레이션이 필요합니다.

포함된 컬렉션

Claude Code 도구·스킬·플러그인오픈소스 AI 에이전트 프레임워크와 앱스트리밍 도구

토픽

#ruby#rails#llm#agents#openai#anthropic#streaming#tool-calling

자주 묻는 질문

activeagent은(는) 무엇인가요?
액션과 뷰를 갖춘 컨트롤러로 에이전트를 구현해 AI 기반 앱을 만드는 Ruby on Rails 프레임워크입니다. Active Agent는 Rails에 AI 기능을 더합니다. 에이전트는 ApplicationAgent를 상속하는 Ruby 클래스로 작성하며, 컨트롤러 메서드처럼 동작하는 액션과 텍스트, JSON 또는 HTML 형식의 프롬프트를 구성하는 ERB 템플릿을 사용합니다.
activeagent은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
activeagent은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
activeagent은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. activeagent의 마지막 커밋은 2026년 11월 6일입니다.
activeagent은(는) 어디에 사용할 수 있나요?
기존 Rails 애플리케이션에 채팅 또는 어시스턴트 기능을 추가합니다. Rails 앱에서 이미지, PDF 또는 텍스트의 구조화된 데이터를 추출합니다. 에이전트가 다른 에이전트에 작업을 위임하는 다단계 워크플로를 구축합니다. CI 파이프라인의 일부로 에이전트 동작 평가 스위트를 실행합니다.
activeagent는 어떻게 설치하나요?
Gemfile에 activeagent gem을 추가합니다: bundle add activeagent OpenAI와 같은 생성 provider gem을 추가합니다: bundle add openai install generator를 실행해 설정 파일을 생성합니다: rails generate active_agent:install 액션이 포함된 첫 번째 에이전트를 생성합니다: rails generate active_agent:agent TravelAgent search book confirm
activeagent은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/activeagents/activeagent

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트