Python: [BREAKING] changed AIFunction to FunctionTool and @ai_function to @tool (#3413)

* changed AIFunction to FunctionTool and @ai_function to @tool

* test and mypy fixes

* mypy fix

* switch function tool to always_require

* fix noop

* fix github copilot imports

* test fixes

* fix ollama test

* fixes for tests

* fix tests

* reverted change to always_require and extended timeout

* fix test

python/samples/getting_started/devui/azure_responses_agent/agent.py

@@ -21,7 +21,7 @@ import logging
 import os
 from typing import Annotated
 
-from agent_framework import ChatAgent, ai_function
+from agent_framework import ChatAgent, tool
 from agent_framework.azure import AzureOpenAIResponsesClient
 
 logger = logging.getLogger(__name__)
@@ -50,7 +50,8 @@ def analyze_content(
     return f"Analyzing content for: {query}"
 
 
-@ai_function
+# NOTE: approval_mode="never_require" is for sample brevity. Use "always_require" in production; see samples/getting_started/tools/function_tool_with_approval.py and samples/getting_started/tools/function_tool_with_approval_and_threads.py.
+@tool(approval_mode="never_require")
 def summarize_document(
     length: Annotated[str, "Desired summary length: 'brief', 'medium', or 'detailed'"] = "medium",
 ) -> str:
@@ -58,7 +59,7 @@ def summarize_document(
     return f"Generating {length} summary of the document..."
 
 
-@ai_function
+@tool(approval_mode="never_require")
 def extract_key_points(
     max_points: Annotated[int, "Maximum number of key points to extract"] = 5,
 ) -> str:

python/samples/getting_started/devui/fanout_workflow/workflow.py

@@ -25,6 +25,7 @@ from agent_framework import (
     WorkflowBuilder,
     WorkflowContext,
     handler,
+    tool,
 )
 from pydantic import BaseModel, Field
 from typing_extensions import Never

python/samples/getting_started/devui/foundry_agent/agent.py

@@ -9,11 +9,13 @@ import os
 from typing import Annotated
 
 from agent_framework import ChatAgent
+from agent_framework import tool
 from agent_framework.azure import AzureAIAgentClient
 from azure.identity.aio import AzureCliCredential
 from pydantic import Field
 
-
+# NOTE: approval_mode="never_require" is for sample brevity. Use "always_require" in production; see samples/getting_started/tools/function_tool_with_approval.py and samples/getting_started/tools/function_tool_with_approval_and_threads.py.
+@tool(approval_mode="never_require")
 def get_weather(
     location: Annotated[str, Field(description="The location to get the weather for.")],
 ) -> str:
@@ -22,7 +24,7 @@ def get_weather(
     temperature = 22
     return f"The weather in {location} is {conditions[0]} with a high of {temperature}°C."
 
-
+@tool(approval_mode="never_require")
 def get_forecast(
     location: Annotated[str, Field(description="The location to get the forecast for.")],
     days: Annotated[int, Field(description="Number of days for forecast")] = 3,

python/samples/getting_started/devui/in_memory_mode.py

@@ -11,12 +11,16 @@ import os
 from typing import Annotated
 
 from agent_framework import ChatAgent, Executor, WorkflowBuilder, WorkflowContext, handler
+from agent_framework import tool
 from agent_framework.azure import AzureOpenAIChatClient
 from agent_framework.devui import serve
 from typing_extensions import Never
 
 
+# NOTE: approval_mode="never_require" is for sample brevity. Use "always_require" in production; see samples/getting_started/tools/function_tool_with_approval.py and samples/getting_started/tools/function_tool_with_approval_and_threads.py.
+@tool(approval_mode="never_require")
 # Tool functions for the agent
+@tool(approval_mode="never_require")
 def get_weather(
     location: Annotated[str, "The location to get the weather for."],
 ) -> str:
@@ -25,7 +29,7 @@ def get_weather(
     temperature = 53
     return f"The weather in {location} is {conditions[0]} with a high of {temperature}°C."
 
-
+@tool(approval_mode="never_require")
 def get_time(
     timezone: Annotated[str, "The timezone to get time for."] = "UTC",
 ) -> str:

python/samples/getting_started/devui/spam_workflow/workflow.py

@@ -27,6 +27,7 @@ from agent_framework import (
     WorkflowContext,
     handler,
     response_handler,
+    tool,
 )
 from pydantic import BaseModel, Field
 from typing_extensions import Never

python/samples/getting_started/devui/weather_agent_azure/agent.py

@@ -15,7 +15,7 @@ from agent_framework import (
     FunctionInvocationContext,
     Role,
     TextContent,
-    ai_function,
+    tool,
     chat_middleware,
     function_middleware,
 )
@@ -98,6 +98,8 @@ async def atlantis_location_filter_middleware(
     await next(context)
 
 
+# NOTE: approval_mode="never_require" is for sample brevity. Use "always_require" in production; see samples/getting_started/tools/function_tool_with_approval.py and samples/getting_started/tools/function_tool_with_approval_and_threads.py.
+@tool(approval_mode="never_require")
 def get_weather(
     location: Annotated[str, "The location to get the weather for."],
 ) -> str:
@@ -107,6 +109,7 @@ def get_weather(
     return f"The weather in {location} is {conditions[0]} with a high of {temperature}°C."
 
 
+@tool(approval_mode="never_require")
 def get_forecast(
     location: Annotated[str, "The location to get the forecast for."],
     days: Annotated[int, "Number of days for forecast"] = 3,
@@ -123,7 +126,7 @@ def get_forecast(
     return f"Weather forecast for {location}:\n" + "\n".join(forecast)
 
 
-@ai_function(approval_mode="always_require")
+@tool(approval_mode="always_require")
 def send_email(
     recipient: Annotated[str, "The email address of the recipient."],
     subject: Annotated[str, "The subject of the email."],