Configuration & Runtime

class MyAgent extends Agent
{
    /** @var array - Tool classes to register with the agent */
    protected $tools = [
        WeatherTool::class,
        CalendarTool::class,
    ];

    /** @var bool|null - Whether tools can execute in parallel */
    protected $parallelToolCalls = true;

    /** @var string - Tool selection mode: 'auto', 'none', or 'required' */
    protected $toolChoice = 'auto';
}

// Disable tools for this specific call
WeatherAgent::for('chat-123')
    ->toolNone()
    ->respond('What is your name?');

// Require at least one tool call
WeatherAgent::for('chat-123')
    ->toolRequired()
    ->respond('What is the weather?');

// Force a specific tool to be used
WeatherAgent::for('chat-123')
    ->forceTool('get_weather')
    ->respond('Check the weather in Paris');

// Set tool choice programmatically
$agent->setToolChoice('none');
$agent->setToolChoice('required');
$agent->setToolChoice('auto');

// Enable parallel tool calls (default)
protected $parallelToolCalls = true;

// Disable parallel tool calls
protected $parallelToolCalls = false;

// Remove from request (for models that don't support it)
protected $parallelToolCalls = null;

// Enable parallel execution
$agent->parallelToolCalls(true);

// Disable parallel execution
$agent->parallelToolCalls(false);

// Remove from request
$agent->parallelToolCalls(null);

use LarAgent\Tool;

// Add a tool class
$agent->withTool(WeatherTool::class);

// Add an inline tool instance
$tool = Tool::create('get_time', 'Get current server time')
    ->setCallback(fn() => now()->toIso8601String());

$agent->withTool($tool);

// Remove by tool name
$agent->removeTool('get_weather');

// Remove by class name
$agent->removeTool(WeatherTool::class);

// Remove by instance
$agent->removeTool($tool);

$user = auth()->user();

$agent = MyAgent::for($user->id);

// Add tools based on user permissions
if ($user->can('manage_calendar')) {
    $agent->withTool(CalendarTool::class);
}

if ($user->isAdmin()) {
    $agent->withTool(AdminTool::class);
}

$response = $agent->respond($message);