Laravel AI SDK v1 is officially here 🚀
— Laravel (@laravel) September 23, 2026
One Laravel-native API for every provider. We've closed hundreds of bugs and shipped new features you can use today.
Here's what's new 🧵 pic.twitter.com/AS9KtgGPzE
Laravelは2026年9月23日、Laravel AI SDK v1.0を公開しました。複数のプロバイダーをLaravel向けのAPIで扱えるSDKに、分類やツール承認などの機能が加わり、会話保存の仕組みも変更されています。
- Jevを使った分類機能を追加し、Vercel ChatとAG-UIへの対応を強化
- エージェントの各生成ステップでミドルウェアを実行でき、ツールの実行前承認にも対応
- 会話保存方式などに破壊的変更があり、v1.0への移行にはアップグレードガイドの確認が必要
Laravel AI SDK v1.0の主な追加機能
Laravel AI SDK v1.0では、テキスト、画像、音声、埋め込みに加え、分類が独立した機能として扱われます。Jevによる分類が紹介されており、分類機能は現在TypeSafeとOpenRouterで利用できます。また、Strクラスの新しいdecideマクロは、はい・いいえで答える質問に対して真偽値を返します。threshold引数で、分類に求める確信度を調整できます。
フロントエンドとの連携では、Vercel ChatとAG-UIのプロトコルへの対応が強化されました。これらの形式でリクエストを受け取り、レスポンスをストリーミングできます。保存済みのメッセージをクライアントが期待する形式に変換し、ページ再読み込み後のチャット画面を再構築する方法も示されています。
エージェントの実行をより細かく制御
従来、エージェントのミドルウェアはプロンプトごとに1回実行されていました。v1.0では生成の各ステップを対象とするため、実行途中でメッセージやツール、モデルなどを変更できます。
人による確認が必要なツールには、ApprovableコントラクトとInteractsWithApprovalsトレイトを使用できます。エージェントは対象ツールをすぐに実行せず、承認を待つ状態になります。保留中の呼び出しについて、承認、理由を添えた却下、実行前の引数の編集が可能です。
ツール関連では、使用頻度の低いツールを必要に応じて読み込むToolSearchも追加されました。対応先はOpenAIとAnthropicです。また、プロバイダー側のサンドボックスでコードを実行するCodeExecutionは、Anthropic、OpenAI、Azure、Gemini、xAIに対応しています。
会話保存方式と利用量の表記を変更
会話履歴では、ツール呼び出しと結果を別々の平坦なリストとして保存する方式から、往復ごとの記録を格納するsteps JSONカラムへ変更されました。各結果は、その結果を生んだ呼び出しとともに保存されます。従来どおり会話はターンごとに1行で保存され、toolCallsとtoolResultsのアクセサーも引き続き利用できます。
プロバイダー間の利用量の表記も統一され、promptTokensとcompletionTokensは、それぞれinputTokensとoutputTokensに変わりました。
v1.0へアップグレードする際の注意点
v1.0には、主に会話保存、エージェントのミドルウェア、トークン使用量、ストリームのプロトコルに関する破壊的変更があります。特にtoolcallsやtoolresultsを参照する生SQLは、stepsカラムを利用するよう変更が必要です。公式のアップグレードガイドには、v1.0のデプロイ前に一度実行する必要があるバックフィル用マイグレーションも掲載されています。
移行作業には、LaravelのMCPサーバー「Laravel Boost」が提供するガイド付きプロンプトも利用できます。Boostを開発用依存関係として追加し、MCPサーバーとガイドラインをインストールした後、対応する開発ツールで/upgrade-ai-sdk-v1コマンドを実行すると、アップグレードガイドに沿って変更点を順に確認できます。
