Repolode
MaestroError

MaestroError/LarAgent

Eloquent風のAPIやツール、チャット履歴、複数プロバイダー対応を備えた、LaravelプロジェクトでAIエージェントを構築するためのPHPフレームワーク。

スター
645
フォーク
56
未解決の Issue
7
最終コミット
3 か月前

これは何?

LarAgentは、Laravelアプリケーション内でAIエージェントを作成するためのフレームワークです。エージェントはEloquentモデルに似たクラスとして定義し、モデル、プロバイダー、チャット履歴、ツールなどのプロパティを設定できます。また、エージェントを生成するartisanコマンドも用意されています。ツールは、attributeでアノテーションを付けたメソッドやクラスとして追加でき、ユーザーごとにエージェントを実行したり、任意の履歴名を指定して実行したりできます。

エージェント開発でよく使われる機能として、メモリ内やキャッシュなど複数のチャット履歴バックエンド、構造化出力、画像入力、無効化可能な並列ツール呼び出しに対応しています。プロバイダーはエージェントごとに設定でき、優先順を指定したプロバイダー一覧によって、フォールバック先へ自動的に切り替えられます。イベントシステムではエージェントとのやり取りを通じたフックを利用でき、エージェントをOpenAI互換APIとして公開することもできます。また、ツールの提供元としてMCPサーバーにも対応しています。

LarAgentの動作要件はPHP 8.3以上、Laravel 10.x以上です。Laravel外でもスタンドアロンモードで利用できます。MITライセンスのもと、Composerパッケージmaestroerror/laragentとして配布されています。

主な機能

  • 01artisanコマンドで生成できる、Eloquent風クラスとしてエージェントを定義。
  • 02アノテーション付きのメソッドやクラスをツールとして追加でき、並列実行にも対応。
  • 03ユーザーごと、または任意の名前で、メモリ、キャッシュ、JSONなどのバックエンドにチャット履歴を保存。
  • 04優先順を指定したLLMプロバイダー一覧からの自動フェイルオーバー。
  • 05構造化出力と画像入力に対応。
  • 06エージェントとのやり取り全般で使えるイベントフックと、OpenAI互換APIとしての公開。

ユースケース

  • 既存のLaravel製プロダクトに会話型アシスタントを追加する。
  • アプリケーションのツールを呼び出すエージェントで社内業務を自動化する。
  • 会話履歴を保存し、ユーザーごとのチャット体験を構築する。
  • フォールバックプロバイダーを使って、単一のLLMベンダーに起因するダウンタイムを減らす。

クイックスタート

  1. 1

    Composerでパッケージをインストール

    composer require maestroerror/laragent
  2. 2

    設定ファイルを公開

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

    最初のエージェントを生成

    php artisan make:agent YourAgentName

使う前に知っておきたいこと

  • Laravel 10.x以上とPHP 8.3以上が必要です。
  • エージェントの実行には、OpenAIなどのLLMプロバイダーのAPIキーが必要です。

収録されている特集

トピック

よくある質問

LarAgent とは?
Eloquent風のAPIやツール、チャット履歴、複数プロバイダー対応を備えた、LaravelプロジェクトでAIエージェントを構築するためのPHPフレームワーク。 LarAgentは、Laravelアプリケーション内でAIエージェントを作成するためのフレームワークです。エージェントはEloquentモデルに似たクラスとして定義し、モデル、プロバイダー、チャット履歴、ツールなどのプロパティを設定できます。また、エージェントを生成するartisanコマンドも用意されています。ツールは、attributeでアノテーションを付けたメソッドやクラスとして追加でき、ユーザーごとにエージェントを実行したり、任意の履歴名を指定して実行したりできます。
LarAgent は無料で使えますか?ライセンスは?
LarAgent は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
LarAgent は今もメンテナンスされていますか?
半年以内に更新あり。LarAgent の最終コミットは 2026年8月20日 です。
LarAgent は何に使えますか?
既存のLaravel製プロダクトに会話型アシスタントを追加する。 アプリケーションのツールを呼び出すエージェントで社内業務を自動化する。 会話履歴を保存し、ユーザーごとのチャット体験を構築する。 フォールバックプロバイダーを使って、単一のLLMベンダーに起因するダウンタイムを減らす。
LarAgent のインストール方法は?
Composerでパッケージをインストール: composer require maestroerror/laragent 設定ファイルを公開: php artisan vendor:publish --tag="laragent-config" 最初のエージェントを生成: php artisan make:agent YourAgentName
LarAgent はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/MaestroError/LarAgent

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト