Merge feature/azure-ai-projects/vnext into Main. Do not complete this PR!

sdk/ai/azure-ai-projects/.env.template

@@ -46,9 +46,14 @@ SHAREPOINT_USER_INPUT=
 FABRIC_USER_INPUT=
 BING_CUSTOM_USER_INPUT=
 A2A_USER_INPUT=
+A2A_ENDPOINT=
 EVALUATOR_NAME=
 DATASET_NAME=
 DATASET_VERSION=
+DATASET_VERSION_1=
+DATASET_VERSION_2=
+DATA_FOLDER=
+DOWNLOAD_FOLDER=
 POLL_INTERVAL_SECONDS=
 EVAL_MODEL=
 OPTIMIZATION_MODEL=
@@ -57,6 +62,44 @@ WORK_IQ_PROJECT_CONNECTION_ID=
 WORK_IQ_USER_INPUT=
 FABRIC_IQ_PROJECT_CONNECTION_ID=
 FABRIC_IQ_USER_INPUT=
+AI_SEARCH_CONNECTION_NAME=
+INDEX_NAME=
+INDEX_VERSION=
+FILE_PATH=
+AGENT_ID=
+APPINSIGHTS_RESOURCE_ID=
+TRACE_LOOKBACK_HOURS=
+FOUNDRY_AGENT_VERSION=
+FOUNDRY_CONVERSATION_IDS=
+FOUNDRY_TRACE_IDS=
+FOUNDRY_INSTANT_MODEL_NAME=
+FOUNDRY_REFERENCE_DATASET_NAME=
+FOUNDRY_REFERENCE_DATASET_VERSION=
+FOUNDRY_TRACES_WINDOW_DAYS=
+AZURE_AI_PROJECT_ENDPOINT=
+AZURE_AI_MODEL_DEPLOYMENT_NAME=
+AZURE_AI_MODEL_DEPLOYMENT_NAME_FOR_AUDIO=
+ENDPOINT_URL=
+ENDPOINT_API_KEY=
+ENDPOINT_APP_ID=
+AZURE_RESOURCE_GROUP_NAME=
+MODEL_PUBLISHER=
+MODEL_VERSION=
+MODEL_ENDPOINT=
+MODEL_API_KEY=
+COMPUTER_USE_MODEL_DEPLOYMENT_NAME=
+STORAGE_INPUT_QUEUE_NAME=
+STORAGE_OUTPUT_QUEUE_NAME=
+STORAGE_QUEUE_SERVICE_ENDPOINT=
+DELEGATED_USER_IDENTITY=
+DELEGATED_USER_IDENTITY_2=
+FOUNDRY_HOSTED_AGENT_REMOTE_BUILD=
+GITHUB_CONNECTION_NAME=
+GITHUB_PAT_TOKEN=
+GITHUB_REPOSITORY_NAME=
+GITHUB_USERNAME=
+TEAMS_CONNECTION_NAME=
+TEAMS_CHANNEL_URL=
 
 #######################################################################
 #

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

@@ -1,5 +1,23 @@
 # Release History
 
+## 2.5.0 (Unreleased)
+
+### Features Added
+
+Placeholder
+
+### Breaking Changes
+
+Placeholder
+
+### Bugs Fixed
+
+Placeholder
+
+### Sample updates
+
+Placeholder
+
 ## 2.4.0 (2026-07-24)
 
 ### Features Added

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

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

sdk/ai/azure-ai-projects/docs/tool-classes-removed-properties.md

@@ -0,0 +1,43 @@
+# Tool Classes: Removed Properties (v2.2.0 → v2.3.0)
+
+The following Tool-derived classes had properties **removed** in v2.3.0 compared to v2.2.0. These properties (`name`, `description`, `tool_configs`) now only exist on the corresponding `ToolboxTool` subclasses.
+
+## General Availability Tools
+
+| Class Name | Removed Properties |
+|------------|-------------------|
+| `AzureAISearchTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `AzureFunctionTool` | `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `BingGroundingTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `CaptureStructuredOutputsTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `CodeInterpreterTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `FileSearchTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `FunctionShellToolParam` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `FunctionTool` | *(no changes)* |
+| `ImageGenTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `LocalShellToolParam` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `MCPTool` | `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `OpenApiTool` | `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `WebSearchTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+v
+## Preview Tools
+
+| Class Name | Removed Properties |
+|------------|-------------------|
+| `A2APreviewTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `BingCustomSearchPreviewTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `BrowserAutomationPreviewTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `ComputerUsePreviewTool` | *(no changes)* |
+| `FabricIQPreviewTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `MemorySearchPreviewTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `MicrosoftFabricPreviewTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `SharepointPreviewTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `ToolboxSearchPreviewTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+| `WebSearchPreviewTool` | *(no changes)* |
+| `WorkIQPreviewTool` | `name: Optional[str]`, `description: Optional[str]`, `tool_configs: Optional[dict[str, ToolConfig]]` |
+
+## Summary
+
+- **Total Tool classes analyzed:** 24
+- **Classes with removed properties:** 19
+- **Common pattern:** `name`, `description`, and `tool_configs` were moved exclusively to `ToolboxTool` subclasses

sdk/ai/azure-ai-projects/samples/agents/sample_agent_basic.py

