Jhakulin/delete ops update (Azure#41025)

* update delete ops

* Made public delete_* functions and update samples, test, readme

* keep delete method names the same as before

* update README

* keep preview tools until we make first stable version

* update apiview properties

* update azure function samples

* fix mypy

* update to use 2025-05-15-preview

* added recording for some sync test

* added vectore store tests

* Resolved comments

* Comment out all async test since recording has issue with proxy

* run black

* update chagne log na rename function

* rever .env

* clean up

* trigger build

* fix test and upgrade api version

* added tracing recording

* rebase

---------

Co-authored-by: jhakulin <[email protected]>

Author: howieleung

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

@@ -5,14 +5,15 @@
 ### Breaking Changes
 
 - enable_auto_function_calls supports positional arguments instead of keyword arguments.
+- Rename `get_last_text_message_by_role` to `get_last_message_text_by_role`.
 
 ### Features Added
 
-- Initial version - splits off Azure AI Agents functionality from the Azure AI Projects SDK
-- Azure AI Search tool, Bing Grounding tool, and Bing Custom Search tool parameters updated
+- Initial version - splits off Azure AI Agents functionality from the Azure AI Projects SDK.
+- Azure AI Search tool, Bing Grounding tool, and Bing Custom Search tool parameters updated.
 - All polling functions now support timeout keyword parameter.
 
 ### Bugs Fixed
 
 - During automatic function calls for streaming, when the thread run is cancelled due to too many retry, now a cancelled event will be sent out.
-- Add missing thread run id and message id on the process thread run span
+- Add missing thread run id and message id on the process thread run span.

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

@@ -1174,6 +1174,7 @@ configure_azure_monitor(connection_string=application_insights_connection_string
 
 try:
     from azure.ai.agents.telemetry import AIAgentsInstrumentor
+
     agents_instrumentor = AIAgentsInstrumentor()
     if not agents_instrumentor.is_instrumented():
         agents_instrumentor.instrument()

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

@@ -2,7 +2,6 @@
     "CrossLanguagePackageId": "Azure.AI.Agents",
     "CrossLanguageDefinitionId": {
         "azure.ai.agents.models.Agent": "Azure.AI.Agents.Agent",
-        "azure.ai.agents.models.AgentDeletionStatus": "Azure.AI.Agents.AgentDeletionStatus",
         "azure.ai.agents.models.AgentsNamedToolChoice": "Azure.AI.Agents.AgentsNamedToolChoice",
         "azure.ai.agents.models.AgentsResponseFormat": "Azure.AI.Agents.AgentsResponseFormat",
         "azure.ai.agents.models.AgentThread": "Azure.AI.Agents.AgentThread",
@@ -25,7 +24,6 @@
         "azure.ai.agents.models.CodeInterpreterToolResource": "Azure.AI.Agents.CodeInterpreterToolResource",
         "azure.ai.agents.models.ConnectedAgentDetails": "Azure.AI.Agents.ConnectedAgentDetails",
         "azure.ai.agents.models.ConnectedAgentToolDefinition": "Azure.AI.Agents.ConnectedAgentToolDefinition",
-        "azure.ai.agents.models.FileDeletionStatus": "Azure.AI.Agents.FileDeletionStatus",
         "azure.ai.agents.models.FileInfo": "Azure.AI.Agents.FileInfo",
         "azure.ai.agents.models.FileListResponse": "Azure.AI.Agents.FileListResponse",
         "azure.ai.agents.models.FileSearchRankingOptions": "Azure.AI.Agents.FileSearchRankingOptions",
@@ -132,7 +130,6 @@
         "azure.ai.agents.models.SharepointToolDefinition": "Azure.AI.Agents.SharepointToolDefinition",
         "azure.ai.agents.models.SubmitToolOutputsAction": "Azure.AI.Agents.SubmitToolOutputsAction",
         "azure.ai.agents.models.SubmitToolOutputsDetails": "Azure.AI.Agents.SubmitToolOutputsDetails",
-        "azure.ai.agents.models.ThreadDeletionStatus": "Azure.AI.Agents.ThreadDeletionStatus",
         "azure.ai.agents.models.ThreadMessage": "Azure.AI.Agents.ThreadMessage",
         "azure.ai.agents.models.ThreadMessageOptions": "Azure.AI.Agents.ThreadMessageOptions",
         "azure.ai.agents.models.ThreadRun": "Azure.AI.Agents.ThreadRun",
@@ -152,12 +149,10 @@
         "azure.ai.agents.models.VectorStoreConfiguration": "Azure.AI.Agents.VectorStoreConfiguration",
         "azure.ai.agents.models.VectorStoreConfigurations": "Azure.AI.Agents.VectorStoreConfigurations",
         "azure.ai.agents.models.VectorStoreDataSource": "Azure.AI.Agents.VectorStoreDataSource",
-        "azure.ai.agents.models.VectorStoreDeletionStatus": "Azure.AI.Agents.VectorStoreDeletionStatus",
         "azure.ai.agents.models.VectorStoreExpirationPolicy": "Azure.AI.Agents.VectorStoreExpirationPolicy",
         "azure.ai.agents.models.VectorStoreFile": "Azure.AI.Agents.VectorStoreFile",
         "azure.ai.agents.models.VectorStoreFileBatch": "Azure.AI.Agents.VectorStoreFileBatch",
         "azure.ai.agents.models.VectorStoreFileCount": "Azure.AI.Agents.VectorStoreFileCount",
-        "azure.ai.agents.models.VectorStoreFileDeletionStatus": "Azure.AI.Agents.VectorStoreFileDeletionStatus",
         "azure.ai.agents.models.VectorStoreFileError": "Azure.AI.Agents.VectorStoreFileError",
         "azure.ai.agents.models.VectorStoreStaticChunkingStrategyOptions": "Azure.AI.Agents.VectorStoreStaticChunkingStrategyOptions",
         "azure.ai.agents.models.VectorStoreStaticChunkingStrategyRequest": "Azure.AI.Agents.VectorStoreStaticChunkingStrategyRequest",
@@ -207,8 +202,6 @@
         "azure.ai.agents.aio.operations.ThreadsOperations.get": "Azure.AI.Agents.Threads.getThread",
         "azure.ai.agents.operations.ThreadsOperations.update": "Azure.AI.Agents.Threads.updateThread",
         "azure.ai.agents.aio.operations.ThreadsOperations.update": "Azure.AI.Agents.Threads.updateThread",
-        "azure.ai.agents.operations.ThreadsOperations.delete": "Azure.AI.Agents.Threads.deleteThread",
-        "azure.ai.agents.aio.operations.ThreadsOperations.delete": "Azure.AI.Agents.Threads.deleteThread",
         "azure.ai.agents.operations.MessagesOperations.create": "Azure.AI.Agents.Messages.createMessage",
         "azure.ai.agents.aio.operations.MessagesOperations.create": "Azure.AI.Agents.Messages.createMessage",
         "azure.ai.agents.operations.MessagesOperations.list": "Azure.AI.Agents.Messages.listMessages",
@@ -235,8 +228,6 @@
         "azure.ai.agents.aio.operations.RunStepsOperations.list": "Azure.AI.Agents.RunSteps.listRunSteps",
         "azure.ai.agents.operations.FilesOperations.list": "Azure.AI.Agents.Files.listFiles",
         "azure.ai.agents.aio.operations.FilesOperations.list": "Azure.AI.Agents.Files.listFiles",
-        "azure.ai.agents.operations.FilesOperations.delete": "Azure.AI.Agents.Files.deleteFile",
-        "azure.ai.agents.aio.operations.FilesOperations.delete": "Azure.AI.Agents.Files.deleteFile",
         "azure.ai.agents.operations.FilesOperations.get": "Azure.AI.Agents.Files.getFile",
         "azure.ai.agents.aio.operations.FilesOperations.get": "Azure.AI.Agents.Files.getFile",
         "azure.ai.agents.operations.VectorStoresOperations.list": "Azure.AI.Agents.VectorStores.listVectorStores",
@@ -247,16 +238,12 @@
         "azure.ai.agents.aio.operations.VectorStoresOperations.get": "Azure.AI.Agents.VectorStores.getVectorStore",
         "azure.ai.agents.operations.VectorStoresOperations.modify": "Azure.AI.Agents.VectorStores.modifyVectorStore",
         "azure.ai.agents.aio.operations.VectorStoresOperations.modify": "Azure.AI.Agents.VectorStores.modifyVectorStore",
-        "azure.ai.agents.operations.VectorStoresOperations.delete": "Azure.AI.Agents.VectorStores.deleteVectorStore",
-        "azure.ai.agents.aio.operations.VectorStoresOperations.delete": "Azure.AI.Agents.VectorStores.deleteVectorStore",
         "azure.ai.agents.operations.VectorStoreFilesOperations.list": "Azure.AI.Agents.VectorStoreFiles.listVectorStoreFiles",
         "azure.ai.agents.aio.operations.VectorStoreFilesOperations.list": "Azure.AI.Agents.VectorStoreFiles.listVectorStoreFiles",
         "azure.ai.agents.operations.VectorStoreFilesOperations.create": "Azure.AI.Agents.VectorStoreFiles.createVectorStoreFile",
         "azure.ai.agents.aio.operations.VectorStoreFilesOperations.create": "Azure.AI.Agents.VectorStoreFiles.createVectorStoreFile",
         "azure.ai.agents.operations.VectorStoreFilesOperations.get": "Azure.AI.Agents.VectorStoreFiles.getVectorStoreFile",
         "azure.ai.agents.aio.operations.VectorStoreFilesOperations.get": "Azure.AI.Agents.VectorStoreFiles.getVectorStoreFile",
-        "azure.ai.agents.operations.VectorStoreFilesOperations.delete": "Azure.AI.Agents.VectorStoreFiles.deleteVectorStoreFile",
-        "azure.ai.agents.aio.operations.VectorStoreFilesOperations.delete": "Azure.AI.Agents.VectorStoreFiles.deleteVectorStoreFile",
         "azure.ai.agents.operations.VectorStoreFileBatchesOperations.create": "Azure.AI.Agents.VectorStoreFileBatches.createVectorStoreFileBatch",
         "azure.ai.agents.aio.operations.VectorStoreFileBatchesOperations.create": "Azure.AI.Agents.VectorStoreFileBatches.createVectorStoreFileBatch",
         "azure.ai.agents.operations.VectorStoreFileBatchesOperations.get": "Azure.AI.Agents.VectorStoreFileBatches.getVectorStoreFileBatch",
@@ -273,8 +260,6 @@
         "azure.ai.agents.aio.AgentsClient.get_agent": "Azure.AI.Agents.getAgent",
         "azure.ai.agents.AgentsClient.update_agent": "Azure.AI.Agents.updateAgent",
         "azure.ai.agents.aio.AgentsClient.update_agent": "Azure.AI.Agents.updateAgent",
-        "azure.ai.agents.AgentsClient.delete_agent": "Azure.AI.Agents.deleteAgent",
-        "azure.ai.agents.aio.AgentsClient.delete_agent": "Azure.AI.Agents.deleteAgent",
         "azure.ai.agents.AgentsClient.create_thread_and_run": "Azure.AI.Agents.createThreadAndRun",
         "azure.ai.agents.aio.AgentsClient.create_thread_and_run": "Azure.AI.Agents.createThreadAndRun"
     }

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

@@ -2,5 +2,5 @@
   "AssetsRepo": "Azure/azure-sdk-assets",
   "AssetsRepoPrefixPath": "python",
   "TagPrefix": "python/ai/azure-ai-agents",
-  "Tag": "python/ai/azure-ai-agents_dab4ae41b1"
+  "Tag": "python/ai/azure-ai-agents_5d6ca21785"
 }

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

@@ -56,8 +56,9 @@ class AgentsClient(AgentsClientOperationsMixin):  # pylint: disable=too-many-ins
     :type endpoint: str
     :param credential: Credential used to authenticate requests to the service. Required.
     :type credential: ~azure.core.credentials.TokenCredential
-    :keyword api_version: The API version to use for this operation. Default value is "v1". Note
-     that overriding this default value may result in unsupported behavior.
+    :keyword api_version: The API version to use for this operation. Default value is
+     "2025-05-15-preview". Note that overriding this default value may result in unsupported
+     behavior.
     :paramtype api_version: str
     """
 

sdk/ai/azure-ai-agents/azure/ai/agents/_configuration.py

@@ -27,13 +27,14 @@ class AgentsClientConfiguration:  # pylint: disable=too-many-instance-attributes
     :type endpoint: str
     :param credential: Credential used to authenticate requests to the service. Required.
     :type credential: ~azure.core.credentials.TokenCredential
-    :keyword api_version: The API version to use for this operation. Default value is "v1". Note
-     that overriding this default value may result in unsupported behavior.
+    :keyword api_version: The API version to use for this operation. Default value is
+     "2025-05-15-preview". Note that overriding this default value may result in unsupported
+     behavior.
     :paramtype api_version: str
     """
 
     def __init__(self, endpoint: str, credential: "TokenCredential", **kwargs: Any) -> None:
-        api_version: str = kwargs.pop("api_version", "v1")
+        api_version: str = kwargs.pop("api_version", "2025-05-15-preview")
 
         if endpoint is None:
             raise ValueError("Parameter 'endpoint' must not be None.")

sdk/ai/azure-ai-agents/azure/ai/agents/_patch.py

@@ -63,7 +63,7 @@ def __init__(self, endpoint: str, credential: TokenCredential, **kwargs: Any) ->
             )
             # Override the credential scope with the legacy one.
             kwargs["credential_scopes"] = ["https://management.azure.com/.default"]
