Python: Bug: `extra_parameters` should be passed as `model_extras` to the ChatCompletionsClient.complete() method,

[dargilco]

Copied from: Azure/azure-sdk-for-python#42561

Package Name: azure-ai-inference
Package Version: 1.0.0b9
Operating System: macOS
Python Version: Python: 3.11.1
Describe the bug
When using AzureAIInferenceChatPromptExecutionSettings with extra_parameters to pass GPT-5 reasoning parameters (reasoning_effort, verbosity, enable_preamble), the SDK throws an error:
ClientSession._request() got an unexpected keyword argument 'extra_parameters'

To Reproduce
Steps to reproduce the behavior:

Create AzureAIInferenceChatPromptExecutionSettings with extra_parameters:
from semantic_kernel.connectors.ai.azure_ai_inference import AzureAIInferenceChatPromptExecutionSettings

settings = AzureAIInferenceChatPromptExecutionSettings(
temperature=0.5,
max_tokens=4000,
extra_parameters={
'reasoning_effort': 'medium',
'verbosity': 'medium',
'enable_preamble': True,
'reasoning_summary': 'auto'
}
)
Pass settings to ChatCompletionAgent via KernelArguments
Invoke agent with these settings
Error occurs when the SDK tries to make the API call
Expected behavior

The extra_parameters should be passed as model_extras to the ChatCompletionsClient.complete() method, allowing GPT-5 reasoning parameters to be used.

Actual Behavior

The SDK incorrectly passes extra_parameters as a keyword argument to the underlying HTTP client, causing the error.

Additional context

This bug prevents using GPT-5's new reasoning features (reasoning_effort, verbosity, preamble) through Azure AI Foundry with Semantic Kernel, blocking access to key GPT-5 capabilities announced in the recent GA release. This affects adoption of GPT-5 models as the reasoning visibility is a key differentiating feature.

Environment

Python: 3.11.1
azure-ai-inference: 1.0.0b9
semantic-kernel: 1.35.2
OS: macOS

[dargilco]

Per https://learn.microsoft.com/en-us/python/api/azure-ai-inference/azure.ai.inference.chatcompletionsclient?view=azure-python-preview , ChatCompletionsClient supports models_extra as a dict of additional parameters that gets passed to the model on the root of the request.

[dargilco]

Opening this issue on behalf of marvika

[moonbox3]

Devs can use AzureChatCompletion which supports the use of gpt-5 right now. What's specific to Azure AI Inference? Thanks. @marvika

[dargilco]

@moonbox3 @marvika If Semantic Kernel is calling any one of the clients implemented in azure-ai-inference package, and extra parameters are needed to pass in at the root of the request payload, they need to be set as the input dict model_extras when you create the azure-ai-inference client. For example, see the ChatCompletionsClient: https://learn.microsoft.com/en-us/python/api/azure-ai-inference/azure.ai.inference.chatcompletionsclient?view=azure-python-preview. Sounds like this is not being done at the moment - instead a parameter named extra_parameters is passed in, which is rejected by the service. You simply need to rename the parameter before you construct the azure-ai-inference client.

[moonbox3]

@TaoChenOSU can you help take a look at this, please?