Python: Fix for AzureAIAgent streaming func call invocations. Other fixes/improvements for tool call content types, and logging.

[moonbox3]

Motivation and Context

The AzureAIAgent streaming function call invocation is broken when handling more than one required function call from the service. There is nested logic to handle passing the tool calls back to the service because it requires one to pass in a handler.

In this PR, we're now controlling everything from the main loop and are passing back the handler as the event stream for further processing. This does require some logic to determine if we have an initial async context manager (based on the first call to create the run stream) or if we're now using the handler from submitting tool calls. We can now see that when we have multiple functions involved, we are able to get the results as we expect:

Sample Output:

# User: 'What is the price of the special drink and then special food item added together?'
Function Call:> MenuPlugin-get_specials with arguments: {}
Function Result:> 
        Special Soup: Clam Chowder
        Special Salad: Cobb Salad
        Special Drink: Chai Tea
        for function: MenuPlugin-get_specials
Function Call:> MenuPlugin-get_item_price with arguments: {"menu_item": "Chai Tea"}
Function Call:> MenuPlugin-get_item_price with arguments: {"menu_item": "Clam Chowder"}
Function Result:> $9.99 for function: MenuPlugin-get_item_price
Function Result:> $9.99 for function: MenuPlugin-get_item_price
Function Call:> MathPlugin-Add with arguments: {"input":9.99,"amount":9.99}
Function Result:> 19.98 for function: MathPlugin-Add
# AuthorRole.ASSISTANT: The price of the special drink, Chai Tea, is $9.99 and the price of the special food 
    item, Clam Chowder, is $9.99. Added together, the total price is $19.98.

Description

Fix handling multiple function calls for the streaming AzureAIAgent.

• Fixes a missing quote from the url citation for streaming annotation content
• Shows the correct way to retrieve Bing Grounding tool calls in the two concept samples.
• Adds handling for tool content content for OpenAPI plugins.
• Adds logging for streaming agent invocation tool calls.
• Relaxes the handling of the FunctionResultContent id attribute to be str | None similar to that of FunctionCallContent. The type hints for id have always been str | None, but the actual type hint on the attribute has been str. We don't always get a FunctionResultContent id from the Azure Agent Service during streaming invocations - message addition via the overide __add__ method still work properly.
• Move the AzureAIAgent pkg dependencies to be installed by default, instead of requiring the azure extra.
• Closes Python: AzureAIAgent - Log additional Agent tool calls #12312
• Closes Python: AzureAIAgent invoke_stream not running all tools #12328
• Closes Python: Add Bing search query URL to StreamingAnnotationContent #12331
• Closes Python: Bug: Python - AzureAIAgent - BingGrounding - Streaming - Annotation missing quote/text. #12324

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 😄

[markwallace-microsoft]

Python Test Coverage Report •

File	Stmts	Miss	Cover	Missing
agents/azure_ai
agent_content_generation.py	271	102	62%	74–75, 77, 95, 97, 219, 222, 262, 287–288, 296, 304, 306, 314, 321, 329, 331, 339, 346, 352–354, 356, 358–360, 369–371, 380, 420, 459–460, 462–465, 467–469, 472–473, 475, 485–486, 488, 501–502, 504, 506–510, 519, 527, 540–541, 543, 545–552, 561, 570, 584–585, 587, 589–591, 593–597, 607–609, 618–619, 621, 647–654, 660–663, 668, 673–674, 681
agent_thread_actions.py	366	144	60%	154, 156, 193–196, 288–289, 293, 296, 299–300, 304, 307, 310–311, 315, 318, 321–322, 326–327, 427, 429, 469–470, 492, 494–496, 498–500, 502–503, 505–510, 512–520, 524–525, 528–532, 535–536, 539–540, 543, 546, 549–553, 555–556, 560–561, 568–569, 574, 578–579, 581–582, 589, 591, 595, 597–598, 602–611, 613–615, 618, 668, 671, 702, 704, 711, 713–716, 718, 720, 722–723, 783, 788–793, 821–824, 828, 833–834, 838, 855–857, 861–862, 877–878, 916, 957–960, 962–963, 967, 971–972, 977
agents/open_ai
assistant_thread_actions.py	338	56	83%	107, 110, 116, 195, 197, 236–242, 416, 474, 500, 599–600, 602–603, 609–610, 612–613, 615–618, 620–621, 623–624, 626–627, 641–645, 648–650, 697, 699–700, 704–708, 710–711, 725–726, 797, 802, 834
responses_agent_thread_actions.py	341	107	68%	167, 184, 195, 206–207, 374–376, 390, 395, 402, 420–421, 425, 469–471, 474, 492–493, 502–504, 508, 512–513, 517–519, 530–532, 554, 556–557, 564–565, 567–568, 570, 572–573, 575–576, 659–661, 673–674, 676–680, 682–688, 690–699, 701–702, 704–707, 714–716, 721, 723, 784–787, 828–829, 833–835, 837, 862–863, 865–869, 871, 881–882, 890, 894, 901, 907, 971
connectors/ai/azure_ai_inference/services
utils.py	42	1	97%	53
contents
function_result_content.py	92	0	100%
core_plugins
math_plugin.py	20	0	100%
TOTAL	27073	4625	82%

Python Unit Test Overview

Tests	Skipped	Failures	Errors	Time
3616	18 💤	0 ❌	0 🔥	1m 52s ⏱️