Repolode
activeagents

activeagents/activeagent

Framework de Ruby on Rails para crear aplicaciones con IA, donde los agentes se implementan como controladores con acciones y vistas.

Estrellas
986
Forks
93
Issues abiertos
45
Último commit
hace 9 horas

¿Qué es?

Active Agent añade una capa de IA a Rails. Los agentes se escriben como clases de Ruby que heredan de ApplicationAgent, con acciones que funcionan como métodos de controlador y plantillas ERB para crear prompts en texto, JSON o HTML.

El framework admite varios proveedores de generación, como OpenAI, Anthropic, Ollama, DeepSeek, OpenRouter y RubyLLM, que permiten acceder a muchos modelos mediante una sola interfaz. La configuración se guarda en un archivo YAML, y un generador configura la clase base del agente y los ajustes. Los agentes pueden llamar a herramientas, transmitir respuestas por ActionCable, mantener el contexto de la conversación y devolver resultados estructurados definidos mediante esquemas JSON.

Una gema aparte, actionagent, ofrece un panel montable con trazas, métricas de uso de tokens y evaluaciones. La CLI activeagent puede ejecutar evaluaciones y hacer que falle una compilación de CI si no se alcanza una tasa de aprobación determinada.

Funciones clave

  • 01Los agentes se definen como clases al estilo de Rails, con acciones y plantillas de prompts ERB.
  • 02Admite los proveedores OpenAI, Anthropic, Ollama, DeepSeek, OpenRouter y RubyLLM.
  • 03Transmite respuestas en tiempo real mediante ActionCable.
  • 04Permite que los agentes llamen a herramientas y deleguen tareas en subagentes mediante esquemas declarados.
  • 05Genera resultados estructurados a partir de esquemas JSON.
  • 06Ofrece una CLI para ejecutar evaluaciones en CI.

Casos de uso

  • Añadir una función de chat o asistente a una aplicación Rails existente.
  • Extraer datos estructurados de imágenes, PDF o texto dentro de una aplicación Rails.
  • Crear flujos de trabajo de agentes con varios pasos, en los que un agente delega tareas en otro.
  • Ejecutar suites de evaluación del comportamiento de los agentes como parte de una canalización de CI.

Inicio rápido

  1. 1

    Añade la gem activeagent a tu Gemfile

    bundle add activeagent
  2. 2

    Añade una gem de proveedor de generación, como OpenAI

    bundle add openai
  3. 3

    Ejecuta el generador de instalación para crear los archivos de configuración

    rails generate active_agent:install
  4. 4

    Genera tu primer agente con acciones

    rails generate active_agent:agent TravelAgent search book confirm

Antes de usarlo

  • Requiere Ruby 3.1 o posterior y una versión compatible de Rails (7.2, 8.0 u 8.1).
  • La mayoría de los proveedores requieren una clave de API o un servicio ejecutado por separado, como Ollama.
  • El panel es una gem independiente, actionagent, que requiere configuración adicional y migraciones de base de datos.

En colecciones

Temas

Preguntas frecuentes

¿Qué es activeagent?
Framework de Ruby on Rails para crear aplicaciones con IA, donde los agentes se implementan como controladores con acciones y vistas. Active Agent añade una capa de IA a Rails. Los agentes se escriben como clases de Ruby que heredan de ApplicationAgent, con acciones que funcionan como métodos de controlador y plantillas ERB para crear prompts en texto, JSON o HTML.
¿activeagent es gratuito? ¿Qué licencia tiene?
activeagent es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿activeagent sigue mantenido?
Mantenimiento activo. El último commit de activeagent fue el 6 nov 2026.
¿Para qué puedo usar activeagent?
Añadir una función de chat o asistente a una aplicación Rails existente. Extraer datos estructurados de imágenes, PDF o texto dentro de una aplicación Rails. Crear flujos de trabajo de agentes con varios pasos, en los que un agente delega tareas en otro. Ejecutar suites de evaluación del comportamiento de los agentes como parte de una canalización de CI.
¿Cómo se instala activeagent?
Añade la gem activeagent a tu Gemfile: bundle add activeagent Añade una gem de proveedor de generación, como OpenAI: bundle add openai Ejecuta el generador de instalación para crear los archivos de configuración: rails generate active_agent:install Genera tu primer agente con acciones: rails generate active_agent:agent TravelAgent search book confirm
¿Dónde consigo activeagent?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/activeagents/activeagent

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados