Merge pull request #822 from dmytrostruk/python-as-agent-updates

Python: Renamed create_agent to as_agent

Author: dmytrostruk

agent-framework/migration-guide/from-autogen/index.md

@@ -234,7 +234,7 @@ async def example():
     )
 
     # Factory method (more convenient)
-    agent = client.create_agent(
+    agent = client.as_agent(
         name="assistant",
         instructions="You are a helpful assistant.",
         tools=[get_weather],

agent-framework/migration-guide/from-semantic-kernel/index.md

@@ -381,7 +381,7 @@ Or, with the convenience methods provided by chat clients:
 ```python
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential
-agent = AzureOpenAIChatClient(credential=AzureCliCredential()).create_agent(instructions="You are a helpful assistant")
+agent = AzureOpenAIChatClient(credential=AzureCliCredential()).as_agent(instructions="You are a helpful assistant")
 ```
 
 The direct method exposes all possible parameters you can set for your agent. While the convenience method has a subset, you can still pass in the same set of parameters, because it calls the direct method internally.
@@ -467,7 +467,7 @@ def get_weather(location: str) -> str:
     """Get the weather for a given location."""
     return f"The weather in {location} is sunny."
 
-agent = chat_client.create_agent(tools=get_weather)
+agent = chat_client.as_agent(tools=get_weather)
 ```
 
 > [!NOTE]
@@ -516,7 +516,7 @@ class Plugin:
         return f"The weather in {location} is sunny with a high of 25°C and a low of 15°C."
 
 plugin = Plugin("Initial state")
-agent = chat_client.create_agent(tools=[plugin.get_weather, plugin.get_weather_details])
+agent = chat_client.as_agent(tools=[plugin.get_weather, plugin.get_weather_details])
 
 ... # use the agent
 
@@ -575,7 +575,7 @@ kernel_function = KernelFunctionFromPrompt(
 agent_tool = kernel_function.as_agent_framework_tool(kernel=kernel)
 
 # Use the tool with an Agent Framework agent
-agent = OpenAIResponsesClient(model_id="gpt-4o").create_agent(tools=agent_tool)
+agent = OpenAIResponsesClient(model_id="gpt-4o").as_agent(tools=agent_tool)
 response = await agent.run("What kind of day is it?")
 print(response.text)
 ```
@@ -595,7 +595,7 @@ def get_weather(self, location: str) -> str:
 agent_tool = get_weather.as_agent_framework_tool()
 
 # Use the tool with an Agent Framework agent
-agent = OpenAIResponsesClient(model_id="gpt-4o").create_agent(tools=agent_tool)
+agent = OpenAIResponsesClient(model_id="gpt-4o").as_agent(tools=agent_tool)
 response = await agent.run("What's the weather in Seattle?")
 print(response.text)
 ```
@@ -663,7 +663,7 @@ async with collection:
     search_tool = search_function.as_agent_framework_tool()
 
     # Use the tool with an Agent Framework agent
-    agent = OpenAIResponsesClient(model_id="gpt-4o").create_agent(
+    agent = OpenAIResponsesClient(model_id="gpt-4o").as_agent(
         instructions="You are a travel agent that helps people find hotels.",
         tools=search_tool
     )
@@ -779,7 +779,7 @@ from agent_framework.openai import OpenAIChatClient
 client = OpenAIChatClient()
 
 # Set default options at agent creation
-agent = client.create_agent(
+agent = client.as_agent(
     instructions="You are a helpful assistant.",
     default_options={
         "max_tokens": 1000,

agent-framework/support/upgrade/typed-options-guide-python.md

@@ -54,7 +54,7 @@ response = await client.get_response(
 )
 ```
 
-> **Note:** For **Agents**, the `instructions` and `tools` parameters remain available as direct keyword arguments on `ChatAgent.__init__()` and `client.create_agent()`. For `agent.run()`, only `tools` is available as a keyword argument:
+> **Note:** For **Agents**, the `instructions` and `tools` parameters remain available as direct keyword arguments on `ChatAgent.__init__()` and `client.as_agent()`. For `agent.run()`, only `tools` is available as a keyword argument:
 >
 > ```python
 > # Agent creation accepts both tools and instructions as keyword arguments

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

@@ -103,7 +103,7 @@ Create a `ChatAgent` that uses the function tool.
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential
 
-weather_agent = AzureOpenAIChatClient(credential=AzureCliCredential()).create_agent(
+weather_agent = AzureOpenAIChatClient(credential=AzureCliCredential()).as_agent(
     name="WeatherAgent",
     description="An agent that answers questions about the weather.",
     instructions="You answer questions about the weather.",
@@ -114,7 +114,7 @@ weather_agent = AzureOpenAIChatClient(credential=AzureCliCredential()).create_ag
 Now, create a main agent and provide the `weather_agent` as a function tool by calling `.as_tool()` to convert `weather_agent` to a function tool.
 
 ```python
-main_agent = AzureOpenAIChatClient(credential=AzureCliCredential()).create_agent(
+main_agent = AzureOpenAIChatClient(credential=AzureCliCredential()).as_agent(
     instructions="You are a helpful assistant who responds in French.",
     tools=weather_agent.as_tool()
 )
@@ -138,7 +138,7 @@ weather_tool = weather_agent.as_tool(
     arg_description="The weather query or location"
 )
 
-main_agent = AzureOpenAIChatClient(credential=AzureCliCredential()).create_agent(
+main_agent = AzureOpenAIChatClient(credential=AzureCliCredential()).as_agent(
     instructions="You are a helpful assistant who responds in French.",
     tools=weather_tool
 )

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

@@ -114,7 +114,7 @@ def get_item_price(
     return "$9.99"
 
 # Create an agent with tools
-agent = OpenAIResponsesClient().create_agent(
+agent = OpenAIResponsesClient().as_agent(
     name="RestaurantAgent",
     description="Answer questions about the menu.",
     tools=[get_specials, get_item_price],

agent-framework/tutorials/agents/create-and-run-durable-agent.md

@@ -222,7 +222,7 @@ agent = AzureOpenAIChatClient(
     endpoint=endpoint,
     deployment_name=deployment_name,
     credential=DefaultAzureCredential()
-).create_agent(
+).as_agent(
     instructions="You are a helpful assistant that can answer questions and provide information.",
     name="MyDurableAgent"
 )

agent-framework/tutorials/agents/function-tools.md

@@ -117,7 +117,7 @@ import asyncio
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential
 
-agent = AzureOpenAIChatClient(credential=AzureCliCredential()).create_agent(
+agent = AzureOpenAIChatClient(credential=AzureCliCredential()).as_agent(
     instructions="You are a helpful assistant",
     tools=get_weather
 )
@@ -163,7 +163,7 @@ When creating the agent, you can now provide all the methods of the class as fun
 
 ```python
 tools = WeatherTools()
-agent = AzureOpenAIChatClient(credential=AzureCliCredential()).create_agent(
+agent = AzureOpenAIChatClient(credential=AzureCliCredential()).as_agent(
     instructions="You are a helpful assistant",
     tools=[tools.get_weather, tools.get_weather_details]
 )

agent-framework/tutorials/agents/images.md

@@ -66,7 +66,7 @@ import asyncio
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential
 
-agent = AzureOpenAIChatClient(credential=AzureCliCredential()).create_agent(
+agent = AzureOpenAIChatClient(credential=AzureCliCredential()).as_agent(
     name="VisionAgent",
     instructions="You are a helpful agent that can analyze images"
 )

agent-framework/tutorials/agents/middleware.md

@@ -217,7 +217,7 @@ from azure.identity.aio import AzureCliCredential
 async def main():
     credential = AzureCliCredential()
 
-    async with AzureAIAgentClient(credential=credential).create_agent(
+    async with AzureAIAgentClient(credential=credential).as_agent(
         name="GreetingAgent",
         instructions="You are a friendly greeting assistant.",
     ) as agent:
@@ -256,7 +256,7 @@ Add the middleware when creating your agent:
 async def main():
     credential = AzureCliCredential()
 
-    async with AzureAIAgentClient(credential=credential).create_agent(
+    async with AzureAIAgentClient(credential=credential).as_agent(
         name="GreetingAgent",
         instructions="You are a friendly greeting assistant.",
         middleware=logging_agent_middleware,  # Add your middleware here
@@ -289,7 +289,7 @@ async def logging_function_middleware(
     print(f"Function result: {context.result}")
 
 # Add both the function and middleware to your agent
-async with AzureAIAgentClient(credential=credential).create_agent(
+async with AzureAIAgentClient(credential=credential).as_agent(
     name="TimeAgent",
     instructions="You can tell the current time.",
     tools=[get_time],

agent-framework/tutorials/agents/orchestrate-durable-agents.md

@@ -125,18 +125,18 @@ chat_client = AzureOpenAIChatClient(
 )
 
 # Create the main agent from the first tutorial
-main_agent = chat_client.create_agent(
+main_agent = chat_client.as_agent(
     instructions="You are a helpful assistant that can answer questions and provide information.",
     name="MyDurableAgent"
 )
 
 # Create translation agents
-french_agent = chat_client.create_agent(
+french_agent = chat_client.as_agent(
     instructions="You are a translator. Translate the following text to French. Return only the translation, no explanations.",
     name="FrenchTranslator"
 )
 
-spanish_agent = chat_client.create_agent(
+spanish_agent = chat_client.as_agent(
     instructions="You are a translator. Translate the following text to Spanish. Return only the translation, no explanations.",
     name="SpanishTranslator"
 )