【免费下载链接】aiThe Laravel AI SDK provides a unified, expressive API for interacting with AI providers such as OpenAI, Anthropic, Gemini, and more.项目地址https://gitcode.com/gh_mirrors/ai89/ai点击查看免费下载Laravel AIlaravel/ai是 Laravel 官方推出的 AI SDK提供统一、简洁的 API 来对接 OpenAI、Anthropic、Gemini 等 AI 服务商。本文将带你用agent()函数 3 行代码创建一个 AI agentAI 助手并讲解如何配置服务商、调用模型与进阶用法是新手入门 Laravel AI SDK 的完整指南。什么是 Laravel AI agent() 函数Laravel AI 的核心概念是Agent智能体——一个带指令instructions、消息messages和工具tools的 AI 助手。你不需要手动实例化任何类SDK 提供了一个全局辅助函数agent()它会返回一个即开即用的匿名 Agentuse function Laravel\Ai\agent; $agent agent(You are a helpful assistant.); $response $agent-prompt(介绍一下 Laravel); echo $response-text;就这么简单agent()函数定义在 functions.php 中它的签名接收 4 个参数参数说明string $instructions助手的角色设定/指令iterable $messages已有的对话消息默认空数组iterable $tools助手可调用的工具默认空数组?Closure $schema可选提供时返回结构化输出的 Agent函数会根据是否传入$schema自动决定创建 AnonymousAgent 还是 StructuredAnonymousAgent 实例帮你省去大量样板代码。快速开始一键安装步骤在 Laravel 12 / 13 项目中先确认 PHP 版本 ≥ 8.3见 composer.json然后安装 SDKcomposer require laravel/ai接下来在.env中配置你的 API Key例如使用 OpenAIOPENAI_API_KEYsk-xxxxxx服务商Provider的映射关系在 config/ai.php 中定义默认文本服务商为openai你只需在.env里填好对应的 Key 即可开始使用。3 行代码创建你的第一个 AI 助手下面这段代码就是完整的3 行核心$agent agent(你是一位资深 PHP 工程师用简洁中文回答。); $response $agent-prompt(如何用 Laravel 写一个 API 路由); echo $response-text;第 1 行agent()创建助手参数是指令字符串决定它的人设第 2 行prompt()向助手提问返回 AgentResponse 对象第 3 行读取回答文本返回的响应对象还支持更多操作例如获取结构化数据、查看 token 用量等响应类位于 src/Responses/ 目录。切换模型与服务商为什么一套代码通吃Laravel AI 的一大亮点是服务商可插拔。想换用 Anthropic 或 Gemini只需在调用时指定$response agent(You are a helpful assistant.) -prompt(解释一下闭包, provider: anthropic);也可以在指令级别指定模型$agent agent(You are a helpful assistant.) -prompt(写一首关于 Laravel 的诗, model: gpt-5.2);SDK 内置了十几个服务商网关代码都在 src/Gateway/ 目录下OpenAI、Anthropic、Gemini、DeepSeek、Groq、Ollama、OpenRouter、Mistral、Bedrock 等。所有服务商共享同一套 API意味着你切换服务商时业务代码几乎不用改动。进阶用法给助手加上技能️ 让助手调用工具通过第 3 个参数传入工具助手就能调用你写的 PHP 方法$agent agent( 你是一位天气助手需要时用工具查询天气。, tools: [new GetWeatherTool], );工具只需实现Tool契约见 Contracts/Tool.phpSDK 会自动生成 JSON Schema 并处理参数校验。 让助手输出结构化数据传入第 4 个参数一个闭包描述期望的数据结构agent()会返回结构化输出的 Agent$agent agent( 从文本中提取人名和年龄。, schema: fn () [ name Schema::string(), age Schema::integer(), ], ); $response $agent-prompt(李雷今年 28 岁); dump($response-data()); // [name 李雷, age 28] 记住对话上下文agent()创建的匿名助手本身是无状态的你可以手动传入历史消息$agent agent( 你是我的私人顾问。, messages: [ new UserMessage(我叫小明), new AssistantMessage(好的小明有什么可以帮你), ], );更进一步创建可复用的 Agent 类当助手逻辑变复杂时建议创建独立的 Agent 类。SDK 提供了 artisan 命令帮你生成骨架php artisan make:agent WeatherAgent生成的类会基于 agent.stub 模板实现Agent、Conversational、HasTools三个契约结构如下class WeatherAgent implements Agent, Conversational, HasTools { use Promptable; public function instructions(): string { ... } public function messages(): iterable { ... } public function tools(): iterable { ... } }命令实现位于 MakeAgentCommand模板源码见 stubs/agent.stub。之后直接$this-prompt(今天天气如何)即可无需每次传指令。常见问题新手最容易踩的 3 个坑1.agent()与Ai::agent()有什么区别agent()是全局辅助函数创建一次性匿名助手Ai::agent(YourAgent::class)则从容器解析可复用 Agent 类二者返回的都是实现了 Agent 契约的实例。2. 报ProviderConnectionException怎么办通常是.env里的 API Key 没配置或服务商配置错误检查 config/ai.php 中该服务商的key字段对应的环境变量。3. 回答被截断或超长怎么办SDK 提供了MaxTokens、Timeout等 Attribute 来控制行为见 src/Attributes/也可以配合MaxSteps限制工具调用轮次。总结为什么值得学 Laravel AI特性说明极简 APIagent()3 行代码出结果零样板代码服务商无关OpenAI / Anthropic / Gemini 等一键切换工具调用PHP 方法自动变成 AI 可调用的 Tool结构化输出闭包定义 Schema数据直接反序列化Laravel AI 把对接 AI从一堆 HTTP 请求的噩梦变成了 3 行 PHP 代码的愉悦体验。如果你想快速落地一个 AI 助手、智能客服或内容生成工具它就是当前 Laravel 生态里最省心的选择。赞分享【免费下载链接】aiThe Laravel AI SDK provides a unified, expressive API for interacting with AI providers such as OpenAI, Anthropic, Gemini, and more.项目地址https://gitcode.com/gh_mirrors/ai89/ai点击查看免费下载相关推荐快速上手终极AI终端助手让命令行拥有智能大脑快速上手终极AI终端助手让命令行拥有智能大脑 想要在终端里拥有一个随叫随到的AI助手吗Gemini CLI让这个梦想成真这款开源AI代理工具将强大的Gem人工智能AI Agent交互助手CLIMCP ClientsTrae Agent终极配置管理指南快速上手AI代码助手Trae Agent终极配置管理指南快速上手AI代码助手 Trae Agent是一个基于大型语言模型的通用软件开发任务代理通过智能配置管理帮助开发者快速搭建人工智能大模型AI AgentAgent 框架代码智能体CLI工具调用CodiumAI PR-Agent革命性AI代码审查助手快速上手指南CodiumAI PR Agent革命性AI代码审查助手快速上手指南 CodiumAI PR Agent 是一款革命性的AI驱动的代码审查助手它彻底改人工智能AI Agent代码智能体代码评审AI 应用创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考