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/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."],