Feature/azure ai agents/1.1.0b1 (#41234)

* Update CHANGELOG.md

* Update _version.py

* Update CHANGELOG.md

* adding instrumentation for create_thread_and_run (#41224)

* adding instrumentation for create_thread_and_run

* updating changelog

* removing empty sections from changelog since those prevent green build

* prepare for 1.1.0b1 (#41203)

* h -f
prepare for 1.1.0b1

* comment out async tests

* Add convenience code for preview tools and Fabric sample

* add sharepoint sample

* add bing custom search sample

* update README with fabric sample

* run black

* Rebase, update readme, changelog, comments out test

* resolve ci

* fix CI

* update changelog

* Fix spelling

---------

Co-authored-by: Glenn Harper <[email protected]>

* Record async tests (#41235)

* Update CHANGELOG.md

---------

Co-authored-by: M-Hietala <[email protected]>
Co-authored-by: Glenn Harper <[email protected]>
Co-authored-by: Glenn Harper <[email protected]>

Author: 3 people

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

@@ -1,5 +1,18 @@
+
+
 # Release History
 
+## 1.1.0b1 (2025-05-20)
+
+### Features Added
+
+- API version is changed to 2025-05-15-preview.
+- Add FabricTool, SharepointTool, and BingCustomSearchTool classes along with samples.
+
+### Bugs Fixed
+
+- Adding instrumentation for create_thread_and_run
+
 ## 1.0.0 (2025-05-15)
 
 ### Features Added

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

@@ -36,6 +36,7 @@ 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:
@@ -666,6 +667,35 @@ 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
 
 For each session or conversation, a thread is required.   Here is an example:

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

@@ -16,13 +16,17 @@
         "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.BingCustomSearchToolDefinition": "Azure.AI.Agents.BingCustomSearchToolDefinition",
+        "azure.ai.agents.models.BingCustomSearchToolParameters": "Azure.AI.Agents.BingCustomSearchToolParameters",
         "azure.ai.agents.models.BingGroundingSearchConfiguration": "Azure.AI.Agents.BingGroundingSearchConfiguration",
         "azure.ai.agents.models.BingGroundingSearchToolParameters": "Azure.AI.Agents.BingGroundingSearchToolParameters",
         "azure.ai.agents.models.BingGroundingToolDefinition": "Azure.AI.Agents.BingGroundingToolDefinition",
         "azure.ai.agents.models.CodeInterpreterToolDefinition": "Azure.AI.Agents.CodeInterpreterToolDefinition",
         "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.FabricDataAgentToolParameters": "Azure.AI.Agents.FabricDataAgentToolParameters",
         "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",
@@ -68,6 +72,7 @@
         "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",
@@ -87,6 +92,7 @@
         "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",
@@ -120,13 +126,18 @@
         "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.SharepointGroundingToolParameters": "Azure.AI.Agents.SharepointGroundingToolParameters",
+        "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.ToolOutput": "Azure.AI.Agents.ToolOutput",
         "azure.ai.agents.models.ToolResources": "Azure.AI.Agents.ToolResources",
         "azure.ai.agents.models.TruncationObject": "Azure.AI.Agents.TruncationObject",

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_c924b708a0"
 }

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/_version.py

@@ -6,4 +6,4 @@
 # Changes may cause incorrect behavior and will be lost if the code is regenerated.
 # --------------------------------------------------------------------------
 
-VERSION = "1.0.0"
+VERSION = "1.1.0b1"

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/operations/_patch.py

@@ -1362,7 +1362,7 @@ async def upload(
         :paramtype file: Optional[FileType]
         :keyword file_path: Path to the file. Required if `body` and `purpose` are not provided.
         :paramtype file_path: Optional[str]
-        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision". 
+        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision".
             Required if `body` and `file` are not provided.
         :paramtype purpose: Union[str, _models.FilePurpose, None]
         :keyword filename: The name of the file.
@@ -1502,7 +1502,7 @@ async def upload_and_poll(
         :paramtype file: Optional[FileType]
         :keyword file_path: Path to the file. Required if `body` and `purpose` are not provided.
         :paramtype file_path: Optional[str]
-        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision". 
+        :keyword purpose: Known values are: "assistants", "assistants_output", and "vision".
             Required if `body` and `file` are not provided.
         :paramtype purpose: Union[str, _models.FilePurpose, None]
         :keyword filename: The name of the file.