Prompt Deck — керуйте AI prompts у вигляді версіонованих файлів у Laravel

Prompt Deck by Victor Ukam дає Laravel-додаткам упорядкований спосіб керувати AI prompt'ами — зберігаючи їх як версіоновані markdown-файли на диску замість вписування рядків прямо в код.

Пакет вимагає PHP 8.2+ та Laravel 11+.

Основні можливості:

• Файли prompt на диску з версіонуванням на рівні директорій
• Інтерполяція змінних у markdown-файлах за синтаксисом {{ $variable }}
• Artisan-команди для створення, переліку, тестування та активації версій prompt'ів
• Підтримка A/B‑тестування для порівняння версій за кількістю токенів, затримкою та вартістю
• Інтеграція з laravel/ai через трейт HasPromptTemplate

# Створення та використання prompt'ів

Після встановлення пакета можна згенерувати новий prompt командою make:prompt:

php artisan make:prompt order-summary

Це створить версіоновану структуру папок у resources/prompts/, наприклад:

resources/prompts/
└── order-summary/
    ├── v1/
    │   └── system.md
    └── metadata.json

Потім можна редагувати файл prompt system.md, використовуючи плейсхолдери {{ $variable }} для динамічних значень:

You are a {{ $tone }} customer service agent.
Summarise the following order: {{ $order }}.

Приклад завантаження/рендерингу prompt'а:

use Veeqtoh\PromptDeck\Facades\PromptDeck;
 
$prompt = PromptDeck::get('order-summary');
$messages = $prompt->toMessages(['tone' => 'friendly', 'order' => $orderDetails]);

toMessages() повертає масив повідомлень, сумісний з форматами OpenAI, Anthropic та подібних API.

Щоб завантажити конкретну версію:

$prompt = PromptDeck::get('order-summary', 'v2');

Версію також можна активувати через Artisan без змін у коді:

php artisan prompt:activate order-summary v2

# Інтеграція з Laravel AI SDK

У додатках, що використовують laravel/ai, трейт HasPromptTemplate автоматично додає методи instructions() і promptMessages() у ваш клас агента:

use Veeqtoh\PromptDeck\Concerns\HasPromptTemplate;
 
class OrderAgent extends Agent
{
    use HasPromptTemplate;
}

Якщо в .env встановлено PROMPTDECK_SCAFFOLD_ON_MAKE_AGENT=true, команда php artisan make:agent автоматично згенерує відповідну директорію prompt'а.

Prompt Deck доступний на GitHub, а повну документацію дивіться в Prompt Deck docs.