Skip to main content

​
Agent Properties

Configure tool behavior using these properties in your agent class: 
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';
}
Set $parallelToolCalls to null or remove it to remove parameter from the request entirely. Some models like o1 don’t support parallel tool calls.

​
Tool Choice

Control how the LLM selects and uses tools for each request.

​
Available Modes

ModeDescription
autoLLM decides whether to use tools (default when tools are registered)
noneDisable tool usage for this request
requiredForce the LLM to call at least one tool

​
Runtime Methods

// 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');
toolRequired() and forceTool() only apply to the first LLM call. After that, tool choice automatically switches to auto to prevent infinite loops.
forceTool() requires the tool’s name as a parameter, not the method or class name.

​
Parallel Tool Calls

When enabled, the LLM can request multiple tool calls in a single response, which LarAgent executes together before continuing. 
// 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;
At runtime: 
// Enable parallel execution
$agent->parallelToolCalls(true);

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

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

​
Runtime Tool Management

Add or remove tools dynamically during execution.

​
Adding Tools

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);

​
Removing Tools

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

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

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

​
Conditional Tools

Register tools based on runtime conditions: 
$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);

​
Next Steps

Phantom Tools

Tools that return control to your application for external handling.

Attribute Tools

Create tools using the #[Tool] attribute.

Tool Classes & Inline

Build reusable tool classes or create tools dynamically.