fix: address Copilot PR review suggestions

- Add null guards with setup hints for config values (MAF01, MAF02, AIFoundry-01, ImageGen-02)
- Fix AsAgent() -> AsAIAgent() in Lesson 04 workflow docs (7 instances)
- Fix XML doc comment AgentThread -> AgentSession in Persisting-02-Menu
- Localize Spanish translation (April -> abril, production-ready -> listos para producción)

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: elbruno

04-AgentsWithMAF/03-multi-agent-workflows.md

@@ -79,7 +79,7 @@ AIAgent editor = chatClient.AsAIAgent(
 Workflow workflow = AgentWorkflowBuilder.BuildSequential(writer, editor);
 
 // Run the workflow
-AIAgent workflowAgent = workflow.AsAgent();
+AIAgent workflowAgent = workflow.AsAIAgent();
 
 AgentResponse response = await workflowAgent.RunAsync(
     "Write a short story about a haunted house.");
@@ -112,7 +112,7 @@ AIAgent factChecker = chatClient.AsAIAgent(
 Workflow pipeline = AgentWorkflowBuilder.BuildSequential(
     researcher, writer, editor, factChecker);
 
-var response = await pipeline.AsAgent().RunAsync(
+var response = await pipeline.AsAIAgent().RunAsync(
     "Create an article about the history of quantum computing.");
 ```
 
@@ -139,7 +139,7 @@ AIAgent keywordExtractor = chatClient.AsAIAgent(
 Workflow concurrent = AgentWorkflowBuilder.BuildConcurrent(
     sentimentAnalyst, summaryAgent, keywordExtractor);
 
-var response = await concurrent.AsAgent().RunAsync("""
+var response = await concurrent.AsAIAgent().RunAsync("""
     The new product launch exceeded all expectations. Sales were 
     up 200% compared to last year, and customer feedback has been 
     overwhelmingly positive. The marketing team's innovative 
@@ -192,7 +192,7 @@ Workflow handoff = AgentWorkflowBuilder.CreateHandoffBuilderWith(generalSupport)
     .Build();
 
 // First query goes to GeneralSupport, which may route to specialists
-var response = await handoff.AsAgent().RunAsync(
+var response = await handoff.AsAIAgent().RunAsync(
     "I was charged twice for my subscription last month.");
 ```
 
@@ -246,7 +246,7 @@ AIAgent reviewer = ollamaClient.AsAIAgent(
 Workflow multiModel = AgentWorkflowBuilder.BuildSequential(
     researcher, writer, reviewer);
 
-var response = await multiModel.AsAgent().RunAsync(
+var response = await multiModel.AsAIAgent().RunAsync(
     "Create an article about renewable energy innovations.");
 ```
 
@@ -300,7 +300,7 @@ Workflow customWorkflow = AgentWorkflowBuilder.CreateHandoffBuilderWith(intakeAg
     .WithHandoff(complexAgent, responderAgent)
     .Build();
 
-var response = await customWorkflow.AsAgent().RunAsync(
+var response = await customWorkflow.AsAIAgent().RunAsync(
     "Explain quantum entanglement in detail with mathematical formulations.");
 
 Console.WriteLine(response.Text);

04-AgentsWithMAF/04-model-context-protocol.md

@@ -356,7 +356,7 @@ AIAgent documenter = chatClient.AsAIAgent(
 Workflow devWorkflow = AgentWorkflowBuilder.BuildSequential(
     researcher, coder, documenter);
 
-await devWorkflow.AsAgent().RunAsync(
+await devWorkflow.AsAIAgent().RunAsync(
     "Research best practices for error handling, implement them, and document the changes.");
 ```
 

samples/MAF/MAF-AIFoundry-01/Program.cs

@@ -4,8 +4,9 @@
 using Microsoft.Extensions.AI;
 using Microsoft.Extensions.Configuration;
 
-var config= new ConfigurationBuilder().AddUserSecrets<Program>().Build();
-var endpoint = config["AzureOpenAI:Endpoint"];
+var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
+var endpoint = config["AzureOpenAI:Endpoint"] ?? throw new InvalidOperationException(
+    "Missing 'AzureOpenAI:Endpoint'. Run: dotnet user-secrets set \"AzureOpenAI:Endpoint\" \"https://<your-resource>.openai.azure.com/\"");
 var deploymentName = config["AzureOpenAI:Deployment"] ?? "gpt-5-mini";
 
 IChatClient chatClient =

samples/MAF/MAF-ImageGen-02/ImageGenerator.cs

@@ -25,9 +25,12 @@ public static async Task<string> GenerateImageFromPrompt(
             .Build();
 
         // You will need to set these environment variables or edit the following values.
-        var endpoint = config["AzureOpenAI:Endpoint"];
-        var deployment = config["FLUX_DEPLOYMENT_NAME"];
-        var apiKey = config["AZURE_OPENAI_API_KEY"];
+        var endpoint = config["AzureOpenAI:Endpoint"] ?? throw new InvalidOperationException(
+            "Missing 'AzureOpenAI:Endpoint'. Run: dotnet user-secrets set \"AzureOpenAI:Endpoint\" \"https://<your-resource>.openai.azure.com/\"");
+        var deployment = config["FLUX_DEPLOYMENT_NAME"] ?? throw new InvalidOperationException(
+            "Missing 'FLUX_DEPLOYMENT_NAME'. Run: dotnet user-secrets set \"FLUX_DEPLOYMENT_NAME\" \"<your-flux-deployment>\"");
+        var apiKey = config["AZURE_OPENAI_API_KEY"] ?? throw new InvalidOperationException(
+            "Missing 'AZURE_OPENAI_API_KEY'. Run: dotnet user-secrets set \"AZURE_OPENAI_API_KEY\" \"<your-api-key>\"");
 
         // Ensure endpoint ends with /openai/v1/
         if (!endpoint.EndsWith("/openai/v1/"))

samples/MAF/MAF-Persisting-02-Menu/Program.cs

@@ -104,7 +104,7 @@ private static async Task OptionLoadAndContinue(AIAgent agent)
     /// <summary>
     /// Unified interaction function: prompts the user for a question, runs the agent using the provided thread,
     /// prints the response using StreamConsoleHelper, and optionally persists the thread to disk.
-    /// The function returns the (possibly updated) AgentThread so callers can continue working with it.
+    /// The function returns the (possibly updated) AgentSession so callers can continue working with it.
     /// </summary>
     private static async Task<AgentSession> RunQuestionWithThread(AIAgent agent, AgentSession thread, bool persistAfter)
     {

samples/MAF/MAF01/Program.cs

@@ -5,7 +5,8 @@
 using Microsoft.Extensions.Configuration;
 
 var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
-var endpoint = config["AzureOpenAI:Endpoint"];
+var endpoint = config["AzureOpenAI:Endpoint"] ?? throw new InvalidOperationException(
+    "Missing 'AzureOpenAI:Endpoint'. Run: dotnet user-secrets set \"AzureOpenAI:Endpoint\" \"https://<your-resource>.openai.azure.com/\"");
 var deploymentName = config["AzureOpenAI:Deployment"] ?? "gpt-5-mini";
 
 IChatClient chatClient =

samples/MAF/MAF02/Program.cs

@@ -6,7 +6,8 @@
 using Microsoft.Extensions.Configuration;
 
 var config = new ConfigurationBuilder().AddUserSecrets<Program>().Build();
-var endpoint = config["AzureOpenAI:Endpoint"];
+var endpoint = config["AzureOpenAI:Endpoint"] ?? throw new InvalidOperationException(
+    "Missing 'AzureOpenAI:Endpoint'. Run: dotnet user-secrets set \"AzureOpenAI:Endpoint\" \"https://<your-resource>.openai.azure.com/\"");
 var deploymentName = config["AzureOpenAI:Deployment"] ?? "gpt-5-mini";
 
 IChatClient chatClient =

translations/es/README.md

@@ -31,15 +31,15 @@ No olvides [darle una estrella (🌟) a este repositorio](https://docs.github.co
 
 Estamos mejorando constantemente este curso con las últimas herramientas de IA, modelos y ejemplos prácticos:
 
-- **🚀 Microsoft Agent Framework v1.0 GA (April 2026)**
+- **🚀 Microsoft Agent Framework v1.0 GA (abril de 2026)**
 
   Todos los 28 ejemplos de MAF se han actualizado de preview a paquetes **estables v1.0**. Esto incluye un **cambio de ruptura:** `Microsoft.Agents.AI.AzureAI` ha sido renombrado a `Microsoft.Agents.AI.Foundry`.
 
   **2 nuevos escenarios de Hosted Agent** — Implementa agentes containerizados en Azure Foundry Agent Service:
   - [MAF-HostedAgent-01-TimeZone](samples/MAF/MAF-HostedAgent-01-TimeZone/) — Agente alojado simple con herramienta de zona horaria
   - [MAF-HostedAgent-02-MultiAgent](samples/MAF/MAF-HostedAgent-02-MultiAgent/) — Flujo de trabajo de Asistente de Investigación Multi-Agente
 
-  Los flujos de trabajo multi-agente, streaming, persistencia y MCP son ahora production-ready.
+  Los flujos de trabajo multi-agente, streaming, persistencia y MCP están ahora listos para producción.
 
   👉 [Official GA Release](https://github.com/microsoft/agent-framework/releases/tag/dotnet-1.0.0) | [Foundry Agent Service GA](https://devblogs.microsoft.com/foundry/foundry-agent-service-ga/)