Structured Output: типизированный JSON

$response = (new SalesCoach)->prompt('Оцени транскрипт от 1 до 10');

// Хрупкий парсинг
preg_match('/оценка[:\s]*(\d+)/i', (string) $response, $matches);
$score = (int) ($matches[1] ?? 0);

namespace App\Ai\Agents;

use Illuminate\Contracts\JsonSchema\JsonSchema;
use Laravel\Ai\Contracts\Agent;
use Laravel\Ai\Contracts\HasStructuredOutput;
use Laravel\Ai\Promptable;

class SalesCoach implements Agent, HasStructuredOutput
{
    use Promptable;

    public function instructions(): string
    {
        return 'Ты — sales-коуч. Анализируй транскрипты и возвращай структурированную обратную связь.';
    }

    public function schema(JsonSchema $schema): array
    {
        return [
            'feedback' => $schema->string()->required(),
            'score' => $schema->integer()->min(1)->max(10)->required(),
        ];
    }
}

$response = (new SalesCoach)->prompt('Проанализируй транскрипт...');

$score = $response['score'];       // int, 1–10
$feedback = $response['feedback']; // string

php artisan make:agent SalesCoach --structured

'score' => $schema->integer()->min(1)->max(10)->required(),
'feedback' => $schema->string()->required(),
'tags' => $schema->array()->items($schema->string()),
'published' => $schema->boolean(),
'rating' => $schema->number()->min(0)->max(5),

return [
    'summary' => $schema->string()->required(),
    'analysis' => $schema->object(fn ($s) => [
        'strengths' => $s->array()->items($s->string()),
        'weaknesses' => $s->array()->items($s->string()),
    ])->required(),
];

'priority' => $schema->string()->enum(['low', 'medium', 'high'])->required(),