Repolode
Enviar
activeagents

activeagents/activeagent

Um framework Ruby on Rails para criar apps com IA, em que os agentes são implementados como controllers com actions e views.

Ver no GitHubSite
Estrelas
986
Forks
94
Issues abertas
45
Último commit
ontem

O que é?

Active Agent adiciona uma camada de IA ao Rails. Os agentes são escritos como classes Ruby que herdam de ApplicationAgent, com actions que funcionam como métodos de controller e templates ERB usados para montar prompts em texto, JSON ou HTML.

O framework oferece suporte a vários provedores de geração, incluindo OpenAI, Anthropic, Ollama, DeepSeek, OpenRouter e RubyLLM, que dá acesso a muitos modelos por meio de uma única interface. A configuração fica em um arquivo YAML, e um generator prepara a classe base dos agentes e a configuração. Os agentes podem chamar ferramentas, transmitir respostas via ActionCable, manter o contexto da conversa e retornar saídas estruturadas definidas por JSON schemas.

Uma gem separada, actionagent, oferece um dashboard que pode ser montado na aplicação, com traces, métricas de uso de tokens e avaliações. A CLI activeagent pode executar avaliações e fazer a build de CI falhar se a taxa de aprovação ficar abaixo de um limite definido.

Recursos principais

  • 01Os agentes são definidos como classes no estilo Rails, com actions e templates ERB para prompts.
  • 02Oferece suporte aos provedores OpenAI, Anthropic, Ollama, DeepSeek, OpenRouter e RubyLLM.
  • 03Transmite respostas em tempo real via ActionCable.
  • 04Permite que os agentes chamem ferramentas e deleguem trabalho a subagentes com schemas declarados.
  • 05Gera saídas estruturadas a partir de JSON schemas.
  • 06Oferece uma CLI para executar avaliações em CI.

Casos de uso

  • Adicionar um recurso de chat ou assistente a uma aplicação Rails existente.
  • Extrair dados estruturados de imagens, PDFs ou textos dentro de uma aplicação Rails.
  • Criar fluxos de trabalho de agentes com várias etapas, em que um agente delega tarefas a outro.
  • Executar suítes de avaliação do comportamento dos agentes como parte de um pipeline de CI.

Início rápido

  1. 1

    Adicione a gem activeagent ao seu Gemfile

    bundle add activeagent
  2. 2

    Adicione uma gem de provedor de geração, como OpenAI

    bundle add openai
  3. 3

    Execute o gerador de instalação para criar os arquivos de configuração

    rails generate active_agent:install
  4. 4

    Gere seu primeiro agente com ações

    rails generate active_agent:agent TravelAgent search book confirm

Antes de usar

  • Requer Ruby 3.1 ou superior e uma versão compatível do Rails (7.2, 8.0 ou 8.1).
  • A maioria dos provedores precisa de uma chave de API ou de um serviço executado separadamente, como o Ollama.
  • O painel é uma gem separada, actionagent, que requer configuração adicional e migrações de banco de dados.

Em coleções

Ferramentas, skills e plugins para Claude CodeFrameworks e apps de agentes de IA open sourceFerramentas de streaming

Tópicos

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

Perguntas frequentes

O que é activeagent?
Um framework Ruby on Rails para criar apps com IA, em que os agentes são implementados como controllers com actions e views. Active Agent adiciona uma camada de IA ao Rails. Os agentes são escritos como classes Ruby que herdam de ApplicationAgent, com actions que funcionam como métodos de controller e templates ERB usados para montar prompts em texto, JSON ou HTML.
activeagent é gratuito? Qual é a licença?
activeagent é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
activeagent ainda é mantido?
Manutenção ativa. O último commit de activeagent foi em 6 de nov. de 2026.
Para que posso usar activeagent?
Adicionar um recurso de chat ou assistente a uma aplicação Rails existente. Extrair dados estruturados de imagens, PDFs ou textos dentro de uma aplicação Rails. Criar fluxos de trabalho de agentes com várias etapas, em que um agente delega tarefas a outro. Executar suítes de avaliação do comportamento dos agentes como parte de um pipeline de CI.
Como instalar activeagent?
Adicione a gem activeagent ao seu Gemfile: bundle add activeagent Adicione uma gem de provedor de geração, como OpenAI: bundle add openai Execute o gerador de instalação para criar os arquivos de configuração: rails generate active_agent:install Gere seu primeiro agente com ações: rails generate active_agent:agent TravelAgent search book confirm
Onde consigo activeagent?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/activeagents/activeagent

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados