# Laravel AI SDK 正式发布

Laravel AI SDK 今天正式发布了。这个由 Taylor Otwell 开发数月的官方包，为 Laravel 应用提供了一套统一的 AI 交互接口，覆盖文本对话、图像生成、语音合成、语音转录、向量嵌入等场景，支持 OpenAI、Anthropic、Gemini、Groq、xAI 等主流服务商。

安装方式和其他 Laravel 官方包一样简单：

```shell
composer require laravel/ai
```

## Agent：核心交互单元

SDK 的核心概念是 Agent。每个 Agent 是一个 PHP 类，封装了系统指令、对话上下文、工具和输出格式。可以把它理解为一个专用助手——销售教练、文档分析器、客服机器人——配置一次，随处调用。

通过 Artisan 命令创建：

```shell
php artisan make:agent SalesCoach
```

生成的类实现 `Agent` 接口，定义 `instructions()` 方法提供系统提示词，然后调用 `prompt()` 发起对话：

```php
$response = SalesCoach::make(user: $user)
    ->prompt('分析这段销售录音...');

return (string) $response;
```

`prompt()` 方法支持在调用时切换服务商和模型：

```php
$response = (new SalesCoach)->prompt(
    '分析这段销售录音...',
    provider: 'anthropic',
    model: 'claude-haiku-4-5-20251001',
    timeout: 120,
);
```

如果不想创建专门的类，也可以用匿名 Agent 快速调用：

```php
use function Laravel\Ai\{agent};

$response = agent(
    instructions: 'You are an expert at software development.',
)->prompt('Tell me about Laravel');
```

## 结构化输出

Agent 可以返回结构化数据，而不仅仅是纯文本。实现 `HasStructuredOutput` 接口，定义 `schema()` 方法即可：

```php
public function schema(JsonSchema $schema): array
{
    return [
        'feedback' => $schema->string()->required(),
        'score' => $schema->integer()->min(1)->max(10)->required(),
    ];
}
```

调用后直接当数组用：

```php
$response = (new SalesCoach)->prompt('分析这段录音...');

return $response['score']; // 8
```

## 对话记忆

Agent 支持自动持久化对话历史。使用 `RemembersConversations` trait 后，SDK 会自动将对话存入数据库，后续可以通过 `continue()` 方法继续之前的对话：

```php
// 开始新对话
$response = (new SalesCoach)->forUser($user)->prompt('你好！');
$conversationId = $response->conversationId;

// 继续对话
$response = (new SalesCoach)
    ->continue($conversationId, as: $user)
    ->prompt('接着刚才的话题...');
```

## 工具系统

Agent 可以使用工具来扩展能力。通过 `make:tool` 命令创建工具类，定义输入 schema 和 `handle()` 方法：

```php
class RandomNumberGenerator implements Tool
{
    public function description(): string
    {
        return '生成加密安全的随机数。';
    }

    public function handle(Request $request): string
    {
        return (string) random_int($request['min'], $request['max']);
    }

    public function schema(JsonSchema $schema): array
    {
        return [
            'min' => $schema->integer()->min(0)->required(),
            'max' => $schema->integer()->required(),
        ];
    }
}
```

SDK 还内置了几个服务商级别的工具：

- **WebSearch** — 让 Agent 搜索网页，支持 Anthropic、OpenAI、Gemini
- **WebFetch** — 让 Agent 抓取网页内容，支持 Anthropic、Gemini
- **FileSearch** — 在向量存储中搜索文件，支持 OpenAI、Gemini
- **SimilaritySearch** — 基于 Eloquent 模型的向量相似度搜索，用于 RAG 场景

## 流式响应与广播

对于需要实时输出的场景，Agent 支持流式响应。返回值可以直接作为路由响应，自动发送 SSE：

```php
Route::get('/coach', function () {
    return (new SalesCoach)->stream('分析这段录音...');
});
```

流式事件还可以通过 Laravel Broadcasting 广播到前端频道，或者使用 Vercel AI SDK 协议与前端框架对接：

```php
return (new SalesCoach)
    ->stream('分析这段录音...')
    ->usingVercelDataProtocol();
```

## 队列处理

耗时的 AI 请求可以推入队列在后台处理：

```php
(new SalesCoach)
    ->queue($request->input('transcript'))
    ->then(function (AgentResponse $response) {
        // 处理响应...
    })
    ->catch(function (Throwable $e) {
        // 处理异常...
    });
```

## 图像生成

`Image` 类提供了简洁的图像生成接口，支持 OpenAI、Gemini 和 xAI：

```php
use Laravel\Ai\Image;

$image = Image::of('厨房台面上的甜甜圈')
    ->quality('high')
    ->landscape()
    ->generate();

$path = $image->store();
```

支持附加参考图像进行风格迁移，也可以推入队列异步生成。

## 音频与转录

语音合成（TTS）和语音转录（STT）同样被纳入 SDK：

```php
use Laravel\Ai\Audio;
use Laravel\Ai\Transcription;

// 文字转语音
$audio = Audio::of('I love coding with Laravel.')
    ->female()
    ->instructions('用海盗的语气说')
    ->generate();

// 语音转文字
$transcript = Transcription::fromStorage('audio.mp3')
    ->diarize() // 按说话人分段
    ->generate();
```