-            kwargs["api_version"] = "2025_05_01"
+            kwargs["api_version"] = "2025-05-15-preview"
         # End of legacy endpoints handling.
         super().__init__(endpoint, credential, **kwargs)
 
@@ -597,18 +597,15 @@ def _validate_tools_and_tool_resources(
             )
 
     @distributed_trace
-    def delete_agent(  # pylint: disable=delete-operation-wrong-return-type
-        self, agent_id: str, **kwargs: Any
-    ) -> _models.AgentDeletionStatus:
+    def delete_agent(self, agent_id: str, **kwargs: Any) -> None:
         """Deletes an agent.
 
         :param agent_id: Identifier of the agent. Required.
         :type agent_id: str
-        :return: AgentDeletionStatus. The AgentDeletionStatus is compatible with MutableMapping
-        :rtype: ~azure.ai.agents.models.AgentDeletionStatus
+        :rtype: None
         :raises ~azure.core.exceptions.HttpResponseError:
         """
-        return super().delete_agent(agent_id, **kwargs)
+        super()._delete_agent(agent_id, **kwargs)
 
     @distributed_trace
     def enable_auto_function_calls(  # pylint: disable=client-method-missing-kwargs

sdk/ai/azure-ai-agents/azure/ai/agents/aio/_client.py

@@ -57,8 +57,9 @@ class AgentsClient(AgentsClientOperationsMixin):  # pylint: disable=too-many-ins
     :type endpoint: str
     :param credential: Credential used to authenticate requests to the service. Required.
     :type credential: ~azure.core.credentials_async.AsyncTokenCredential
-    :keyword api_version: The API version to use for this operation. Default value is "v1". Note
-     that overriding this default value may result in unsupported behavior.
+    :keyword api_version: The API version to use for this operation. Default value is
+     "2025-05-15-preview". Note that overriding this default value may result in unsupported
+     behavior.
     :paramtype api_version: str
     """
 

sdk/ai/azure-ai-agents/azure/ai/agents/aio/_configuration.py

@@ -27,13 +27,14 @@ class AgentsClientConfiguration:  # pylint: disable=too-many-instance-attributes
     :type endpoint: str
     :param credential: Credential used to authenticate requests to the service. Required.
     :type credential: ~azure.core.credentials_async.AsyncTokenCredential
-    :keyword api_version: The API version to use for this operation. Default value is "v1". Note
-     that overriding this default value may result in unsupported behavior.
+    :keyword api_version: The API version to use for this operation. Default value is
+     "2025-05-15-preview". Note that overriding this default value may result in unsupported
+     behavior.
     :paramtype api_version: str
     """
 
     def __init__(self, endpoint: str, credential: "AsyncTokenCredential", **kwargs: Any) -> None:
-        api_version: str = kwargs.pop("api_version", "v1")
+        api_version: str = kwargs.pop("api_version", "2025-05-15-preview")
 
         if endpoint is None:
             raise ValueError("Parameter 'endpoint' must not be None.")

sdk/ai/azure-ai-agents/azure/ai/agents/aio/_patch.py

@@ -64,7 +64,7 @@ def __init__(self, endpoint: str, credential: "AsyncTokenCredential", **kwargs:
             )
             # Override the credential scope with the legacy one.
             kwargs["credential_scopes"] = ["https://management.azure.com/.default"]
-            kwargs["api_version"] = "2025_05_01"
+            kwargs["api_version"] = "2025-05-15-preview"
         # End of legacy endpoints handling.
         super().__init__(endpoint, credential, **kwargs)
 
@@ -597,16 +597,15 @@ def _validate_tools_and_tool_resources(
             )
 
     @distributed_trace_async
-    async def delete_agent(self, agent_id: str, **kwargs: Any) -> _models.AgentDeletionStatus:
+    async def delete_agent(self, agent_id: str, **kwargs: Any) -> None:
         """Deletes an agent.
 
         :param agent_id: Identifier of the agent. Required.
         :type agent_id: str
-        :return: AgentDeletionStatus. The AgentDeletionStatus is compatible with MutableMapping
-        :rtype: ~azure.ai.agents.models.AgentDeletionStatus
+        :rtype: None
         :raises ~azure.core.exceptions.HttpResponseError:
         """
-        return await super().delete_agent(agent_id, **kwargs)
+        await super()._delete_agent(agent_id, **kwargs)
 
     @distributed_trace
     def enable_auto_function_calls(  # pylint: disable=client-method-missing-kwargs