Add activity run step to MCP (Azure#51580)

* Add activity step

* Update samples for MCP Activity step

* Remove test code and regenerate

* Regerste the code

* Regenerate code

* Fix comment

* Update tsp-location

Author: nick863

sdk/ai/Azure.AI.Agents.Persistent/CHANGELOG.md

@@ -5,6 +5,7 @@
 ### Features Added
 
 - Implemented streaming scenario for MCP tool.
+- Added `RunStepDetailsActivity`, describing MCP function parameters.
 
 ### Breaking Changes
 

sdk/ai/Azure.AI.Agents.Persistent/api/Azure.AI.Agents.Persistent.net8.0.cs

@@ -147,59 +147,103 @@ Assert.AreEqual(
     run.LastError?.Message);
 ```
 
-5. Print the agent messages to console in chronological order.
+5. We will create the helper method `PrintActivitySteps` to list the functions being called with the descriptions and arguments.
 
-Synchronous sample:
-```C# Snippet:AgentsMCP_Print
-Pageable<PersistentThreadMessage> messages = agentClient.Messages.GetMessages(
-    threadId: thread.Id,
-    order: ListSortOrder.Ascending
-);
-
-foreach (PersistentThreadMessage threadMessage in messages)
+```C# Snippet:AgentsMcpPrintActivityStep
+private static void PrintActivitySteps(IReadOnlyList<RunStep> runSteps)
 {
-    Console.Write($"{threadMessage.CreatedAt:yyyy-MM-dd HH:mm:ss} - {threadMessage.Role,10}: ");
-    foreach (MessageContent contentItem in threadMessage.ContentItems)
+    foreach (RunStep step in runSteps)
     {
-        if (contentItem is MessageTextContent textItem)
+        if (step.StepDetails is RunStepActivityDetails activityDetails)
         {
-            Console.Write(textItem.Text);
-        }
-        else if (contentItem is MessageImageFileContent imageFileItem)
-        {
-            Console.Write($"<image from ID: {imageFileItem.FileId}>");
+            foreach (RunStepDetailsActivity activity in activityDetails.Activities)
+            {
+                foreach (KeyValuePair<string, ActivityFunctionDefinition> activityFunction in activity.Tools)
+                {
+                    Console.WriteLine($"The function {activityFunction.Key} with description \"{activityFunction.Value.Description}\" will be called.");
+                    if (activityFunction.Value.Parameters.Properties.Count > 0)
+                    {
+                        Console.WriteLine("Function parameters:");
+                        foreach (KeyValuePair<string, FunctionArgument> arg in activityFunction.Value.Parameters.Properties)
+                        {
+                            Console.WriteLine($"\t{arg.Key}");
+                            Console.WriteLine($"\t\tType: {arg.Value.Type}");
+                            if (!string.IsNullOrEmpty(arg.Value.Description))
+                                Console.WriteLine($"\t\tDescription: {arg.Value.Description}");
+                        }
+                    }
+                    else
+                    {
+                        Console.WriteLine("This function has no parameters");
+                    }
+                }
+            }
         }
-        Console.WriteLine();
     }
 }
 ```
 
+6. Print activities description.
+
+Synchronous sample:
+```C# Snippet:AgentsMCP_PrintRunSteps
+IReadOnlyList<RunStep> runSteps = [..agentClient.Runs.GetRunSteps(run: run)];
+PrintActivitySteps(runSteps);
+```
+
 Asynchronous sample:
-```C# Snippet:AgentsMCPAsync_Print
-AsyncPageable<PersistentThreadMessage> messages = agentClient.Messages.GetMessagesAsync(
-    threadId: thread.Id,
-    order: ListSortOrder.Ascending
-);
+```C# Snippet:AgentsMCPAsync_PrintRunSteps
+IReadOnlyList<RunStep> runSteps = [.. agentClient.Runs.GetRunSteps(run: run)];
+PrintActivitySteps(runSteps);
+```
 
-await foreach (PersistentThreadMessage threadMessage in messages)
+7. To print messages, we will use the helper method `PrintMessages`.
+
+```C# Snippet:AgentsMcpPrintMessages
+private static void PrintMessages(IReadOnlyList<PersistentThreadMessage> messages)
 {
-    Console.Write($"{threadMessage.CreatedAt:yyyy-MM-dd HH:mm:ss} - {threadMessage.Role,10}: ");
-    foreach (MessageContent contentItem in threadMessage.ContentItems)
+    foreach (PersistentThreadMessage threadMessage in messages)
     {
-        if (contentItem is MessageTextContent textItem)
-        {
-            Console.Write(textItem.Text);
-        }
-        else if (contentItem is MessageImageFileContent imageFileItem)
+        Console.Write($"{threadMessage.CreatedAt:yyyy-MM-dd HH:mm:ss} - {threadMessage.Role,10}: ");
+        foreach (MessageContent contentItem in threadMessage.ContentItems)
         {
-            Console.Write($"<image from ID: {imageFileItem.FileId}>");
+            if (contentItem is MessageTextContent textItem)
+            {
+                Console.Write(textItem.Text);
+            }
+            else if (contentItem is MessageImageFileContent imageFileItem)
+            {
+                Console.Write($"<image from ID: {imageFileItem.FileId}>");
+            }
+            Console.WriteLine();
         }
-        Console.WriteLine();
     }
 }
 ```
 
-6. Clean up resources by deleting thread and agent.
+8. Print the agent messages to console in chronological order.
+
+Synchronous sample:
+```C# Snippet:AgentsMCP_Print
+IReadOnlyList<PersistentThreadMessage> messages = [..agentClient.Messages.GetMessages(
+    threadId: thread.Id,
+    order: ListSortOrder.Ascending
+)];
+
+PrintMessages(messages);
+```
+
+Asynchronous sample:
+```C# Snippet:AgentsMCPAsync_Print
+IReadOnlyList<PersistentThreadMessage> messages = await agentClient.Messages.GetMessagesAsync(
+    threadId: thread.Id,
+    order: ListSortOrder.Ascending
+).ToListAsync();
+
+PrintMessages(messages);
+```
+
+9. Clean up resources by deleting thread and agent.
 
 Synchronous sample:
 ```C# Snippet:AgentsMCPCleanup

sdk/ai/Azure.AI.Agents.Persistent/api/Azure.AI.Agents.Persistent.netstandard2.0.cs

@@ -84,7 +84,40 @@ CreateRunStreamingOptions options = new()
 };
 ```
 
-5 Start the streaming update loop. When asked, we will approve using tool.
+5. To simplify the code we will use `PrintActivityStep` to display functions called and along with their parameters.
+
+```C# Snippet:AgentsMCPStreaming_PrintActivityStep
+private static void PrintActivityStep(RunStep step)
+{
+    if (step.StepDetails is RunStepActivityDetails activityDetails)
+    {
+        foreach (RunStepDetailsActivity activity in activityDetails.Activities)
+        {
+            foreach (KeyValuePair<string, ActivityFunctionDefinition> activityFunction in activity.Tools)
+            {
+                Console.WriteLine($"The function {activityFunction.Key} with description \"{activityFunction.Value.Description}\" will be called.");
+                if (activityFunction.Value.Parameters.Properties.Count > 0)
+                {
+                    Console.WriteLine("Function parameters:");
+                    foreach (KeyValuePair<string, FunctionArgument> arg in activityFunction.Value.Parameters.Properties)
+                    {
+                        Console.WriteLine($"\t{arg.Key}");
+                        Console.WriteLine($"\t\tType: {arg.Value.Type}");
+                        if (!string.IsNullOrEmpty(arg.Value.Description))
+                            Console.WriteLine($"\t\tDescription: {arg.Value.Description}");
+                    }
+                }
+                else
+                {
+                    Console.WriteLine("This function has no parameters");
+                }
+            }
+        }
+    }
+}
+```
+
+6. Start the streaming update loop. When asked, we will approve using tool.
 
 Synchronous sample:
 ```C# Snippet:AgentsMCPStreaming_UpdateCycle
@@ -113,6 +146,10 @@ do
         {
             Console.Write(contentUpdate.Text);
         }
+        else if (streamingUpdate is RunStepUpdate runStepUpdate)
+        {
+            PrintActivityStep(runStepUpdate.Value);
+        }
         else if (streamingUpdate.UpdateKind == StreamingUpdateReason.RunCompleted)
         {
             Console.WriteLine();
@@ -158,6 +195,10 @@ do
         {
             Console.Write(contentUpdate.Text);
         }
+        else if (streamingUpdate is RunStepUpdate runStepUpdate)
+        {
+            PrintActivityStep(runStepUpdate.Value);
+        }
         else if (streamingUpdate.UpdateKind == StreamingUpdateReason.RunCompleted)
         {
             Console.WriteLine();