Working with tools

[butschster]

$agent = new Agent(
    key: self::NAME,
    name: 'Web Scrapping Agent',
    description: 'An agent that scrapes websites to collect URLs and their associated titles.',
    instruction: 'You are a web scraping assistant.',
);

1. In some cases we need to call specific tool or ask LLM that it must use one of the provided tools, but doesn’t force a particular tool.

use LLM\Agents\Tool\ToolChoice;

$aggregate->addMetadata(
    // Instruct an agent to always return tool calls result
    new SolutionMetadata(
        type: MetadataType::Configuration,
        key: 'tool_choice',
        content: ToolChoice::specific('find_links'),
    ),
);

// or

$aggregate->addMetadata(
    // Instruct an agent to always return tool calls result
    new SolutionMetadata(
        type: MetadataType::Configuration,
        key: 'tool_choice',
        content: ToolChoice::any(),
    ),
);

2. Adds a new interceptor for tools execution if LLM asks about it.

$aggregate->addMetadata(
    // Instruct an agent to always return tool calls result
    new SolutionMetadata(
        type: MetadataType::Configuration,
        key: 'return_tool_result',
        content: true,
    ),
);