Adding custom request parameters

[Ahrengot]

Hey all 👋🏻

Really loving Prism so far!

I'm trying to implement XAI Live Search, but I’m struggling to figure out how to include search_parameters in the request body.

I need to essentially build this request:

Http::post('https://api.x.ai/v1/chat/completions', [
    'model'    => 'grok-4-fast-non-reasoning',
    'messages' => [
        [
            'role'    => 'user',
            'content' => 'What are some uplifting news articles from today?',
        ],
    ],
    'search_parameters' => [
        'mode'      => 'auto',
        'from_date' => now()->subDay()->format('Y-m-d'),
        'to_date'   => now()->format('Y-m-d'),
    ],
]);

Initially, I assumed provider options were just forwarded to the request body, so I tried this:

Prism::text()
    ->using(Provider::XAI, 'grok-4-fast-non-reasoning')
    ->withProviderOptions([
        'search_parameters' => [
            'mode'      => 'auto',
            'from_date' => now()->subDay()->format('Y-m-d'),
            'to_date'   => now()->format('Y-m-d'),
        ],
    ])
    ->withPrompt('What are some uplifting news articles from today?')
    ->toRequest();

After a bit of source diving, it looks like provider options aren’t just passed through — they’re used differently for each provider (e.g. https://github.com/prism-php/prism/blob/main/src/Providers/XAI/Concerns/ExtractsThinking.php#L16).

So yeah — is there any way to hook into or modify the outgoing request to add custom parameters like this?

[BenyominMandel]

…yeah I think the right thing for the xAI provider is to move toward the newer Responses/agent tools API instead of patching search_parameters in chat — because the old Live Search tool is being deprecated soon and replaced with the agentic tool approach that uses search tools like web_search / x_search