Multiagent sample update (#41121)

* multiagent sample update

* ai feedback

* update

* review feedback

Author: Jarno Hakulinen

sdk/ai/azure-ai-agents/samples/agents_multiagent/sample_agents_agent_team.py

@@ -7,16 +7,30 @@
 DESCRIPTION:
     This sample demonstrates how to use multiple agents using AgentTeam with traces.
 
+    The team consists of
+        • one leader agent - automatically created by AgentTeam from the
+          configuration in `utils/agent_team_config.yaml`
+        • two worker agents - `Coder` and `Reviewer`, defined in the code below
+
+    IMPORTANT - leader-agent model configuration
+        `utils/agent_team_config.yaml` contains the key  TEAM_LEADER_MODEL.
+        Its value must be the name of a **deployed** model in your Azure AI
+        project (e.g. "gpt-4o-mini").  
+        If this model deployment is not available, AgentTeam cannot instantiate
+        the leader agent and the sample will fail.
+
 USAGE:
     python sample_agents_agent_team.py
 
     Before running the sample:
 
-    pip install azure-ai-agents azure-identity
-
-    Set these environment variables with your own values:
-    PROJECT_ENDPOINT - the Azure AI Agents endpoint.
-    MODEL_DEPLOYMENT_NAME - the name of the model deployment to use.
+    1. pip install azure-ai-agents azure-identity
+    2. Ensure `utils/agent_team_config.yaml` is present and TEAM_LEADER_MODEL points
+       to a valid model deployment.
+    3. Set these environment variables with your own values:
+         PROJECT_ENDPOINT - The Azure AI Project endpoint, as found in the Overview 
+                            page of your Azure AI Foundry portal.
+         MODEL_DEPLOYMENT_NAME - The model deployment name used for the worker agents.
 """
 
 import os

sdk/ai/azure-ai-agents/samples/agents_multiagent/sample_agents_multi_agent_team.py

@@ -6,18 +6,34 @@
 
 """
 DESCRIPTION:
-    This sample demonstrates how to use multiple agents to execute tasks.
+    This sample demonstrates how to use an AgentTeam to execute a multi-step
+    user request with automatic function calling and trace collection.
+
+    The team consists of
+        • one leader agent - created automatically from the configuration in
+          `utils/agent_team_config.yaml`
+        • three worker agents - `TimeWeatherAgent`, `SendEmailAgent`, and
+          `TemperatureAgent`, each defined in the code below with its own tools
+
+    IMPORTANT - leader-agent model configuration
+        `utils/agent_team_config.yaml` contains the key TEAM_LEADER_MODEL.
+        Its value must be the name of a **deployed** model in your Azure AI
+        project (e.g. "gpt-4o-mini").
+        If this deployment does not exist, AgentTeam cannot instantiate the
+        leader agent and the sample will fail.
 
 USAGE:
     python sample_agents_multi_agent_team.py
 
     Before running the sample:
 
-    pip install azure-ai-agents azure-identity
-
-    Set these environment variables with your own values:
-    PROJECT_ENDPOINT - the Azure AI Agents endpoint.
-    MODEL_DEPLOYMENT_NAME - the name of the model deployment to use.
+    1. pip install azure-ai-agents azure-identity
+    2. Ensure `utils/agent_team_config.yaml` is present and TEAM_LEADER_MODEL points
+       to a valid model deployment.
+    3. Set these environment variables with your own values:
+         PROJECT_ENDPOINT - The Azure AI Project endpoint, as found in the Overview 
+                            page of your Azure AI Foundry portal.
+         MODEL_DEPLOYMENT_NAME - The model deployment name used for the worker agents.
 """
 
 import os

sdk/ai/azure-ai-agents/samples/agents_multiagent/utils/agent_team.py

@@ -7,7 +7,7 @@
 import yaml  # type: ignore
 
 from opentelemetry import trace
-from opentelemetry.trace import StatusCode, Span  # noqa: F401 # pylint: disable=unused-import
+from opentelemetry.trace import Span  # noqa: F401 # pylint: disable=unused-import
 from typing import Any, Dict, Optional, Set, List
 from azure.ai.agents import AgentsClient
 from azure.ai.agents.models import FunctionTool, ToolSet, MessageRole, Agent, AgentThread

sdk/ai/azure-ai-agents/samples/agents_multiagent/utils/agent_team_config.yaml

@@ -1,5 +1,5 @@
 TEAM_LEADER_MODEL: |
-    gpt-4
+    gpt-4o-mini
 
 TEAM_LEADER_INSTRUCTIONS: |
     You are an agent named '{agent_name}'. You are a leader of a team of agents. The name of your team is '{team_name}'.