Python: Add AzureAIAgent Deep Research Tool support

[moonbox3]

Motivation and Context

The deep research tool was introduced for the AzureAIAgent; however, we didn't have support yet in SK. Adding support now for using the deep research tool for both streaming and non-streaming. Samples added as well.

Description

• Add support for deep research tool.
• Add samples with notes on prerequisites to configure the sample to run properly.
• Added support for AZURE_AI_AGENT_DEEP_RESEARCH_MODEL env var within AzureAIAgentSettings class.
• Bumped min allowed azure-ai-agents package ver to 1.2.0b3.
• Closes Python: New Feature: AI Foundry Deep Research Tool usage in Semantic Kernel #12978

Contribution Checklist

• The code builds clean without any errors or warnings
• The PR follows the SK Contribution Guidelines and the pre-submission formatting script raises no violations
• All unit tests pass, and I have added new tests where possible
• I didn't break anyone 😄

[moonbox3]

Python Test Coverage Report •

File	Stmts	Miss	Cover	Missing
agents/azure_ai
agent_content_generation.py	361	166	54%	82–83, 85, 103, 105, 234, 237, 277, 311, 329, 332–334, 343–345, 353, 361, 363, 371, 378, 397, 399, 401, 412–414, 424–427, 429, 434–441, 447–449, 451, 453–455, 464–466, 475, 515, 554–555, 557–560, 563–566, 568, 570–571, 573–574, 576, 586–587, 589, 602–603, 605, 607–613, 623–625, 634, 655–656, 658, 660–665, 674–676, 684, 701–702, 704, 706–713, 722, 731, 745–746, 748, 750–752, 754–758, 768–770, 779–780, 782, 808–815, 821–824, 829, 834–835, 842, 934, 940, 959–961, 971, 991–994, 1005, 1030–1031, 1033, 1035–1040, 1045, 1047
agent_thread_actions.py	433	209	51%	167, 169, 206–212, 248–249, 252–256, 258–260, 264, 267–269, 278, 283–284, 346, 350, 355, 358, 361–362, 366, 369, 372–373, 377, 380, 383–384, 388–389, 393–394, 398–399, 403–404, 408, 411, 511, 513, 553–554, 577, 579–581, 583–585, 587, 589–591, 593–594, 596–601, 603–611, 615–616, 619–622, 626, 629–630, 633–634, 637, 640, 643–644, 647–648, 651–657, 659–660, 664, 667–668, 675–676, 681, 685–688, 690–691, 698, 700, 704, 707–712, 714–716, 721–722, 725–728, 731–733, 743–744, 751, 753, 757, 759–760, 764–773, 775–783, 834, 837, 871–872, 879–883, 943, 948–953, 981–984, 988, 993–994, 998, 1015–1017, 1021–1022, 1037–1038, 1076, 1117–1120, 1122–1123, 1127, 1131–1132, 1137
azure_ai_agent_settings.py	14	0	100%
TOTAL	27111	4727	82%

Python Unit Test Overview

Tests	Skipped	Failures	Errors	Time
3715	22 💤	0 ❌	0 🔥	1m 37s ⏱️

[Copilot]

Pull Request Overview

This PR adds support for the Azure AI Agent Deep Research Tool to the Semantic Kernel Python implementation. The Deep Research Tool enables agents to perform comprehensive research using advanced AI capabilities and Bing search integration.

• Implements support for both streaming and non-streaming Deep Research tool operations
• Adds necessary content generation functions for processing Deep Research tool calls and results
• Includes comprehensive sample applications demonstrating proper usage and configuration

Reviewed Changes

Copilot reviewed 6 out of 7 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
python/semantic_kernel/agents/azure_ai/azure_ai_agent_settings.py	Adds deep_research_model configuration field to agent settings
python/semantic_kernel/agents/azure_ai/agent_thread_actions.py	Integrates Deep Research tool support into agent execution flow for both streaming and non-streaming modes
python/semantic_kernel/agents/azure_ai/agent_content_generation.py	Implements content generation functions for Deep Research tool calls and responses
python/samples/getting_started_with_agents/azure_ai_agent/step10_azure_ai_agent_deep_research.py	Provides non-streaming Deep Research sample with detailed documentation
python/samples/concepts/agents/azure_ai_agent/azure_ai_agent_deep_research_streaming.py	Demonstrates streaming Deep Research functionality
python/pyproject.toml	Updates azure-ai-agents dependency to support Deep Research features

---

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}