Changes for release of azure-ai-projects client library version 1.1.0b1 (#42306)

Author: dargilco

sdk/ai/azure-ai-projects/CHANGELOG.md

@@ -1,10 +1,41 @@
 # Release History
 
-## 1.0.0b13 (Unreleased)
+## 1.1.0b1 (2025-08-01)
+
+First beta version following the 1.0.0 stable release. It brings back the Evaluation and Red-Team operations which are still in preview.
+
+### Features added
+
+* Added methods `cancel` and `delete` to Evaluations.
+
+## 1.0.0 (2025-07-31)
+
+First stable version of the client library. The client library now uses version `v1` of the
+AI Foundry [data plane REST APIs](https://aka.ms/azsdk/azure-ai-projects/ga-rest-api-reference).
 
 ### Breaking changes
 
-* Updated evaluator ids for AOAI graders.
+* Features that are still in preview were removed from this stable release. This includes:
+  * Evaluation operations (property `.evaluations`)
+  * Red-Team operations (property `.red_teams`)
+  * Class `PromptTemplate`.
+  * Package function `enable_telemetry()`
+* Classes were renamed:
+  * Class `Sku` was renamed `ModelDeploymentSku`
+  * Class `SasCredential` was renamed `BlobReferenceSasCredential`
+  * Class `AssetCredentialResponse` was renamed `DatasetCredential`
+* Method `.inference.get_azure_openai_client()` was renamed `.get_openai_client()`. The `.inference` property was removed.
+  The method is documented as returning an object of type `OpenAI`, but it still returns an object of the derived type `AzureOpenAI`.
+  The function implementation has not changed.
+* Method `.telemetry.get_connection_string()` was renamed `.telemetry.get_application_insights_connection_string()`
+
+### Sample updates
+
+* Added a new Dataset sample named `sample_datasets_download.py` to show how you can download all files referenced by a certain Dataset (following a question in [this GitHub issue](https://github.com/Azure/azure-sdk-for-python/issues/41960))
+* Two samples added showing how to do a `responses` operation using an authenticated Azure OpenAI client created
+using `get_openai_client()`.
+* Existing inference samples that used the package function `enable_telemetry()` were updated to remove this call,
+and instead add the necessary tracing configuration calls to the sample.
 
 ## 1.0.0b12 (2025-06-23)
 
@@ -14,7 +45,7 @@
 `.inference.get_embeddings_client()` and `.inference.get_image_embeddings_client()`.
 For guidance on obtaining an authenticated `azure-ai-inference` client for your AI Foundry Project,
 refer to the updated samples in the `samples\inference` directory. For example,
-[sample_chat_completions_with_azure_ai_inference_client.py](https://github.com/Azure/azure-sdk-for-python/blob/main/sdk/ai/azure-ai-projects/samples/inference/sample_chat_completions_with_azure_ai_inference_client.py). Alternatively, use the `.inference.get_azure_openai_client()` method to perform chat completions with an Azure OpenAI client.
+`sample_chat_completions_with_azure_ai_inference_client.py`. Alternatively, use the `.inference.get_azure_openai_client()` method to perform chat completions with an Azure OpenAI client.
 * Method argument name changes:
   * In method `.indexes.create_or_update()` argument `body` was renamed `index`.
   * In method `.datasets.create_or_update()` argument `body` was renamed `dataset_version`.

sdk/ai/azure-ai-projects/README.md

@@ -8,20 +8,25 @@
         "azure.ai.projects.models.AgentEvaluationSamplingConfiguration": "Azure.AI.Projects.AgentEvaluationSamplingConfiguration",
         "azure.ai.projects.models.BaseCredentials": "Azure.AI.Projects.BaseCredentials",
         "azure.ai.projects.models.ApiKeyCredentials": "Azure.AI.Projects.ApiKeyCredentials",
-        "azure.ai.projects.models.AssetCredentialResponse": "Azure.AI.Projects.AssetCredentialResponse",
+        "azure.ai.projects.models.Message": "Azure.AI.Projects.Message",
+        "azure.ai.projects.models.AssistantMessage": "Azure.AI.Projects.AssistantMessage",
         "azure.ai.projects.models.Index": "Azure.AI.Projects.Index",
         "azure.ai.projects.models.AzureAISearchIndex": "Azure.AI.Projects.AzureAISearchIndex",
         "azure.ai.projects.models.TargetConfig": "Azure.AI.Projects.TargetConfig",
         "azure.ai.projects.models.AzureOpenAIModelConfiguration": "Azure.AI.Projects.AzureOpenAIModelConfiguration",
         "azure.ai.projects.models.BlobReference": "Azure.AI.Projects.BlobReference",
+        "azure.ai.projects.models.BlobReferenceSasCredential": "Azure.AI.Projects.SasCredential",
         "azure.ai.projects.models.Connection": "Azure.AI.Projects.Connection",
         "azure.ai.projects.models.CosmosDBIndex": "Azure.AI.Projects.CosmosDBIndex",
         "azure.ai.projects.models.CustomCredential": "Azure.AI.Projects.CustomCredential",
+        "azure.ai.projects.models.DatasetCredential": "Azure.AI.Projects.AssetCredentialResponse",
         "azure.ai.projects.models.DatasetVersion": "Azure.AI.Projects.DatasetVersion",
         "azure.ai.projects.models.Deployment": "Azure.AI.Projects.Deployment",
+        "azure.ai.projects.models.DeveloperMessage": "Azure.AI.Projects.DeveloperMessage",
         "azure.ai.projects.models.EmbeddingConfiguration": "Azure.AI.Projects.EmbeddingConfiguration",
         "azure.ai.projects.models.EntraIDCredentials": "Azure.AI.Projects.EntraIDCredentials",
         "azure.ai.projects.models.Evaluation": "Azure.AI.Projects.Evaluation",
+        "azure.ai.projects.models.EvaluationTarget": "Azure.AI.Projects.EvaluationTarget",
         "azure.ai.projects.models.EvaluatorConfiguration": "Azure.AI.Projects.EvaluatorConfiguration",
         "azure.ai.projects.models.FieldMapping": "Azure.AI.Projects.FieldMapping",
         "azure.ai.projects.models.FileDatasetVersion": "Azure.AI.Projects.FileDatasetVersion",
@@ -30,15 +35,18 @@
         "azure.ai.projects.models.InputDataset": "Azure.AI.Projects.InputDataset",
         "azure.ai.projects.models.ManagedAzureAISearchIndex": "Azure.AI.Projects.ManagedAzureAISearchIndex",
         "azure.ai.projects.models.ModelDeployment": "Azure.AI.Projects.ModelDeployment",
+        "azure.ai.projects.models.ModelDeploymentSku": "Azure.AI.Projects.Sku",
+        "azure.ai.projects.models.ModelResponseGenerationTarget": "Azure.AI.Projects.modelResponseGenerationTarget",
         "azure.ai.projects.models.NoAuthenticationCredentials": "Azure.AI.Projects.NoAuthenticationCredentials",
         "azure.ai.projects.models.PendingUploadRequest": "Azure.AI.Projects.PendingUploadRequest",
         "azure.ai.projects.models.PendingUploadResponse": "Azure.AI.Projects.PendingUploadResponse",
         "azure.ai.projects.models.RedTeam": "Azure.AI.Projects.RedTeam",
-        "azure.ai.projects.models.SasCredential": "Azure.AI.Projects.SasCredential",
         "azure.ai.projects.models.SASCredentials": "Azure.AI.Projects.SASCredentials",
-        "azure.ai.projects.models.Sku": "Azure.AI.Projects.Sku",
+        "azure.ai.projects.models.SystemMessage": "Azure.AI.Projects.SystemMessage",
+        "azure.ai.projects.models.UserMessage": "Azure.AI.Projects.UserMessage",
         "azure.ai.projects.models.ConnectionType": "Azure.AI.Projects.ConnectionType",
         "azure.ai.projects.models.CredentialType": "Azure.AI.Projects.CredentialType",
+        "azure.ai.projects.models.EvaluationTargetType": "Azure.AI.Projects.EvaluationTargetType",
         "azure.ai.projects.models.DatasetType": "Azure.AI.Projects.DatasetType",
         "azure.ai.projects.models.PendingUploadType": "Azure.AI.Projects.PendingUploadType",
         "azure.ai.projects.models.IndexType": "Azure.AI.Projects.IndexType",
@@ -55,6 +63,10 @@
         "azure.ai.projects.aio.operations.EvaluationsOperations.create": "Azure.AI.Projects.Evaluations.create",
         "azure.ai.projects.operations.EvaluationsOperations.create_agent_evaluation": "Azure.AI.Projects.Evaluations.createAgentEvaluation",
         "azure.ai.projects.aio.operations.EvaluationsOperations.create_agent_evaluation": "Azure.AI.Projects.Evaluations.createAgentEvaluation",
+        "azure.ai.projects.operations.EvaluationsOperations.cancel": "Azure.AI.Projects.Evaluations.cancel",
+        "azure.ai.projects.aio.operations.EvaluationsOperations.cancel": "Azure.AI.Projects.Evaluations.cancel",
+        "azure.ai.projects.operations.EvaluationsOperations.delete": "Azure.AI.Projects.Evaluations.delete",
+        "azure.ai.projects.aio.operations.EvaluationsOperations.delete": "Azure.AI.Projects.Evaluations.delete",
         "azure.ai.projects.operations.DatasetsOperations.list_versions": "Azure.AI.Projects.Datasets.listVersions",
         "azure.ai.projects.aio.operations.DatasetsOperations.list_versions": "Azure.AI.Projects.Datasets.listVersions",
         "azure.ai.projects.operations.DatasetsOperations.list": "Azure.AI.Projects.Datasets.listLatest",

sdk/ai/azure-ai-projects/apiview-properties.json

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "python",
   "TagPrefix": "python/ai/azure-ai-projects",
-  "Tag": "python/ai/azure-ai-projects_8e58b42168"
+  "Tag": "python/ai/azure-ai-projects_85a150439d"
 }

sdk/ai/azure-ai-projects/assets.json

@@ -45,12 +45,10 @@ class AIProjectClient:
     :ivar red_teams: RedTeamsOperations operations
     :vartype red_teams: azure.ai.projects.operations.RedTeamsOperations
     :param endpoint: Project endpoint. In the form
-     "https://<your-ai-services-account-name>.services.ai.azure.com/api/projects/_project"
+     "https://your-ai-services-account-name.services.ai.azure.com/api/projects/_project"
      if your Foundry Hub has only one Project, or to use the default Project in your Hub. Or in the
-     form
-     "https://<your-ai-services-account-name>.services.ai.azure.com/api/projects/<your-project-name>"
-     if you want to explicitly
-     specify the Foundry Project name. Required.
+     form "https://your-ai-services-account-name.services.ai.azure.com/api/projects/your-project-name"
+     if you want to explicitly specify the Foundry Project name. Required.
     :type endpoint: str
     :param credential: Credential used to authenticate requests to the service. Required.
     :type credential: ~azure.core.credentials.TokenCredential

sdk/ai/azure-ai-projects/azure/ai/projects/_client.py

@@ -23,12 +23,10 @@ class AIProjectClientConfiguration:  # pylint: disable=too-many-instance-attribu
     attributes.
 
     :param endpoint: Project endpoint. In the form
-     "https://<your-ai-services-account-name>.services.ai.azure.com/api/projects/_project"
+     "https://your-ai-services-account-name.services.ai.azure.com/api/projects/_project"
      if your Foundry Hub has only one Project, or to use the default Project in your Hub. Or in the
-     form
-     "https://<your-ai-services-account-name>.services.ai.azure.com/api/projects/<your-project-name>"
-     if you want to explicitly
-     specify the Foundry Project name. Required.
+     form "https://your-ai-services-account-name.services.ai.azure.com/api/projects/your-project-name"
+     if you want to explicitly specify the Foundry Project name. Required.
     :type endpoint: str
     :param credential: Credential used to authenticate requests to the service. Required.
     :type credential: ~azure.core.credentials.TokenCredential