Python: [BREAKING] Renamed create_agent to as_agent (#3249)

* Renamed create_agent to as_agent

* Override for as_agent

* Added override

python/samples/getting_started/azure_functions/01_single_agent/function_app.py

@@ -16,7 +16,7 @@ from azure.identity import AzureCliCredential
 def _create_agent() -> Any:
     """Create the Joker agent."""
 
-    return AzureOpenAIChatClient(credential=AzureCliCredential()).create_agent(
+    return AzureOpenAIChatClient(credential=AzureCliCredential()).as_agent(
         name="Joker",
         instructions="You are good at telling jokes.",
     )

python/samples/getting_started/azure_functions/02_multi_agent/function_app.py

@@ -52,13 +52,13 @@ def calculate_tip(bill_amount: float, tip_percentage: float = 15.0) -> dict[str,
 # 1. Create multiple agents, each with its own instruction set and tools.
 chat_client = AzureOpenAIChatClient(credential=AzureCliCredential())
 
-weather_agent = chat_client.create_agent(
+weather_agent = chat_client.as_agent(
     name="WeatherAgent",
     instructions="You are a helpful weather assistant. Provide current weather information.",
     tools=[get_weather],
 )
 
-math_agent = chat_client.create_agent(
+math_agent = chat_client.as_agent(
     name="MathAgent",
     instructions="You are a helpful math assistant. Help users with calculations like tip calculations.",
     tools=[calculate_tip],

python/samples/getting_started/azure_functions/03_reliable_streaming/function_app.py

@@ -151,7 +151,7 @@ redis_callback = RedisStreamCallback()
 # Create the travel planner agent
 def create_travel_agent():
     """Create the TravelPlanner agent with tools."""
-    return AzureOpenAIChatClient(credential=AzureCliCredential()).create_agent(
+    return AzureOpenAIChatClient(credential=AzureCliCredential()).as_agent(
         name="TravelPlanner",
         instructions="""You are an expert travel planner who creates detailed, personalized travel itineraries.
 When asked to plan a trip, you should:

python/samples/getting_started/azure_functions/04_single_agent_orchestration_chaining/function_app.py

@@ -32,7 +32,7 @@ def _create_writer_agent() -> Any:
         "when given an improved sentence you polish it further."
     )
 
-    return AzureOpenAIChatClient(credential=AzureCliCredential()).create_agent(
+    return AzureOpenAIChatClient(credential=AzureCliCredential()).as_agent(
         name=WRITER_AGENT_NAME,
         instructions=instructions,
     )

python/samples/getting_started/azure_functions/05_multi_agent_orchestration_concurrency/function_app.py

@@ -29,12 +29,12 @@ CHEMIST_AGENT_NAME = "ChemistAgent"
 def _create_agents() -> list[Any]:
     chat_client = AzureOpenAIChatClient(credential=AzureCliCredential())
 
-    physicist = chat_client.create_agent(
+    physicist = chat_client.as_agent(
         name=PHYSICIST_AGENT_NAME,
         instructions="You are an expert in physics. You answer questions from a physics perspective.",
     )
 
-    chemist = chat_client.create_agent(
+    chemist = chat_client.as_agent(
         name=CHEMIST_AGENT_NAME,
         instructions="You are an expert in chemistry. You answer questions from a chemistry perspective.",
     )

python/samples/getting_started/azure_functions/06_multi_agent_orchestration_conditionals/function_app.py

@@ -45,12 +45,12 @@ class EmailPayload(BaseModel):
 def _create_agents() -> list[Any]:
     chat_client = AzureOpenAIChatClient(credential=AzureCliCredential())
 
-    spam_agent = chat_client.create_agent(
+    spam_agent = chat_client.as_agent(
         name=SPAM_AGENT_NAME,
         instructions="You are a spam detection assistant that identifies spam emails.",
     )
 
-    email_agent = chat_client.create_agent(
+    email_agent = chat_client.as_agent(
         name=EMAIL_AGENT_NAME,
         instructions="You are an email assistant that helps users draft responses to emails with professionalism.",
     )

python/samples/getting_started/azure_functions/07_single_agent_orchestration_hitl/function_app.py

@@ -51,7 +51,7 @@ def _create_writer_agent() -> Any:
         "Return your response as JSON with 'title' and 'content' fields."
     )
 
-    return AzureOpenAIChatClient(credential=AzureCliCredential()).create_agent(
+    return AzureOpenAIChatClient(credential=AzureCliCredential()).as_agent(
         name=WRITER_AGENT_NAME,
         instructions=instructions,
     )

python/samples/getting_started/azure_functions/08_mcp_server/README.md

@@ -145,17 +145,17 @@ from agent_framework.azure import AgentFunctionApp, AzureOpenAIChatClient
 chat_client = AzureOpenAIChatClient()
 
 # Define agents with different roles
-joker_agent = chat_client.create_agent(
+joker_agent = chat_client.as_agent(
     name="Joker",
     instructions="You are good at telling jokes.",
 )
 
-stock_agent = chat_client.create_agent(
+stock_agent = chat_client.as_agent(
     name="StockAdvisor",
     instructions="Check stock prices.",
 )
 
-plant_agent = chat_client.create_agent(
+plant_agent = chat_client.as_agent(
     name="PlantAdvisor",
     instructions="Recommend plants.",
     description="Get plant recommendations.",

python/samples/getting_started/azure_functions/08_mcp_server/function_app.py

@@ -30,19 +30,19 @@ chat_client = AzureOpenAIChatClient()
 
 # Define three AI agents with different roles
 # Agent 1: Joker - HTTP trigger only (default)
-agent1 = chat_client.create_agent(
+agent1 = chat_client.as_agent(
     name="Joker",
     instructions="You are good at telling jokes.",
 )
 
 # Agent 2: StockAdvisor - MCP tool trigger only
-agent2 = chat_client.create_agent(
+agent2 = chat_client.as_agent(
     name="StockAdvisor",
     instructions="Check stock prices.",
 )
 
 # Agent 3: PlantAdvisor - Both HTTP and MCP tool triggers
-agent3 = chat_client.create_agent(
+agent3 = chat_client.as_agent(
     name="PlantAdvisor",
     instructions="Recommend plants.",
     description="Get plant recommendations.",