Add connected agent tool details and delta. (#36439)

Author: nick863

specification/ai/Azure.AI.Agents/run_steps/models.tsp

@@ -273,6 +273,17 @@ model RunStepDeltaOpenAPIObject extends RunStepDeltaDetail {
   toolCalls?: RunStepDeltaOpenAPIToolCall[];
 }
 
+/** Represents the invocation of connected agent as a part of a streaming run step. */
+@added(Versions.v2025_05_15_preview)
+model RunStepDeltaConnectedAgentToolCall extends RunStepDeltaToolCall {
+  /** The object type, which is always "connected_agent". */
+  type: "connected_agent";
+
+  /** The collection of tool calls for the tool call detail item. */
+  @encodedName("application/json", "connected_agent")
+  connectedAgent: RunStepConnectedAgent;
+}
+
 /** The abstract base representation of a single tool call within a streaming run step's delta tool call details. */
 @discriminator("type")
 @added(Versions.v2025_05_01)

specification/ai/Azure.AI.Agents/tools/models.tsp

@@ -690,6 +690,17 @@ model RunStepDeepResearchToolCall extends RunStepToolCall {
   deepResearch: RunStepDeepResearchToolCallDetails;
 }
 
+/** A record of a call to the connected agent. */
+@added(Versions.v2025_05_15_preview)
+model RunStepConnectedAgentToolCall extends RunStepToolCall {
+  @doc("The object type, which is always 'connected_agent'.")
+  type: "connected_agent";
+
+  @doc("The connected agent step information.")
+  @encodedName("application/json", "connected_agent")
+  connectedAgent: RunStepConnectedAgent;
+}
+
 // Call details: Code Interpreter
 
 @doc("The detailed information about a code interpreter invocation by the model.")
@@ -785,6 +796,33 @@ model RunStepDeepResearchToolCallDetails {
   output?: string;
 }
 
+// Call details: ConnectedAgent
+
+@doc("The detailed information about connected agent tool call.")
+@added(Versions.v2025_05_15_preview)
+model RunStepConnectedAgent {
+  @doc("The name of connected agent.")
+  name?: string;
+
+  @doc("The JSON serialized query to the connected agent.")
+  arguments?: string;
+
+  @doc("The tool output.")
+  output?: string;
+
+  @doc("The run ID used by the connected agent.")
+  @encodedName("application/json", "run_id")
+  runId?: string;
+
+  @doc("The thread ID used by the connected agent.")
+  @encodedName("application/json", "thread_id")
+  threadId?: string;
+
+  @doc("The ID of a connected agent.")
+  @encodedName("application/json", "assistant_id")
+  agentId?: string;
+}
+
 //
 // Tool outputs -- structured data that provides requested information from tools back to the model
 //

specification/ai/data-plane/Azure.AI.Agents/preview/2025-05-15-preview/azure-ai-agents.json

@@ -6467,6 +6467,59 @@
         "total_tokens"
       ]
     },
+    "RunStepConnectedAgent": {
+      "type": "object",
+      "description": "The detailed information about connected agent tool call.",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "The name of connected agent."
+        },
+        "arguments": {
+          "type": "string",
+          "description": "The JSON serialized query to the connected agent."
+        },
+        "output": {
+          "type": "string",
+          "description": "The tool output."
+        },
+        "run_id": {
+          "type": "string",
+          "description": "The run ID used by the connected agent.",
+          "x-ms-client-name": "runId"
+        },
+        "thread_id": {
+          "type": "string",
+          "description": "The thread ID used by the connected agent.",
+          "x-ms-client-name": "threadId"
+        },
+        "assistant_id": {
+          "type": "string",
+          "description": "The ID of a connected agent.",
+          "x-ms-client-name": "agentId"
+        }
+      }
+    },
+    "RunStepConnectedAgentToolCall": {
+      "type": "object",
+      "description": "A record of a call to the connected agent.",
+      "properties": {
+        "connected_agent": {
+          "$ref": "#/definitions/RunStepConnectedAgent",
+          "description": "The connected agent step information.",
+          "x-ms-client-name": "connectedAgent"
+        }
+      },
+      "required": [
+        "connected_agent"
+      ],
+      "allOf": [
+        {
+          "$ref": "#/definitions/RunStepToolCall"
+        }
+      ],
+      "x-ms-discriminator-value": "connected_agent"
+    },
     "RunStepDeepResearchToolCall": {
       "type": "object",
       "description": "A record of a call to a Deep Research tool, issued by the model in evaluation of a defined tool, that represents\nexecuted deep research operations.",
@@ -6687,6 +6740,26 @@
       ],
       "x-ms-discriminator-value": "code_interpreter"
     },
+    "RunStepDeltaConnectedAgentToolCall": {
+      "type": "object",
+      "description": "Represents the invocation of connected agent as a part of a streaming run step.",
+      "properties": {
+        "connected_agent": {
+          "$ref": "#/definitions/RunStepConnectedAgent",
+          "description": "The collection of tool calls for the tool call detail item.",
+          "x-ms-client-name": "connectedAgent"
+        }
+      },
+      "required": [
+        "connected_agent"
+      ],
+      "allOf": [
+        {
+          "$ref": "#/definitions/RunStepDeltaToolCall"
+        }
+      ],
+      "x-ms-discriminator-value": "connected_agent"
+    },
     "RunStepDeltaDeepResearchToolCall": {
       "type": "object",
       "description": "Represents the Deep research in a streaming run step.",