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/workflows/checkpoint/checkpoint_with_human_in_the_loop.py

@@ -26,6 +26,7 @@ from agent_framework import (
     get_checkpoint_summary,
     handler,
     response_handler,
+    tool,
 )
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential

python/samples/getting_started/workflows/checkpoint/checkpoint_with_resume.py

@@ -37,6 +37,7 @@ from agent_framework import (
     WorkflowContext,
     WorkflowOutputEvent,
     handler,
+    tool,
 )
 
 

python/samples/getting_started/workflows/checkpoint/handoff_with_tool_approval_checkpoint_resume.py

@@ -17,7 +17,7 @@ from agent_framework import (
     Workflow,
     WorkflowOutputEvent,
     WorkflowStatusEvent,
-    ai_function,
+    tool,
 )
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential
@@ -51,7 +51,7 @@ CHECKPOINT_DIR = Path(__file__).parent / "tmp" / "handoff_checkpoints"
 CHECKPOINT_DIR.mkdir(parents=True, exist_ok=True)
 
 
-@ai_function(approval_mode="always_require")
+@tool(approval_mode="always_require")
 def submit_refund(refund_description: str, amount: str, order_id: str) -> str:
     """Capture a refund request for manual review before processing."""
     return f"refund recorded for order {order_id} (amount: {amount}) with details: {refund_description}"

python/samples/getting_started/workflows/checkpoint/sub_workflow_checkpoint.py

@@ -24,6 +24,7 @@ from agent_framework import (
     WorkflowStatusEvent,
     handler,
     response_handler,
+    tool,
 )
 
 CHECKPOINT_DIR = Path(__file__).with_suffix("").parent / "tmp" / "sub_workflow_checkpoints"

python/samples/getting_started/workflows/checkpoint/workflow_as_agent_checkpoint.py

@@ -31,6 +31,7 @@ from agent_framework import (
     ChatMessageStore,
     InMemoryCheckpointStorage,
     SequentialBuilder,
+    tool,
 )
 from agent_framework.openai import OpenAIChatClient