update tool call output trace format (#44002)

* update tool call output format

* updating changelog

Author: M-Hietala

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

@@ -7,6 +7,7 @@
 ### Breaking changes
 
 * `get_openai_client()` method on the asynchronous AIProjectClient is no longer an "async" method.
+* tracing: tool call output event content format updated to be in line with other events
 
 ### Bugs Fixed
 

sdk/ai/azure-ai-projects/azure/ai/projects/telemetry/_responses_instrumentor.py

@@ -527,7 +527,7 @@ def _add_tool_message_events(
         event_body: Dict[str, Any] = {}
 
         if _trace_responses_content and tool_outputs:
-            tool_call_outputs = []
+            content_items = []
             for output_item in tool_outputs:
                 try:
                     tool_output: Dict[str, Any] = {}
@@ -573,14 +573,15 @@ def _add_tool_message_events(
                         else:
                             tool_output["output"] = output_value
 
-                    tool_call_outputs.append(tool_output)
+                    # Use standard content format: {"type": "tool_call_output", "tool_call_output": {...}}
+                    content_items.append({"type": "tool_call_output", "tool_call_output": tool_output})
                 except Exception:  # pylint: disable=broad-exception-caught
                     # Skip items that can't be processed
                     logger.debug("Failed to process tool output item: %s", output_item, exc_info=True)
                     continue
 
-            if tool_call_outputs:
-                event_body["tool_call_outputs"] = tool_call_outputs
+            if content_items:
+                event_body["content"] = content_items
 
         attributes = self._create_event_attributes(
             conversation_id=conversation_id,
@@ -2925,7 +2926,7 @@ def _add_conversation_item_event(  # pylint: disable=too-many-branches,too-many-
 
         # Handle different item types
         if item_type == "function_call_output":
-            # Function tool output - use tool_call_outputs format
+            # Function tool output - use standard content format
             role = "tool"  # Override role for tool outputs
             if _trace_responses_content:
                 tool_output: Dict[str, Any] = {
@@ -2949,7 +2950,8 @@ def _add_conversation_item_event(  # pylint: disable=too-many-branches,too-many-
                     else:
                         tool_output["output"] = output_value
 
-                event_body["tool_call_outputs"] = [tool_output]
+                # Use standard content format: {"type": "tool_call_output", "tool_call_output": {...}}
+                event_body["content"] = [{"type": "tool_call_output", "tool_call_output": tool_output}]
 
             event_name = "gen_ai.tool.message"
 

sdk/ai/azure-ai-projects/tests/agents/telemetry/test_responses_instrumentor.py

@@ -816,7 +816,7 @@ def test_sync_function_tool_with_content_recording_non_streaming(self, **kwargs)
                 "attributes": {
                     "gen_ai.provider.name": "azure.openai",
                     "gen_ai.message.role": "tool",
-                    "gen_ai.event.content": '{"tool_call_outputs": [{"type": "function", "id": "*", "output": {"temperature": "72°F", "condition": "sunny"}}]}',
+                    "gen_ai.event.content": '{"content": [{"type": "tool_call_output", "tool_call_output": {"type": "function", "id": "*", "output": {"temperature": "72°F", "condition": "sunny"}}}]}',
                 },
             },
             {
@@ -1012,7 +1012,7 @@ def test_sync_function_tool_with_content_recording_streaming(self, **kwargs):
                 "attributes": {
                     "gen_ai.provider.name": "azure.openai",
                     "gen_ai.message.role": "tool",
-                    "gen_ai.event.content": '{"tool_call_outputs": [{"type": "function", "id": "*", "output": {"temperature": "72°F", "condition": "sunny"}}]}',
+                    "gen_ai.event.content": '{"content": [{"type": "tool_call_output", "tool_call_output": {"type": "function", "id": "*", "output": {"temperature": "72°F", "condition": "sunny"}}}]}',
                 },
             },
             {
@@ -1519,10 +1519,10 @@ def test_sync_function_tool_list_conversation_items_with_content_recording(self,
         assert "gen_ai.conversation.item.role" in tool_event_attrs
         assert tool_event_attrs["gen_ai.conversation.item.role"] == "tool"
 
-        # Check that content contains tool_call_outputs
+        # Check that content contains tool_call_output
         assert "gen_ai.event.content" in tool_event_attrs
         content = tool_event_attrs["gen_ai.event.content"]
-        assert "tool_call_outputs" in content
+        assert "tool_call_output" in content
         assert "temperature" in content
         assert "72°F" in content
 
@@ -3367,7 +3367,7 @@ def test_responses_stream_method_with_tools_with_content_recording(self, **kwarg
                 "attributes": {
                     "gen_ai.provider.name": "azure.openai",
                     "gen_ai.message.role": "tool",
-                    "gen_ai.event.content": '{"tool_call_outputs": [{"type": "function", "id": "*", "output": {"temperature": "65°F", "condition": "cloudy"}}]}',
+                    "gen_ai.event.content": '{"content": [{"type": "tool_call_output", "tool_call_output": {"type": "function", "id": "*", "output": {"temperature": "65°F", "condition": "cloudy"}}}]}',
                 },
             },
             {

sdk/ai/azure-ai-projects/tests/agents/telemetry/test_responses_instrumentor_async.py

@@ -472,7 +472,7 @@ async def test_async_function_tool_with_content_recording_streaming(self, **kwar
                 "attributes": {
                     "gen_ai.provider.name": "azure.openai",
                     "gen_ai.message.role": "tool",
-                    "gen_ai.event.content": '{"tool_call_outputs": [{"type": "function", "id": "*", "output": {"temperature": "72°F", "condition": "sunny"}}]}',
+                    "gen_ai.event.content": '{"content": [{"type": "tool_call_output", "tool_call_output": {"type": "function", "id": "*", "output": {"temperature": "72°F", "condition": "sunny"}}}]}',
                 },
             },
             {
@@ -2420,7 +2420,7 @@ async def test_async_responses_stream_method_with_tools_with_content_recording(s
                 "attributes": {
                     "gen_ai.provider.name": "azure.openai",
                     "gen_ai.message.role": "tool",
-                    "gen_ai.event.content": '{"tool_call_outputs": [{"type": "function", "id": "*", "output": {"temperature": "65°F", "condition": "cloudy"}}]}',
+                    "gen_ai.event.content": '{"content": [{"type": "tool_call_output", "tool_call_output": {"type": "function", "id": "*", "output": {"temperature": "65°F", "condition": "cloudy"}}}]}',
                 },
             },
             {