提示牌组：在 Laravel 中以版本化文件的形式管理 AI 提示

提示牌组 经过 维克多兄弟 它为 Laravel 应用程序提供了一种结构化的方式来管理 AI 提示——将它们作为版本化的 markdown 文件存储在磁盘上，而不是直接将字符串嵌入到应用程序代码中。

该软件包需要 PHP 8.2+ 和 Laravel 11+。

主要特点：

• 基于磁盘的提示文件，带有基于目录的版本控制
• 使用变量插值 {{ $variable }} Markdown 文件中的语法
• 用于创建、列出、测试和激活提示符版本的 Artisan 命令
• 支持 A/B 测试，可按令牌使用情况、延迟和成本比较提示符版本。
• 与……集成 laravel/ai 通过 HasPromptTemplate 特征

# 创建和使用提示

安装软件包后，您可以使用提供的参数生成新的提示符。 make:prompt 命令：

php

工匠

制作：提示

订单摘要

这将构建一个版本化的目录结构。 resources/prompts/ 根据上述命令，结果可能如下所示：

资源/提示/
└── 订单摘要/
├── v1/
│ └── system.md
└── metadata.json

然后您可以编辑 system.md 提示文件 {{ $variable }} 动态值的占位符：

您是一名 {{ $stone }} 客服代理。
总结以下订单：{{ $order }}。

以下是加载/渲染提示符的示例：

使用

Veeqtoh\PromptDeck\Facades\PromptDeck
;
$提示
=

提示牌组
::
得到
（
订单摘要
（英文）：
$消息
=
$提示
->
到消息
（[
'语气'

=>

'友好的'
,
'命令'

=>
$orderDetails]);

这 toMessages() 该方法返回一个与 OpenAI、Anthropic 和类似 API 格式兼容的消息数组。

要加载特定版本：

$提示
=

提示牌组
::
得到
（
订单摘要
,
'v2'
（英文）：

您也可以通过 Artisan 激活版本，而无需修改代码：

php

工匠

提示：激活

订单摘要

v2

# Laravel AI SDK 集成

对于使用的应用程序 laravel/ai ， 这 HasPromptTemplate 特征自动提供 instructions() 和 promptMessages() 在你的代理类中：

使用

Veeqtoh\PromptDeck\Concerns\HasPromptTemplate
;
班级

订单代理

延伸

代理人
{

使用

HasPromptTemplate
;
}

什么时候 PROMPTDECK_SCAFFOLD_ON_MAKE_AGENT=true 设定于 .env ， 跑步 php artisan make:agent 它还会自动生成匹配的提示目录。

您可以在以下位置找到提示牌组： GitHub 并阅读完整文档，网址为： 提示卡文档 。