Repolode
MaestroError

MaestroError/LarAgent

面向 Laravel 项目的 PHP AI 智能体开发框架,提供类 Eloquent 的写法、工具调用与多模型支持。

Star
645
Fork
56
未关闭 Issue
7
最近提交
3个月前

这是什么?

LarAgent 是一个在 Laravel 应用中构建 AI 智能体的开发框架。智能体以类的形式定义,写法接近 Eloquent 模型,可以在类中配置模型、provider、聊天历史和工具,并通过 artisan 命令快速生成。工具可以用属性注解的方法或独立类来声明,智能体可以按用户或自定义名称维护各自的对话上下文。

框架覆盖了智能体开发的常见环节:支持内存、缓存、JSON 等多种聊天历史存储,支持结构化输出和图片输入,并可以关闭并行工具调用。每个智能体可单独指定 provider,也可以配置多个 provider 按顺序自动故障转移。事件系统可以在智能体交互的各个环节挂接钩子,智能体还能通过 OpenAI 兼容接口对外提供服务,并支持将 MCP 服务器作为工具来源。

运行环境要求 PHP 8.3 及以上、Laravel 10.x 及以上,也可以脱离 Laravel 独立使用。项目以 maestroerror/laragent Composer 包的形式发布,采用 MIT 许可证。

核心功能

  • 01以类似 Eloquent 的写法定义智能体,并通过 artisan 命令生成。
  • 02用注解方法或类声明工具,可选择是否并行执行。
  • 03聊天历史支持内存、缓存、JSON 等存储,可按用户或自定义名称区分。
  • 04多个 LLM provider 按顺序自动故障转移。
  • 05支持结构化输出和图片输入。
  • 06提供覆盖智能体交互过程的事件钩子,并可通过 OpenAI 兼容接口对外提供服务。

适用场景

  • 在现有 Laravel 产品中加入对话式助手。
  • 用能调用应用内工具的智能体自动化内部业务流程。
  • 构建按用户保存对话记录的聊天功能。
  • 配置备用 provider,降低单一大模型服务商故障带来的影响。

快速上手

  1. 1

    使用 Composer 安装该包

    composer require maestroerror/laragent
  2. 2

    发布配置文件

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

    生成你的第一个 Agent

    php artisan make:agent YourAgentName

使用前须知

  • 需要 Laravel 10.x 或更高版本以及 PHP 8.3 或更高版本。
  • 运行 Agent 需要 OpenAI 等大模型提供商的 API 密钥。

收录于专题

标签

常见问题

LarAgent 是什么?
面向 Laravel 项目的 PHP AI 智能体开发框架,提供类 Eloquent 的写法、工具调用与多模型支持。 LarAgent 是一个在 Laravel 应用中构建 AI 智能体的开发框架。智能体以类的形式定义,写法接近 Eloquent 模型,可以在类中配置模型、provider、聊天历史和工具,并通过 artisan 命令快速生成。工具可以用属性注解的方法或独立类来声明,智能体可以按用户或自定义名称维护各自的对话上下文。
LarAgent 可以免费使用吗?用的什么许可证?
LarAgent 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
LarAgent 还在维护吗?
半年内有更新。LarAgent 最近一次提交是在 2026年8月20日。
LarAgent 适合用来做什么?
在现有 Laravel 产品中加入对话式助手。 用能调用应用内工具的智能体自动化内部业务流程。 构建按用户保存对话记录的聊天功能。 配置备用 provider,降低单一大模型服务商故障带来的影响。
LarAgent 怎么安装和运行?
使用 Composer 安装该包: composer require maestroerror/laragent 发布配置文件: php artisan vendor:publish --tag="laragent-config" 生成你的第一个 Agent: php artisan make:agent YourAgentName
在哪里获取 LarAgent?
源代码和安装说明在 GitHub 上:https://github.com/MaestroError/LarAgent

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目