Skip to content

azure-ai-projects_1.0.0b11

Pre-release
Pre-release
Compare
Choose a tag to compare
@azure-sdk azure-sdk released this 16 May 00:29
e92add4

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 method from_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 called Connection)
  • The method .inference.get_azure_openai_client() now supports returning an authenticated AzureOpenAI client to be used with
    AI models deployed to the Project's AI Services. This is in addition to the existing option to get an AzureOpenAI client for one of the connected Azure OpenAI services.
  • Import PromptTemplate from azure.ai.projects instead of azure.ai.projects.prompts.
  • The class ConnectionProperties was renamed to Connection, and its properties have changed.
  • The method .to_evaluator_model_config on ConnectionProperties is no longer required and does not have an equivalent method on Connection. When constructing the EvaluatorConfiguration class, the init_params element now requires deployment_name instead of model_config.
  • The method upload_file on AIProjectClient had been removed, use datasets.upload_file instead.
  • Evaluator Ids are available using the Enum EvaluatorIds and no longer require azure-ai-evaluation package to be installed.
  • Property scope on AIProjectClient is removed, use AI Foundry Project endpoint instead.
  • Property id on Evaluation is replaced with name.

Sample updates

  • All samples have been updated. New ones added for Deployments, Datasets and Indexes.