Agents v1 version (Azure#41051)

* initial v1 version

* moved servicepatterns under azure.ai.agents

Author: jhakulin

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

@@ -34,7 +34,6 @@ To report an issue with the client library, or request additional features, plea
     - [Function call](#create-agent-with-function-call)
     - [Azure Function Call](#create-agent-with-azure-function-call)
     - [OpenAPI](#create-agent-with-openapi)
-    - [Fabric data](#create-an-agent-with-fabric)
   - [Create thread](#create-thread) with
     - [Tool resource](#create-thread-with-tool-resource)
   - [Create message](#create-message) with:
@@ -664,34 +663,6 @@ with agents_client:
 
 <!-- END SNIPPET -->
 
-### Create an Agent with Fabric
-
-To enable your Agent to answer queries using Fabric data, use `FabricTool` along with a connection to the Fabric resource.
-
-Here is an example:
-
-<!-- SNIPPET:sample_agents_fabric.create_agent_with_fabric_tool -->
-
-```python
-conn_id = os.environ["FABRIC_CONNECTION_ID"]
-
-print(conn_id)
-
-# Initialize an Agent Fabric tool and add the connection id
-fabric = FabricTool(connection_id=conn_id)
-
-# Create an Agent with the Fabric tool and process an Agent run
-with agents_client:
-    agent = agents_client.create_agent(
-        model=os.environ["MODEL_DEPLOYMENT_NAME"],
-        name="my-agent",
-        instructions="You are a helpful agent",
-        tools=fabric.definitions,
-    )
-```
-
-<!-- END SNIPPET -->
-
 
 ### Create Thread
 

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

@@ -6,17 +6,16 @@
         "azure.ai.agents.models.AgentsResponseFormat": "Azure.AI.Agents.AgentsResponseFormat",
         "azure.ai.agents.models.AgentThread": "Azure.AI.Agents.AgentThread",
         "azure.ai.agents.models.AgentThreadCreationOptions": "Azure.AI.Agents.AgentThreadCreationOptions",
+        "azure.ai.agents.servicepatterns.models.AgentV1Error": "Azure.AI.Agents.ServicePatterns.AgentV1Error",
+        "azure.ai.agents.servicepatterns.models.AgentV1ErrorError": "Azure.AI.Agents.ServicePatterns.AgentV1Error.error.anonymous",
         "azure.ai.agents.models.AISearchIndexResource": "Azure.AI.Agents.AISearchIndexResource",
-        "azure.ai.agents.models.AzureAISearchResource": "Azure.AI.Agents.AzureAISearchResource",
         "azure.ai.agents.models.ToolDefinition": "Azure.AI.Agents.ToolDefinition",
         "azure.ai.agents.models.AzureAISearchToolDefinition": "Azure.AI.Agents.AzureAISearchToolDefinition",
+        "azure.ai.agents.models.AzureAISearchToolResource": "Azure.AI.Agents.AzureAISearchToolResource",
         "azure.ai.agents.models.AzureFunctionBinding": "Azure.AI.Agents.AzureFunctionBinding",
         "azure.ai.agents.models.AzureFunctionDefinition": "Azure.AI.Agents.AzureFunctionDefinition",
         "azure.ai.agents.models.AzureFunctionStorageQueue": "Azure.AI.Agents.AzureFunctionStorageQueue",
         "azure.ai.agents.models.AzureFunctionToolDefinition": "Azure.AI.Agents.AzureFunctionToolDefinition",
-        "azure.ai.agents.models.BingCustomSearchConfiguration": "Azure.AI.Agents.BingCustomSearchConfiguration",
-        "azure.ai.agents.models.BingCustomSearchConfigurationList": "Azure.AI.Agents.BingCustomSearchConfigurationList",
-        "azure.ai.agents.models.BingCustomSearchToolDefinition": "Azure.AI.Agents.BingCustomSearchToolDefinition",
         "azure.ai.agents.models.BingGroundingSearchConfiguration": "Azure.AI.Agents.BingGroundingSearchConfiguration",
         "azure.ai.agents.models.BingGroundingSearchConfigurationList": "Azure.AI.Agents.BingGroundingSearchConfigurationList",
         "azure.ai.agents.models.BingGroundingToolDefinition": "Azure.AI.Agents.BingGroundingToolDefinition",
@@ -69,7 +68,6 @@
         "azure.ai.agents.models.MessageTextFilePathDetails": "Azure.AI.Agents.MessageTextFilePathDetails",
         "azure.ai.agents.models.MessageTextUrlCitationAnnotation": "Azure.AI.Agents.MessageTextUrlCitationAnnotation",
         "azure.ai.agents.models.MessageTextUrlCitationDetails": "Azure.AI.Agents.MessageTextUrlCitationDetails",
-        "azure.ai.agents.models.MicrosoftFabricToolDefinition": "Azure.AI.Agents.MicrosoftFabricToolDefinition",
         "azure.ai.agents.models.OpenApiAuthDetails": "Azure.AI.Agents.OpenApiAuthDetails",
         "azure.ai.agents.models.OpenApiAnonymousAuthDetails": "Azure.AI.Agents.OpenApiAnonymousAuthDetails",
         "azure.ai.agents.models.OpenApiConnectionAuthDetails": "Azure.AI.Agents.OpenApiConnectionAuthDetails",
@@ -89,7 +87,6 @@
         "azure.ai.agents.models.RunStep": "Azure.AI.Agents.RunStep",
         "azure.ai.agents.models.RunStepToolCall": "Azure.AI.Agents.RunStepToolCall",
         "azure.ai.agents.models.RunStepAzureAISearchToolCall": "Azure.AI.Agents.RunStepAzureAISearchToolCall",
-        "azure.ai.agents.models.RunStepBingCustomSearchToolCall": "Azure.AI.Agents.RunStepBingCustomSearchToolCall",
         "azure.ai.agents.models.RunStepBingGroundingToolCall": "Azure.AI.Agents.RunStepBingGroundingToolCall",
         "azure.ai.agents.models.RunStepCodeInterpreterToolCallOutput": "Azure.AI.Agents.RunStepCodeInterpreterToolCallOutput",
         "azure.ai.agents.models.RunStepCodeInterpreterImageOutput": "Azure.AI.Agents.RunStepCodeInterpreterImageOutput",
@@ -123,24 +120,16 @@
         "azure.ai.agents.models.RunStepFunctionToolCallDetails": "Azure.AI.Agents.RunStepFunctionToolCallDetails",
         "azure.ai.agents.models.RunStepMessageCreationDetails": "Azure.AI.Agents.RunStepMessageCreationDetails",
         "azure.ai.agents.models.RunStepMessageCreationReference": "Azure.AI.Agents.RunStepMessageCreationReference",
-        "azure.ai.agents.models.RunStepMicrosoftFabricToolCall": "Azure.AI.Agents.RunStepMicrosoftFabricToolCall",
         "azure.ai.agents.models.RunStepOpenAPIToolCall": "Azure.AI.Agents.RunStepOpenAPIToolCall",
-        "azure.ai.agents.models.RunStepSharepointToolCall": "Azure.AI.Agents.RunStepSharepointToolCall",
         "azure.ai.agents.models.RunStepToolCallDetails": "Azure.AI.Agents.RunStepToolCallDetails",
-        "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.ThreadMessage": "Azure.AI.Agents.ThreadMessage",
         "azure.ai.agents.models.ThreadMessageOptions": "Azure.AI.Agents.ThreadMessageOptions",
         "azure.ai.agents.models.ThreadRun": "Azure.AI.Agents.ThreadRun",
-        "azure.ai.agents.models.ToolConnection": "Azure.AI.Agents.ToolConnection",
-        "azure.ai.agents.models.ToolConnectionList": "Azure.AI.Agents.ToolConnectionList",
         "azure.ai.agents.models.ToolOutput": "Azure.AI.Agents.ToolOutput",
         "azure.ai.agents.models.ToolResources": "Azure.AI.Agents.ToolResources",
         "azure.ai.agents.models.TruncationObject": "Azure.AI.Agents.TruncationObject",
-        "azure.ai.agents.models.UpdateCodeInterpreterToolResourceOptions": "Azure.AI.Agents.UpdateCodeInterpreterToolResourceOptions",
-        "azure.ai.agents.models.UpdateFileSearchToolResourceOptions": "Azure.AI.Agents.UpdateFileSearchToolResourceOptions",
-        "azure.ai.agents.models.UpdateToolResourcesOptions": "Azure.AI.Agents.UpdateToolResourcesOptions",
         "azure.ai.agents.models.VectorStore": "Azure.AI.Agents.VectorStore",
         "azure.ai.agents.models.VectorStoreChunkingStrategyRequest": "Azure.AI.Agents.VectorStoreChunkingStrategyRequest",
         "azure.ai.agents.models.VectorStoreAutoChunkingStrategyRequest": "Azure.AI.Agents.VectorStoreAutoChunkingStrategyRequest",

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_5d6ca21785"
+  "Tag": "python/ai/azure-ai-agents_dab4ae41b1"
 }

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

@@ -27,6 +27,7 @@
     VectorStoreFilesOperations,
     VectorStoresOperations,
 )
+from .servicepatterns.operations import ServicePatternsOperations
 
 if TYPE_CHECKING:
     from azure.core.credentials import TokenCredential
@@ -35,6 +36,8 @@
 class AgentsClient(AgentsClientOperationsMixin):  # pylint: disable=too-many-instance-attributes
     """AgentsClient.
 
+    :ivar service_patterns: ServicePatternsOperations operations
+    :vartype service_patterns: azure.ai.agents.operations.ServicePatternsOperations
     :ivar threads: ThreadsOperations operations
     :vartype threads: azure.ai.agents.operations.ThreadsOperations
     :ivar messages: MessagesOperations operations
@@ -56,9 +59,8 @@ 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
-     "2025-05-15-preview". 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 "v1". Note
+     that overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 
@@ -88,6 +90,9 @@ def __init__(self, endpoint: str, credential: "TokenCredential", **kwargs: Any)
         self._serialize = Serializer()
         self._deserialize = Deserializer()
         self._serialize.client_side_validation = False
+        self.service_patterns = ServicePatternsOperations(
+            self._client, self._config, self._serialize, self._deserialize
+        )
         self.threads = ThreadsOperations(self._client, self._config, self._serialize, self._deserialize)
         self.messages = MessagesOperations(self._client, self._config, self._serialize, self._deserialize)
         self.runs = RunsOperations(self._client, self._config, self._serialize, self._deserialize)

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

@@ -27,14 +27,13 @@ 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
-     "2025-05-15-preview". 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 "v1". 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", "2025-05-15-preview")
+        api_version: str = kwargs.pop("api_version", "v1")
 
         if endpoint is None:
             raise ValueError("Parameter 'endpoint' must not be None.")

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

@@ -649,7 +649,7 @@ def create_thread_and_run(
         model: Optional[str] = None,
         instructions: Optional[str] = None,
         tools: Optional[List[_models.ToolDefinition]] = None,
-        tool_resources: Optional[_models.UpdateToolResourcesOptions] = None,
+        tool_resources: Optional[_models.ToolResources] = None,
         temperature: Optional[float] = None,
         top_p: Optional[float] = None,
         max_prompt_tokens: Optional[int] = None,
@@ -678,7 +678,7 @@ def create_thread_and_run(
         :keyword tools: Override the list of enabled tools for this run.
         :type tools: list[~azure.ai.agents.models.ToolDefinition]
         :keyword tool_resources: Override the tools the agent can use for this run.
-        :type tool_resources: ~azure.ai.agents.models.UpdateToolResourcesOptions
+        :type tool_resources: ~azure.ai.agents.models.ToolResources
         :keyword temperature: Sampling temperature between 0 and 2. Higher = more random.
         :type temperature: float
         :keyword top_p: Nucleus sampling parameter between 0 and 1.
@@ -749,7 +749,7 @@ def create_thread_and_run(  # type: ignore
         model: Optional[str] = None,
         instructions: Optional[str] = None,
         tools: Optional[List[_models.ToolDefinition]] = None,
-        tool_resources: Optional[_models.UpdateToolResourcesOptions] = None,
+        tool_resources: Optional[_models.ToolResources] = None,
         temperature: Optional[float] = None,
         top_p: Optional[float] = None,
         max_prompt_tokens: Optional[int] = None,
@@ -780,7 +780,7 @@ def create_thread_and_run(  # type: ignore
         :keyword tools: Override the list of enabled tools for this run.
         :type tools: list[~azure.ai.agents.models.ToolDefinition]
         :keyword tool_resources: Override the tools the agent can use for this run.
-        :type tool_resources: ~azure.ai.agents.models.UpdateToolResourcesOptions
+        :type tool_resources: ~azure.ai.agents.models.ToolResources
         :keyword temperature: Sampling temperature between 0 and 2. Higher = more random.
         :type temperature: float
         :keyword top_p: Nucleus sampling parameter between 0 and 1.

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

@@ -15,6 +15,7 @@
 from azure.core.rest import AsyncHttpResponse, HttpRequest
 
 from .._utils.serialization import Deserializer, Serializer
+from ..servicepatterns.aio.operations import ServicePatternsOperations
 from ._configuration import AgentsClientConfiguration
 from .operations import (
     AgentsClientOperationsMixin,
@@ -35,6 +36,8 @@
 class AgentsClient(AgentsClientOperationsMixin):  # pylint: disable=too-many-instance-attributes
     """AgentsClient.
 
+    :ivar service_patterns: ServicePatternsOperations operations
+    :vartype service_patterns: azure.ai.agents.aio.operations.ServicePatternsOperations
     :ivar threads: ThreadsOperations operations
     :vartype threads: azure.ai.agents.aio.operations.ThreadsOperations
     :ivar messages: MessagesOperations operations
@@ -57,9 +60,8 @@ 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
-     "2025-05-15-preview". 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 "v1". Note
+     that overriding this default value may result in unsupported behavior.
     :paramtype api_version: str
     """
 
@@ -89,6 +91,9 @@ def __init__(self, endpoint: str, credential: "AsyncTokenCredential", **kwargs:
         self._serialize = Serializer()
         self._deserialize = Deserializer()
         self._serialize.client_side_validation = False
+        self.service_patterns = ServicePatternsOperations(
+            self._client, self._config, self._serialize, self._deserialize
+        )
         self.threads = ThreadsOperations(self._client, self._config, self._serialize, self._deserialize)
         self.messages = MessagesOperations(self._client, self._config, self._serialize, self._deserialize)
         self.runs = RunsOperations(self._client, self._config, self._serialize, self._deserialize)

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

@@ -27,14 +27,13 @@ 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
-     "2025-05-15-preview". 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 "v1". 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", "2025-05-15-preview")
+        api_version: str = kwargs.pop("api_version", "v1")
 
         if endpoint is None:
             raise ValueError("Parameter 'endpoint' must not be None.")

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

@@ -649,7 +649,7 @@ async def create_thread_and_run(
         model: Optional[str] = None,
         instructions: Optional[str] = None,
         tools: Optional[List[_models.ToolDefinition]] = None,
-        tool_resources: Optional[_models.UpdateToolResourcesOptions] = None,
+        tool_resources: Optional[_models.ToolResources] = None,
         temperature: Optional[float] = None,
         top_p: Optional[float] = None,
         max_prompt_tokens: Optional[int] = None,
@@ -678,7 +678,7 @@ async def create_thread_and_run(
         :keyword tools: Override the list of enabled tools for this run.
         :type tools: list[~azure.ai.agents.models.ToolDefinition]
         :keyword tool_resources: Override the tools the agent can use for this run.
-        :type tool_resources: ~azure.ai.agents.models.UpdateToolResourcesOptions
+        :type tool_resources: ~azure.ai.agents.models.ToolResources
         :keyword temperature: Sampling temperature between 0 and 2. Higher = more random.
         :type temperature: float
         :keyword top_p: Nucleus sampling parameter between 0 and 1.
@@ -749,7 +749,7 @@ async def create_thread_and_run(  # type: ignore
         model: Optional[str] = None,
         instructions: Optional[str] = None,
         tools: Optional[List[_models.ToolDefinition]] = None,
-        tool_resources: Optional[_models.UpdateToolResourcesOptions] = None,
+        tool_resources: Optional[_models.ToolResources] = None,
         temperature: Optional[float] = None,
         top_p: Optional[float] = None,
         max_prompt_tokens: Optional[int] = None,
@@ -780,7 +780,7 @@ async def create_thread_and_run(  # type: ignore
         :keyword tools: Override the list of enabled tools for this run.
         :type tools: list[~azure.ai.agents.models.ToolDefinition]
         :keyword tool_resources: Override the tools the agent can use for this run.
-        :type tool_resources: ~azure.ai.agents.models.UpdateToolResourcesOptions
+        :type tool_resources: ~azure.ai.agents.models.ToolResources
         :keyword temperature: Sampling temperature between 0 and 2. Higher = more random.
         :type temperature: float
         :keyword top_p: Nucleus sampling parameter between 0 and 1.