在 laravel 13 项目中安装 laravel/ai,用 make:agent 生成 agent,在本地通过 prompt() 发起一次文本请求。示例使用 openai 提供商,需要项目能安装对应依赖且已配置可用的 api 密钥。
安装 SDK 并创建商品摘要 Agent
在 Laravel 项目根目录执行。将密钥配置在本地环境变量或未提交到版本库的 .env 文件中。
composer require laravel/ai php artisan make:agent ProductSummary

如果项目缓存了配置,更新环境后在本地执行 php artisan config:clear。本例只发一次无历史的文本请求。
在 Agent 中限制摘要使用的事实
在生成的 app/Ai/Agents/ProductSummary.php 中保留生成器定义的接口和方法,只替换 instructions() 的方法体。
return '把输入整理成一句中文商品摘要。只使用输入给出的属性,不添加型号、价格或性能承诺。';

示例用虚构商品数据,便于观察输出有没有自行补充规格。
在 Tinker 中调用并检查返回文本
进入 php artisan tinker 后运行下面的表达式。调用会向配置的提供商发送输入,并可能产生费用。
$response = (new \App\Ai\Agents\ProductSummary)->prompt(
'商品:折叠桌。材质:竹面。尺寸:60 × 40 厘米。',
provider: \Laravel\Ai\Enums\Lab::OpenAI,
);
echo $response->text;

应收到包含给定商品事实的文本,措辞会变化。若认证失败,核对 OPENAI_API_KEY 及配置缓存。遇到依赖冲突,先查看 Composer 提示的 PHP 和包版本限制。











