Repolode
MaestroError

MaestroError/LarAgent

Framework PHP para crear agentes de IA en proyectos Laravel, con una API de estilo Eloquent, herramientas, historial de chat y compatibilidad con varios proveedores.

Estrellas
645
Forks
56
Issues abiertos
7
Último commit
hace 3 meses

¿Qué es?

LarAgent es un framework para crear agentes de IA dentro de aplicaciones Laravel. Los agentes se definen como clases muy similares a los modelos Eloquent, con propiedades para el modelo, el proveedor, el historial de chat y las herramientas, además de un comando artisan para generarlos. Los desarrolladores pueden agregar herramientas como métodos anotados con atributos o como clases, y ejecutar un agente por usuario o con un nombre de historial personalizado.

El framework incluye los componentes habituales para trabajar con agentes: varios backends para el historial de chat, como almacenamiento en memoria y en caché; salida estructurada; entrada de imágenes; y llamadas paralelas a herramientas, que se pueden desactivar. Los proveedores se pueden configurar para cada agente, y una lista ordenada de proveedores permite cambiar automáticamente a proveedores alternativos. Un sistema de eventos ofrece hooks en las interacciones con los agentes, y estos se pueden exponer mediante una API compatible con OpenAI. También admite servidores MCP como fuente de herramientas.

LarAgent requiere PHP 8.3 o superior y Laravel 10.x o superior, y también se puede usar fuera de Laravel en modo independiente. Se distribuye como el paquete Composer maestroerror/laragent bajo la licencia MIT.

Funciones clave

  • 01Definir agentes como clases de estilo Eloquent, generadas con un comando artisan.
  • 02Agregar herramientas como métodos anotados o clases, con ejecución paralela opcional.
  • 03Almacenar el historial de chat en memoria, caché, JSON y otros backends, por usuario o con un nombre personalizado.
  • 04Cambio automático entre proveedores de LLM en una lista ordenada.
  • 05Compatibilidad con salida estructurada y entrada de imágenes.
  • 06Hooks de eventos en las interacciones con los agentes y exposición mediante una API compatible con OpenAI.

Casos de uso

  • Agregar un asistente conversacional a un producto Laravel existente.
  • Automatizar operaciones internas con agentes que utilizan herramientas de la aplicación.
  • Crear experiencias de chat por usuario con el historial de conversación almacenado.
  • Ejecutar agentes con proveedores alternativos para reducir las interrupciones causadas por un único proveedor de LLM.

Inicio rápido

  1. 1

    Instala el paquete con Composer

    composer require maestroerror/laragent
  2. 2

    Publica el archivo de configuración

    php artisan vendor:publish --tag="laragent-config"
  3. 3

    Genera tu primer agente

    php artisan make:agent YourAgentName

Antes de usarlo

  • Requiere Laravel 10.x o superior y PHP 8.3 o superior.
  • Para ejecutar agentes, necesitas una clave API de un proveedor de LLM, como OpenAI.

En colecciones

Temas

Preguntas frecuentes

¿Qué es LarAgent?
Framework PHP para crear agentes de IA en proyectos Laravel, con una API de estilo Eloquent, herramientas, historial de chat y compatibilidad con varios proveedores. LarAgent es un framework para crear agentes de IA dentro de aplicaciones Laravel. Los agentes se definen como clases muy similares a los modelos Eloquent, con propiedades para el modelo, el proveedor, el historial de chat y las herramientas, además de un comando artisan para generarlos. Los desarrolladores pueden agregar herramientas como métodos anotados con atributos o como clases, y ejecutar un agente por usuario o con un nombre de historial personalizado.
¿LarAgent es gratuito? ¿Qué licencia tiene?
LarAgent es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿LarAgent sigue mantenido?
Actualizado en los últimos 6 meses. El último commit de LarAgent fue el 20 ago 2026.
¿Para qué puedo usar LarAgent?
Agregar un asistente conversacional a un producto Laravel existente. Automatizar operaciones internas con agentes que utilizan herramientas de la aplicación. Crear experiencias de chat por usuario con el historial de conversación almacenado. Ejecutar agentes con proveedores alternativos para reducir las interrupciones causadas por un único proveedor de LLM.
¿Cómo se instala LarAgent?
Instala el paquete con Composer: composer require maestroerror/laragent Publica el archivo de configuración: php artisan vendor:publish --tag="laragent-config" Genera tu primer agente: php artisan make:agent YourAgentName
¿Dónde consigo LarAgent?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/MaestroError/LarAgent

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

Proyectos relacionados