Repolode
Enviar
MaestroError

MaestroError/LarAgent

Framework PHP para criar agentes de IA em projetos Laravel, com API no estilo Eloquent, ferramentas, histórico de conversas e suporte a vários provedores.

Ver no GitHubSite
Estrelas
645
Forks
56
Issues abertas
7
Último commit
há 3 meses

O que é?

LarAgent é um framework para criar agentes de IA em aplicações Laravel. Os agentes são definidos como classes parecidas com modelos Eloquent, com propriedades para o modelo, o provedor, o histórico de conversas e as ferramentas, além de um comando artisan para gerá-los. Os desenvolvedores podem adicionar ferramentas como métodos ou classes anotados com atributos e executar um agente por usuário ou com um nome de histórico personalizado.

O framework reúne os recursos comuns para criar agentes: vários backends de histórico de conversas, como armazenamento em memória e em cache, saída estruturada, entrada de imagens e chamadas paralelas de ferramentas, que podem ser desativadas. Os provedores podem ser configurados por agente, e uma lista ordenada de provedores permite o failover automático para provedores de fallback. Um sistema de eventos disponibiliza hooks em diferentes etapas das interações com os agentes, que também podem ser expostos por uma API compatível com OpenAI. O framework também aceita servidores MCP como fonte de ferramentas.

LarAgent requer PHP 8.3 ou superior e Laravel 10.x ou superior, mas também pode ser usado fora do Laravel em modo standalone. É distribuído como o pacote Composer maestroerror/laragent, sob a licença MIT.

Recursos principais

  • 01Defina agentes como classes no estilo Eloquent e gere-as com um comando artisan.
  • 02Adicione ferramentas como métodos ou classes anotados, com execução paralela opcional.
  • 03Armazene o histórico de conversas em memória, cache, JSON e outros backends, por usuário ou com um nome personalizado.
  • 04Failover automático entre uma lista ordenada de provedores de LLM.
  • 05Suporte a saída estruturada e entrada de imagens.
  • 06Hooks de eventos nas interações com os agentes e exposição por uma API compatível com OpenAI.

Casos de uso

  • Adicionar um assistente conversacional a um produto Laravel existente.
  • Automatizar operações internas com agentes que chamam ferramentas da aplicação.
  • Criar experiências de chat por usuário com histórico de conversas armazenado.
  • Executar agentes com provedores de fallback para reduzir o tempo de inatividade causado por um único fornecedor de LLM.

Início rápido

  1. 1

    Instale o pacote com o Composer

    composer require maestroerror/laragent
  2. 2

    Publique o arquivo de configuração

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

    Gere seu primeiro agente

    php artisan make:agent YourAgentName

Antes de usar

  • Requer Laravel 10.x ou superior e PHP 8.3 ou superior.
  • Para executar agentes, é necessária uma chave de API de um provedor de LLM, como a OpenAI.

Em coleções

Frameworks e apps de agentes de IA open sourceServidores MCPFrameworks para criar apps e sites

Tópicos

#ai-agents#laravel#php#llm#tool-calling#chat-history#mcp#ai#framework#laravel-package

Perguntas frequentes

O que é LarAgent?
Framework PHP para criar agentes de IA em projetos Laravel, com API no estilo Eloquent, ferramentas, histórico de conversas e suporte a vários provedores. LarAgent é um framework para criar agentes de IA em aplicações Laravel. Os agentes são definidos como classes parecidas com modelos Eloquent, com propriedades para o modelo, o provedor, o histórico de conversas e as ferramentas, além de um comando artisan para gerá-los. Os desenvolvedores podem adicionar ferramentas como métodos ou classes anotados com atributos e executar um agente por usuário ou com um nome de histórico personalizado.
LarAgent é gratuito? Qual é a licença?
LarAgent é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
LarAgent ainda é mantido?
Atualizado nos últimos 6 meses. O último commit de LarAgent foi em 20 de ago. de 2026.
Para que posso usar LarAgent?
Adicionar um assistente conversacional a um produto Laravel existente. Automatizar operações internas com agentes que chamam ferramentas da aplicação. Criar experiências de chat por usuário com histórico de conversas armazenado. Executar agentes com provedores de fallback para reduzir o tempo de inatividade causado por um único fornecedor de LLM.
Como instalar LarAgent?
Instale o pacote com o Composer: composer require maestroerror/laragent Publique o arquivo de configuração: php artisan vendor:publish --tag="laragent-config" Gere seu primeiro agente: php artisan make:agent YourAgentName
Onde consigo LarAgent?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/MaestroError/LarAgent

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

Projetos relacionados