Merge pull request #705 from westey-m/docs-bugfixing-2

A selection of AF docs fixes.

Author: markwallace-microsoft

agent-framework/tutorials/agents/agent-as-mcp-tool.md

@@ -17,7 +17,24 @@ This tutorial shows you how to expose an agent as a tool over the Model Context
 
 ## Prerequisites
 
-For prerequisites and installing nuget packages, see the [Create and run a simple agent](./run-agent.md) step in this tutorial.
+For prerequisites see the [Create and run a simple agent](./run-agent.md) step in this tutorial.
+
+## Installing Nuget packages
+
+To use the Microsoft Agent Framework with Azure OpenAI, you need to install the following NuGet packages:
+
+```powershell
+dotnet add package Azure.Identity
+dotnet add package Azure.AI.OpenAI
+dotnet add package Microsoft.Agents.AI.OpenAI --prerelease
+```
+
+To add support for hosting a tool over the Model Context Protocol (MCP), all add the following Nuget packages
+
+```powershell
+dotnet add package Microsoft.Extensions.Hosting --prerelease
+dotnet add package ModelContextProtocol --prerelease
+```
 
 ## Exposing an agent as an MCP tool
 

agent-framework/tutorials/agents/enable-observability.md

@@ -73,7 +73,9 @@ AIAgent agent = new AzureOpenAIClient(
     new AzureCliCredential())
         .GetChatClient("gpt-4o-mini")
         .CreateAIAgent(instructions: "You are good at telling jokes.", name: "Joker")
-        .WithOpenTelemetry(sourceName: "agent-telemetry-source");
+        .AsBuilder()
+        .UseOpenTelemetry(sourceName: "agent-telemetry-source")
+        .Build();
 ```
 
 Run the agent and print the text response. The console exporter will show trace data on the console.

agent-framework/tutorials/agents/run-agent.md

@@ -145,8 +145,10 @@ Here is an example with a system and user message:
 ```csharp
 ChatMessage systemMessage = new(
     ChatRole.System,
-    """If the user asks you to tell a joke, refuse to do so, explaining that you are not a clown.
-    Offer the user an interesting fact instead.""");
+    """
+    If the user asks you to tell a joke, refuse to do so, explaining that you are not a clown.
+    Offer the user an interesting fact instead.
+    """);
 ChatMessage userMessage = new(ChatRole.User, "Tell me a joke about a pirate.");
 
 Console.WriteLine(await agent.RunAsync([systemMessage, userMessage]));

agent-framework/user-guide/agents/agent-types/azure-ai-foundry-agent.md

@@ -20,6 +20,7 @@ The Microsoft Agent Framework supports creating agents that use the [Azure AI Fo
 Add the Agents Azure AI NuGet package to your project.
 
 ```powershell
+dotnet add package Azure.Identity
 dotnet add package Microsoft.Agents.AI.AzureAI --prerelease
 ```
 

agent-framework/user-guide/agents/agent-types/index.md

@@ -37,7 +37,7 @@ These agents support a wide range of functionality out of the box:
 To create one of these agents, simply construct a `ChatClientAgent` using the ChatClient implementation of your choice.
 
 ```csharp
-using Microsoft.Extensions.AI;
+using Microsoft.Agents.AI;
 
 var agent = new ChatClientAgent(chatClient, instructions: "You are a helpful assistant");
 ```