Урок 01

Что такое Laravel AI SDK

Laravel AI SDK — официальный пакет Laravel для создания AI-приложений на PHP. Вышел вместе с Laravel 13. Это не обёртка над одним провайдером, а унифицированный API для 14+ AI-провайдеров: OpenAI, Anthropic, Gemini, Groq, Mistral, DeepSeek, xAI, Ollama, Azure OpenAI, Cohere, OpenRouter, Jina, VoyageAI, ElevenLabs.

Зачем нужен

До AI SDK работа с AI в Laravel выглядела так:

  • Отдельная библиотека под каждого провайдера
  • Свой синтаксис для OpenAI, свой для Anthropic
  • Ручная обработка стриминга, очередей, ошибок
  • Нет интеграции с Eloquent и Laravel-очередями

AI SDK решает это: один синтаксис для всех провайдеров.

Что даёт

  • Агенты — PHP-классы с инструкциями, инструментами, памятью
  • Структурированный вывод — типизированный JSON вместо текста
  • Стриминг — SSE в реальном времени
  • Очереди — тяжёлые запросы в фон
  • Embeddings — вектора для поиска
  • Vector store — семантический поиск
  • Изображения, аудио, транскрипция — генерация и обработка
  • Автоматический failover — переключение провайдера при сбое

Требования

  • PHP 8.3+ (Laravel 13 требует)
  • Laravel 13
  • API-ключ хотя бы одного провайдера

Установка

composer require laravel/ai

Конфиг публикуется:

php artisan vendor:publish --tag=ai-config

В .env — ключи провайдеров:

OPENAI_API_KEY=sk-...
ANTHROPIC_API_KEY=sk-ant-...
GEMINI_API_KEY=...

Первый агент

php artisan make:agent SupportAgent

namespace App\Ai\Agents;

use Laravel\Ai\Contracts\Agent;
use Laravel\Ai\Promptable;

class SupportAgent implements Agent
{
    use Promptable;

    public function instructions(): string
    {
        return 'Ты — агент поддержки. Помогай пользователям решать проблемы.';
    }
}

Использование:

$response = SupportAgent::make()->prompt('Как сбросить пароль?');

return (string) $response;

Что дальше

В следующих уроках: провайдеры, инструкции, structured output, стриминг, очереди.

Итоги

  • AI SDK — официальный пакет Laravel
  • 14+ провайдеров, один API
  • Агенты, tools, стриминг, очереди
  • PHP 8.3+ и Laravel 13
  • composer require laravel/ai