laravel-ai-sdk 是一份面向 Laravel 13 的 AI 集成技能资料，核心是通过 laravel/ai 包在 Laravel 项目中接入 AI 智能体、工具调用、嵌入、结构化输出和流式响应。
用途与定位：资料用于指导在 Laravel 应用内构建 AI 能力，统一封装多家模型供应商的调用接口，并提供智能体、工具和嵌入等组件的组织方式。
主要能力：资料列出的能力包括：统一 API，通过 Lab 枚举为 17 家供应商提供同一代码表面；智能体，以类形式实现 Agent 契约并使用 Promptable trait；工具调用，支持第一方 FileSearch 和按智能体定义的自定义工具；嵌入，提供 Embeddings::for([...])->generate() 与 Str::of(...)->toEmbeddings()；流式输出，支持原生 SSE 和 Vercel AI SDK 协议兼容；结构化输出，使用 agent(schema: fn ($s) => ...) 配合 JsonSchema。
使用方式：资料建议先做前期调研，包括梳理现有 AI 用法、核对供应商模型 ID 与价格、拉取最新文档示例，并在实现后做校验。关键规则包括：使用 Lab 枚举而非硬编码供应商字符串；在 .env 中按供应商配置密钥并由 config/ai.php 读取；智能体必须实现 Laravel\Ai\Contracts\Agent 并使用 Promptable；通过覆盖 tools() 显式声明工具；流式结果直接从路由返回，不在内存中缓冲。资料还给出推荐目录结构（app/Ai/Agents、app/Ai/Tools、app/Ai/Services，config/ai.php，.env）和快速示例：生成文本、生成嵌入、路由返回流式输出。最佳实践包括使用类级属性锁定智能体配置、缓存嵌入、设置超时、前端为 Next.js/SvelteKit 时使用 usingVercelDataProtocol()，并避免在 config 中直接存密钥或手动循环嵌入项。
适用场景：适用于基于 Laravel 13 开发 AI 对话、智能体、语义搜索、结构化数据生成和流式接口的项目。
限制：资料主要面向 Laravel 13 与 laravel/ai 包，具体安装命令、版本兼容性、供应商支持和费用等信息暂未提供，需以官方文档核实。