laravel-ai-sdk

Laravel AI SDK

使用 Laravel AI SDK（laravel/ai）构建 AI 驱动功能的综合指南。包含 17 条规则，分为 7 个类别，涵盖 Agent、工具、媒体生成、嵌入、向量存储和测试。

适用场景

在以下情况中参考这些指南：

• 创建包含指令、工具和结构化输出的 AI Agent
• 使用对话上下文提示 Agent
• 流式传输或将 Agent 响应加入队列
• 生成图像、音频或转录文本
• 创建和查询向量嵌入
• 构建 RAG（检索增强生成）功能
• 使用伪造对象和断言测试 AI 功能

按优先级划分的规则类别

优先级	类别	影响	前缀
1	Agent	CRITICAL	agent-
2	工具	HIGH	tool-
3	嵌入与搜索	HIGH	embed-
4	媒体生成	MEDIUM	media-
5	文件与存储	MEDIUM	files-
6	基础设施	MEDIUM	infra-
7	测试	HIGH	test-

快速参考

1. Agent（CRITICAL）

• agent-create-configure - 使用 artisan 创建 Agent，并通过 PHP 属性进行配置
• agent-prompting - 提示 Agent、对话上下文、RemembersConversations
• agent-structured-output - 使用 JSON schema 实现结构化输出
• agent-streaming-async - 流式传输、广播和将响应加入队列
• agent-middleware - Agent 中间件管线
• agent-anonymous - 用于快速交互的匿名 Agent

2. 工具（HIGH）

• tool-create - 使用 schema 和 handle 方法创建自定义工具
• tool-provider - 提供方工具：WebSearch、WebFetch、FileSearch、SimilaritySearch

3. 嵌入与搜索（HIGH）

• embed-generate-cache - 生成、存储和缓存向量嵌入
• embed-rerank - 根据相关性对文档和集合重新排序

4. 媒体生成（MEDIUM）

• media-images - 生成、存储图像并将其加入队列
• media-audio-transcription - 文本转语音和语音转文本

5. 文件与存储（MEDIUM）

• files-vector-stores - 用于 RAG 的文件存储和向量存储

6. 基础设施（MEDIUM）

• infra-failover - 自动切换提供方以增强韧性

7. 测试（HIGH）

• test-agents - 伪造 Agent、断言提示词、防止意外提示词
• test-media - 伪造图像、音频和转录文本
• test-data - 伪造嵌入、重新排序、文件和向量存储

核心模式

创建 Agent

<?php

namespace App\Ai\Agents;

use Laravel\Ai\Contracts\Agent;
use Laravel\Ai\Promptable;

class SalesCoach implements Agent
{
    use Promptable;

    public function instructions(): string
    {
        return 'You are a sales coach, analyzing transcripts and providing feedback.';
    }
}

提示

use App\Ai\Agents\SalesCoach;

$response = SalesCoach::make()->prompt('Analyze this sales transcript...');

return (string) $response;

生成图像

use Laravel\Ai\Image;

$image = Image::of('A donut sitting on the kitchen counter')
    ->landscape()
    ->generate();

$path = $image->store();

生成嵌入

use Illuminate\Support\Str;

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

测试

use App\Ai\Agents\SalesCoach;

SalesCoach::fake(['First response', 'Second response']);

SalesCoach::make()->prompt('Analyze this...');

SalesCoach::assertPrompted('Analyze this...');

使用方法

阅读各个规则文件，了解详细说明和代码示例。

每个规则文件包含：

• 含元数据（标题、影响、标签）的 YAML frontmatter
• 对规则重要性的简要说明
• 附带说明的错误示例
• 附带说明的正确示例
• Laravel 13 和 PHP 8.3 特定背景与参考资料

完整汇编文档

如需查看包含所有规则详解的完整指南：AGENTS.md