TTS 支持 OpenAI 和 ElevenLabs，STT 同样支持这两个服务商。

## Embeddings 与向量搜索

生成向量嵌入变得非常直观。Laravel 的 `Stringable` 类新增了 `toEmbeddings()` 方法：

```php
$embeddings = Str::of('Napa Valley has great wine.')->toEmbeddings();
```

配合 PostgreSQL 的 pgvector 扩展，可以在数据库中直接进行向量相似度查询：

```php
$documents = Document::query()
    ->whereVectorSimilarTo('embedding', '纳帕谷最好的酒庄')
    ->limit(10)
    ->get();
```

传入字符串时，Laravel 会自动生成嵌入向量再进行查询，不需要手动处理。Embedding 还支持缓存，避免重复调用 API。

## Reranking

Reranking 可以对搜索结果按语义相关性重新排序，支持 Cohere 和 Jina：

```php
$posts = Post::all()->rerank('body', 'Laravel 教程');
```

这个功能直接以 Collection 宏的形式提供，可以对 Eloquent 集合按指定字段做语义重排。

## 文件与向量存储

SDK 提供了文件管理和向量存储的完整方案。文件可以上传到服务商存储后反复引用，向量存储则用于 RAG 场景下的文件检索：

```php
use Laravel\Ai\Files\Document;
use Laravel\Ai\Stores;

// 上传文件
$stored = Document::fromPath('/path/to/report.pdf')->put();

// 创建向量存储并添加文件
$store = Stores::create('知识库');
$store->add($stored);
```

## Failover

调用时传入服务商数组，SDK 会在主服务商不可用时自动切换到备用服务商：

```php
$response = (new SalesCoach)->prompt(
    '分析这段录音...',
    provider: ['openai', 'anthropic'],
);
```

## Agent 配置

Agent 支持通过 PHP Attribute 配置参数，包括最大步数、最大 token 数、温度、超时时间等：

```php
#[MaxSteps(10)]
#[MaxTokens(4096)]
#[Provider('anthropic')]
#[Temperature(0.7)]
#[Timeout(120)]
class SalesCoach implements Agent
{
    use Promptable;
}
```

`UseCheapestModel` 和 `UseSmartestModel` 两个 Attribute 可以自动选择服务商最便宜或最强的模型，不需要记具体的模型名。

## 中间件

Agent 支持中间件机制，可以在请求发送前后插入自定义逻辑，比如日志记录：

```php
class LogPrompts
{
    public function handle(AgentPrompt $prompt, Closure $next)
    {
        Log::info('Prompting agent', ['prompt' => $prompt->prompt]);

        return $next($prompt)->then(function (AgentResponse $response) {
            Log::info('Agent responded', ['text' => $response->text]);
        });
    }
}
```

## 测试支持

SDK 为每个功能都提供了 `fake()` 方法和断言 API，测试时不需要真实调用 AI 服务商：

```php
SalesCoach::fake(['第一条响应', '第二条响应']);

// 执行业务逻辑...

SalesCoach::assertPrompted('分析这段...');
SalesCoach::assertNeverPrompted();
```

图像、音频、转录、Embeddings、Reranking、文件操作、向量存储都有对应的 fake 和断言方法。

## 服务商支持一览

| 功能 | 支持的服务商 |
|---|---|
| 文本对话 | OpenAI、Anthropic、Gemini、Groq、xAI |
| 图像生成 | OpenAI、Gemini、xAI |
| 语音合成 | OpenAI、ElevenLabs |
| 语音转录 | OpenAI、ElevenLabs |
| 向量嵌入 | OpenAI、Gemini、Cohere、Jina |
| 重排序 | Cohere、Jina |
| 文件管理 | OpenAI、Anthropic、Gemini |

## 小结

Laravel AI SDK 把 AI 集成做成了 Laravel 开发者熟悉的样子：Artisan 命令生成类、接口约束行为、trait 复用逻辑、队列异步处理、fake 方法写测试。如果你的 Laravel 项目需要接入 AI 能力，这个包值得尝试。

[🎉Laravel AI SDK 正式发布](https://catchadmin.com/post/2026-02/laravel-ai-sdk-released)


Laravel AI SDK 今天正式发布了。这个由 Taylor Otwell 开发数月的官方包，为 Laravel 应用提供了一套统一的 AI 交互接口，覆盖文本对话、图像生成、语音合成、语音转录、向量嵌入等场景，支持 OpenAI、Anthropic、Gemini、Groq、xAI 等主流服务商。

Laravel AI SDK 正式发布

编程语言

开发工具

LaravelAISDK官方发布，为Laravel开发者提供统一AI接口，支持文本对话、图像生成、语音合成等功能。支持OpenAI、Anthropic等主流服务商，内置Agent、工具系统、结构化输出等特性，简化AI集成流程。包含队列处理、流式响应、向量搜索等高级功能，助力开发者快速构建智能应用。

结构化数据

AI图像生成

语音合成

PostgreSQL

中间件

数据库

路由

Agent

语音产品特惠新用户14.9元起


2026新春采购季

message-queue-catalog

tencentdb-catalog

postgres

cscbot

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Laravel AI SDK 正式发布-腾讯云开发者社区-腾讯云

Laravel AI SDK 正式发布

Laravel AI SDK 正式发布

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