azure-ai-projects_1.0.0b11
Pre-release
Pre-release
1.0.0b11 (2025-05-15)
There have been significant updates with the release of version 1.0.0b11, including breaking changes.
Please see new samples and package README.md file.
Features added
.deployments
methods to enumerate AI models deployed to your AI Foundry Project..datasets
methods to upload documents and reference them. To be used with Evaluations..indexes
methods to handle your Search Indexes.
Breaking changes
- Azure AI Foundry Project endpoint is now required to construct the
AIProjectClient
. It has the form
https://<your-ai-services-account-name>.services.ai.azure.com/api/projects/<your-project-name>
. Find it in your AI Foundry Project
Overview page. The factory methodfrom_connection_string
was removed. - Agents are now implemented in a separate package
azure-ai-agents
. Continue using the ".agents" operations on the
AIProjectsClient
to create, run and delete agents, as before. However there have been some breaking changes in these operations.
See Agents package document and samples for more details. - Several changes to the
.connections
methods, including the response object (now simply calledConnection
) - The method
.inference.get_azure_openai_client()
now supports returning an authenticatedAzureOpenAI
client to be used with
AI models deployed to the Project's AI Services. This is in addition to the existing option to get anAzureOpenAI
client for one of the connected Azure OpenAI services. - Import
PromptTemplate
fromazure.ai.projects
instead ofazure.ai.projects.prompts
. - The class ConnectionProperties was renamed to Connection, and its properties have changed.
- The method
.to_evaluator_model_config
onConnectionProperties
is no longer required and does not have an equivalent method onConnection
. When constructing the EvaluatorConfiguration class, theinit_params
element now requiresdeployment_name
instead ofmodel_config
. - The method
upload_file
onAIProjectClient
had been removed, usedatasets.upload_file
instead. - Evaluator Ids are available using the Enum
EvaluatorIds
and no longer requireazure-ai-evaluation
package to be installed. - Property
scope
onAIProjectClient
is removed, use AI Foundry Project endpoint instead. - Property
id
on Evaluation is replaced withname
.
Sample updates
- All samples have been updated. New ones added for Deployments, Datasets and Indexes.