- Added agent tool call tracing support for all tool call types when streaming with AgentEventHandler based event handler
- Added tracing for listing agent run steps
- Utilities to load prompt template strings and Prompty file content
- Added BingCustomSearchTool class with sample
- Added list_threads API to agents namespace
- Added image input support for agents create_message
- Added
project_client.agents.enable_auto_function_calls(toolset=toolset)
to all samples that hastoolcalls
executed byazure-ai-project
SDK - New BingCustomSearchTool sample
- New samples added for image input from url, file and base64
Redesigned automatic function calls because agents retrieved by update_agent
and get_agent
do not support them. With the new design, the toolset parameter in create_agent
no longer executes toolcalls automatically during create_and_process_run
or create_stream
. To retain this behavior, call enable_auto_function_calls
without additional changes.
- New parameters added for Azure AI Search tool, with corresponding sample update.
- Fabric tool REST name updated, along with convenience code.
- Sample update demonstrating new parameters added for Azure AI Search tool.
- Sample added using OpenAPI tool against authenticated TripAdvisor API spec.
- Fix for a bug in Agent tracing causing event handler return values to not be returned when tracing is enabled.
- Fix for a bug in Agent tracing causing tool calls not to be recorded in traces.
- Fix for a bug in Agent tracing causing function tool calls to not work properly when tracing is enabled.
- Fix for a bug in Agent streaming, where
agent_id
was not included in the response. This caused the SDK not to make function calls when the thread run status isrequires_action
.
- Add support for parsing URL citations in Agent text messages. See new classes
MessageTextUrlCitationAnnotation
andMessageDeltaTextUrlCitationAnnotation
. - Add enum value
ConnectionType.API_KEY
to support enumeration of generic connections that uses API Key authentication.
- Update sample
sample_agents_bing_grounding.py
with printout of URL citation. - Add new samples
sample_agents_stream_eventhandler_with_bing_grounding.py
andsample_agents_stream_iteration_with_bing_grounding.py
with printout of URL citation.
- Fix a bug in deserialization of
RunStepDeltaFileSearchToolCall
returned during Agent streaming (see GitHub issue 48333). - Fix for Exception raised while parsing Agent streaming response, in some rare cases, for multibyte UTF-8 languages like Chinese.
- Rename input argument
assistant_id
toagent_id
in all Agent methods to align with the "Agent" terminology. Similarly, rename allassistant_id
properties on classes.
- Added
trace_function
decorator for conveniently tracing function calls in Agents using OpenTelemetry. Please see the README.md for updated documentation.
- Added AzureLogicAppTool utility and Logic App sample under
samples/agents
, folder to make Azure Logic App integration with Agents easier. - Added better observability for Azure AI Search sample for Agents via improved run steps information from the service.
- Added sample to demonstrate how to add custom attributes to telemetry span.
- Lowered the logging level of "Toolset is not available in the client" from
warning
todebug
to prevent unnecessary log entries in agent application runs.
- Add method
.inference.get_image_embeddings_client
onAIProjectClient
to get an authenticatedImageEmbeddingsClient
(from the package azure-ai-inference). You need to have azure-ai-inference package version 1.0.0b7 or above installed for this method to work.
- Fix for events dropped in streamed Agent response (see GitHub issue 39028).
- In Agents, incomplete status thread run event is now deserialized into a ThreadRun object, during stream iteration, and invokes the correct function
on_thread_run
(instead of the wrong functionon_unhandled_event
). - Fix an error when calling the
to_evaluator_model_config
method of classConnectionProperties
. See new input argumentinclude_credentials
.
submit_tool_outputs_to_run
returnsNone
instead ofThreadRun
(see GitHub issue 39028).
- Fix for Agent streaming issue (see GitHub issue 38918)
- Fix for Agent async function
send_email_async
is not called (see GitHub issue 38898) - Fix for Agent streaming with event handler fails with "AttributeError: 'MyEventHandler' object has no attribute 'buffer'" (see GitHub issue 38897)
- Add optional input argument
connection_name
to methods.inference.get_chat_completions_client
,.inference.get_embeddings_client
and.inference.get_azure_openai_client
.
- Add support for Structured Outputs for Agents.
- Add option to include file contents, when index search is used for Agents.
- Added objects to inform Agents about Azure Functions.
- Redesigned streaming and event handlers for agents.
- Add
parallel_tool_calls
parameter to allow parallel tool execution for Agents. - Added
BingGroundingTool
for Agents to use against a Bing API Key connection. - Added
AzureAiSearchTool
for Agents to use against an Azure AI Search resource. - Added
OpenApiTool
for Agents, which creates and executes a REST function defined by an OpenAPI spec. - Added new helper properties in
OpenAIPageableListOfThreadMessage
,MessageDeltaChunk
, andThreadMessage
. - Rename "AI Studio" to "AI Foundry" in package documents and samples, following recent rebranding.
- The method
.agents.get_messages
was removed. Please use.agents.list_messages
instead.
- Fix a bug in the
.inference
operations when Entra ID authentication is used by the default connection. - Fixed bugs occurring during streaming in function tool calls by asynchronous agents.
- Fixed bugs that were causing issues with tracing agent asynchronous functionality.
- Fix a bug causing warning about unclosed session, shown when using asynchronous credentials to create agent.
- Fix a bug that would cause agent function tool related function names and parameters to be included in traces even when content recording is not enabled.
First beta version