Tools: инструменты агента

php artisan make:tool LookupOrder

namespace App\Ai\Tools;

use Illuminate\Contracts\JsonSchema\JsonSchema;
use Laravel\Ai\Contracts\Tool;
use Stringable;

class LookupOrder implements Tool
{
    public function description(): Stringable|string
    {
        return 'Находит заказ по ID и возвращает его статус.';
    }

    public function schema(JsonSchema $schema): array
    {
        return [
            'order_id' => $schema->integer()->required(),
        ];
    }

    public function handle(array $arguments): string
    {
        $order = Order::find($arguments['order_id']);

        if (!$order) {
            return 'Заказ не найден';
        }

        return "Заказ #{$order->id}: статус {$order->status}";
    }
}

use Laravel\Ai\Contracts\HasTools;

class SupportAgent implements Agent, HasTools
{
    use Promptable;

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

    public function tools(): array
    {
        return [
            new LookupOrder,
            new IssueRefund,
        ];
    }
}

public function schema(JsonSchema $schema): array
{
    return [
        'order_id' => $schema->integer()->required(),
        'include_items' => $schema->boolean(),
    ];
}

public function handle(array $arguments): string
{
    // валидация, бизнес-логика
    return $result;
}

public function handle(array $arguments): string
{
    $orderId = $arguments['order_id'] ?? null;

    if (!is_int($orderId)) {
        return 'Ошибка: order_id должен быть числом';
    }

    // ...
}

private const ALLOWED_COLUMNS = [
    'users' => ['id', 'name', 'email'],
    'orders' => ['id', 'total', 'status'],
];

#[MaxSteps(5)]
class SupportAgent implements Agent