@@ -45,7 +45,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 with (
     DefaultAzureCredential() as credential,

sdk/ai/azure-ai-projects/samples/agents/sample_agent_retrieve_basic.py

@@ -40,7 +40,7 @@
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
 model = os.environ["FOUNDRY_MODEL_NAME"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 with (
     DefaultAzureCredential() as credential,
     AIProjectClient(endpoint=endpoint, credential=credential) as project_client,

sdk/ai/azure-ai-projects/samples/agents/sample_agent_retrieve_basic_async.py

@@ -47,7 +47,7 @@
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
 model = os.environ["FOUNDRY_MODEL_NAME"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 
 async def main():

sdk/ai/azure-ai-projects/samples/agents/sample_agent_stream_events.py

@@ -38,7 +38,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 with (
     DefaultAzureCredential() as credential,

sdk/ai/azure-ai-projects/samples/agents/sample_agent_structured_output.py

@@ -54,7 +54,7 @@ class CalendarEvent(BaseModel):
 
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 with (
     DefaultAzureCredential() as credential,

sdk/ai/azure-ai-projects/samples/agents/telemetry/sample_agent_basic_with_azure_monitor_tracing.py

@@ -43,7 +43,7 @@
 load_dotenv()
 
 agent = None
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 with (
     DefaultAzureCredential() as credential,

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_ai_search.py

@@ -44,7 +44,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 
 tool = AzureAISearchTool(

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_azure_function.py

@@ -47,7 +47,7 @@
 agent = None
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 
 tool = AzureFunctionTool(

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_bing_custom_search.py

@@ -53,7 +53,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 
 tool = BingCustomSearchPreviewTool(

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_bing_grounding.py

@@ -58,7 +58,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 
 tool = BingGroundingTool(

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_browser_automation.py

@@ -42,7 +42,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 
 tool = BrowserAutomationPreviewTool(

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_code_interpreter.py

@@ -34,7 +34,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 with (
     DefaultAzureCredential() as credential,

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_code_interpreter_async.py

@@ -35,7 +35,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 
 async def main() -> None:

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_code_interpreter_with_files_async.py

@@ -58,7 +58,7 @@ async def main() -> None:
 
             # Create agent with code interpreter tool
             agent = await project_client.agents.create_version(
-                agent_name=os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent"),
+                agent_name=os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent",
                 definition=PromptAgentDefinition(
                     model=os.environ["FOUNDRY_MODEL_NAME"],
                     instructions="You are a helpful assistant.",

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_computer_use.py

@@ -48,7 +48,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 # Initialize state machine
 current_state = SearchState.INITIAL

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_computer_use_async.py

@@ -48,7 +48,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 
 async def main():

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_fabric.py

@@ -42,7 +42,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 tool = MicrosoftFabricPreviewTool(
     fabric_dataagent_preview=FabricDataAgentToolParameters(

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_fabric_iq.py

@@ -36,7 +36,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 tool_payload = FabricIQPreviewTool(
     project_connection_id=os.environ["FABRIC_IQ_PROJECT_CONNECTION_ID"],

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_file_search_structured_inputs.py

@@ -84,7 +84,7 @@
 
     # Create agent with file search tool
     agent = project_client.agents.create_version(
-        agent_name=os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent"),
+        agent_name=os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent",
         definition=agent_definition,
         description="File search agent for product information queries.",
     )

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_function_tool.py

@@ -36,7 +36,7 @@
 
 load_dotenv()
 
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 
 def get_horoscope(sign: str) -> str:

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_image_generation.py

@@ -57,7 +57,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 image_generation_model = os.environ["IMAGE_GENERATION_MODEL_DEPLOYMENT_NAME"]
 
 tool = ImageGenTool(

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_image_generation_async.py

@@ -57,7 +57,7 @@
 
 load_dotenv()
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 image_generation_model = os.environ["IMAGE_GENERATION_MODEL_DEPLOYMENT_NAME"]
 
 

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_mcp.py

@@ -35,7 +35,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 mcp_tool = MCPTool(
     server_label="api-specs",

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_mcp_async.py

@@ -36,7 +36,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 
 async def main():

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_mcp_with_project_connection.py

@@ -37,7 +37,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 
 tool = MCPTool(

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_memory_search.py

@@ -50,7 +50,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-AGENT_NAME = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+AGENT_NAME = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 credential = DefaultAzureCredential()
 project_client = AIProjectClient(endpoint=endpoint, credential=credential)

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_memory_search_async.py

@@ -49,7 +49,7 @@
 
 load_dotenv()
 
-AGENT_NAME = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+AGENT_NAME = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 
 
 async def main() -> None:

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_openapi.py

@@ -42,7 +42,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 weather_asset_file_path = Path(__file__).resolve().parent / "../assets/weather_openapi.json"
 openapi_weather = cast(dict[str, Any], jsonref.loads(weather_asset_file_path.read_text(encoding="utf-8")))
 

sdk/ai/azure-ai-projects/samples/agents/tools/sample_agent_openapi_with_project_connection.py

@@ -46,7 +46,7 @@
 load_dotenv()
 
 endpoint = os.environ["FOUNDRY_PROJECT_ENDPOINT"]
-agent_name = os.environ.get("FOUNDRY_AGENT_NAME", "MyAgent")
+agent_name = os.environ.get("FOUNDRY_AGENT_NAME") or "MyAgent"
 tripadvisor_asset_file_path = Path(__file__).resolve().parent / "../assets/tripadvisor_openapi.json"
 openapi_tripadvisor = cast(dict[str, Any], jsonref.loads(tripadvisor_asset_file_path.read_text(encoding="utf-8")))