Build AI Agent in Laravel

<?php

namespace App\Agents;

use App\Tools\GetPlayerProfileTool;
use NeuronAI\Agent;
use NeuronAI\Chat\History\InMemoryChatHistory;
use NeuronAI\Providers\AIProviderInterface;
use NeuronAI\Providers\Gemini\Gemini;
use NeuronAI\SystemPrompt;
use NeuronAI\Tools\Tool;
use NeuronAI\Tools\ToolProperty;

class ChessAgent extends Agent
{
    protected function provider(): AIProviderInterface
    {
        return new Gemini(
            key: 'your-api-key',
            model: 'gemini-2.0-flash-lite',
        );
    }

    public function instructions(): string
    {
        return new SystemPrompt(
            background: [
                'You are an AI agent specializing in analyzing chess games',
            ],
            steps: [
                'Check if the user has provided a username. If not, prompt them to enter one.',
                'Call the "get_player_name" tool to retrieve the player\'s profile and recent games.',
                'Analyze the player\'s game history, performance, and openings used.',
            ],
            output: [
                'Respond to the user with a well-written paragraph summarizing the player\'s profile and recent games.',
                'Only include a profile summary if the user did not ask a specific question.',
                'Convert Unix timestamps (e.g., 1746541293) to human-readable date and time formats:',
                '- Use the player\'s country (from profile data) to determine their local timezone.',
                '- Display time in 12-hour format (e.g., 02:15 PM) instead of 24-hour format.',
                'If data retrieval fails (e.g., player not found), return a clear, user-friendly error message explaining the issue and offering suggestions (e.g., check for typos, try a different username, or try again later).',
                'Note: The `eco` field in game data refers to the opening code used in the game.',
            ]
        );
    }

    protected function tools(): array
    {
        return [
            Tool::make(
                'get_player_name',
                'Retrieve a player\'s profile and recent games for analysis.',
            )->addProperty(
                new ToolProperty(
                    name: 'playerName',
                    type: 'string',
                    description: 'The player name',
                    required: true
                )
            )->setCallable(new GetPlayerProfileTool),
        ];
    }

    protected function chatHistory(): InMemoryChatHistory
    {
        return new InMemoryChatHistory(
            contextWindow: 50000
        );
    }
}

<?php

namespace App\Tools;

use Illuminate\Http\Client\Pool;
use Illuminate\Support\Facades\Cache;
use Illuminate\Support\Facades\Http;

class GetPlayerProfileTool
{
    public function __invoke(string $playerName): array
    {
        return Cache::remember("player_profile_{$playerName}", now()->addMinute(), function () use ($playerName) {
            $currentMonth = now()->format('Y/m');
            $previousMonth = now()->subMonth()->format('Y/m');

            [$profileResponse, $statsResponse, $currentMonthResponse, $previousMonthResponse] = Http::pool(function (Pool $pool) use ($playerName, $currentMonth, $previousMonth) {
                return [
                    $pool->get("https://api.chess.com/pub/player/{$playerName}"),
                    $pool->get("https://api.chess.com/pub/player/{$playerName}/stats"),
                    $pool->get("https://api.chess.com/pub/player/{$playerName}/games/{$currentMonth}"),
                    $pool->get("https://api.chess.com/pub/player/{$playerName}/games/{$previousMonth}"),
                ];
            });

            return [
                'profile' => $profileResponse->json(),
                'stats' => $statsResponse->json(),
                'games' => [
                    'current_month' => $currentMonthResponse->json(),
                    'previous_month' => $previousMonthResponse->json(),
                ],
            ];
        });
    }
}

use App\Agents\ChessAgent;
use NeuronAI\Chat\Messages\UserMessage;

$response = ChessAgent::make()
    ->chat(new UserMessage('JaPoe99 is my username and which three chess opening that I mostly used'))
    ->getContent();

<?php

namespace App\Console\Commands;

use App\Agents\ChessAgent;
use Illuminate\Console\Command;
use NeuronAI\Chat\Messages\UserMessage;

use function Laravel\Prompts\info;
use function Laravel\Prompts\spin;
use function Laravel\Prompts\text;

class ChessAgentCommand extends Command
{
    protected $signature = 'chess:agent';

    protected $description = 'Chess Agent Command';

    public function handle()
    {
        $agent = ChessAgent::make();

        info('Welcome to the Chess Agent!');

        while (true) {
            $question = text('');

            $response = spin(
                message: 'Thinking...',
                callback: fn () => $agent->chat(
                    new UserMessage($question)
                )
            );

            info($response->getContent());
        }
    }
}