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/orchestration/concurrent_custom_agent_executors.py

@@ -12,6 +12,7 @@ from agent_framework import (
     Executor,
     WorkflowContext,
     handler,
+    tool,
 )
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential

python/samples/getting_started/workflows/orchestration/concurrent_participant_factory.py

@@ -12,6 +12,7 @@ from agent_framework import (
     Workflow,
     WorkflowContext,
     handler,
+    tool,
 )
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential

python/samples/getting_started/workflows/orchestration/group_chat_agent_manager.py

@@ -9,6 +9,7 @@ from agent_framework import (
     GroupChatBuilder,
     Role,
     WorkflowOutputEvent,
+    tool,
 )
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential

python/samples/getting_started/workflows/orchestration/group_chat_philosophical_debate.py

@@ -11,6 +11,7 @@ from agent_framework import (
     GroupChatBuilder,
     Role,
     WorkflowOutputEvent,
+    tool,
 )
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential

python/samples/getting_started/workflows/orchestration/group_chat_simple_selector.py

@@ -9,6 +9,7 @@ from agent_framework import (
     GroupChatBuilder,
     GroupChatState,
     WorkflowOutputEvent,
+    tool,
 )
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential

python/samples/getting_started/workflows/orchestration/handoff_autonomous.py

@@ -14,6 +14,7 @@ from agent_framework import (
     WorkflowEvent,
     WorkflowOutputEvent,
     resolve_agent_id,
+    tool,
 )
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential

python/samples/getting_started/workflows/orchestration/handoff_participant_factory.py

@@ -18,7 +18,7 @@ from agent_framework import (
     WorkflowOutputEvent,
     WorkflowRunState,
     WorkflowStatusEvent,
-    ai_function,
+    tool,
 )
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential
@@ -47,19 +47,20 @@ Key Concepts:
 """
 
 
-@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 process_refund(order_number: Annotated[str, "Order number to process refund for"]) -> str:
     """Simulated function to process a refund for a given order number."""
     return f"Refund processed successfully for order {order_number}."
 
 
-@ai_function
+@tool(approval_mode="never_require")
 def check_order_status(order_number: Annotated[str, "Order number to check status for"]) -> str:
     """Simulated function to check the status of a given order number."""
     return f"Order {order_number} is currently being processed and will ship in 2 business days."
 
 
-@ai_function
+@tool(approval_mode="never_require")
 def process_return(order_number: Annotated[str, "Order number to process return for"]) -> str:
     """Simulated function to process a return for a given order number."""
     return f"Return initiated successfully for order {order_number}. You will receive return instructions via email."

python/samples/getting_started/workflows/orchestration/handoff_simple.py

@@ -16,7 +16,7 @@ from agent_framework import (
     WorkflowOutputEvent,
     WorkflowRunState,
     WorkflowStatusEvent,
-    ai_function,
+    tool,
 )
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential
@@ -38,19 +38,20 @@ Key Concepts:
 """
 
 
-@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 process_refund(order_number: Annotated[str, "Order number to process refund for"]) -> str:
     """Simulated function to process a refund for a given order number."""
     return f"Refund processed successfully for order {order_number}."
 
 
-@ai_function
+@tool(approval_mode="never_require")
 def check_order_status(order_number: Annotated[str, "Order number to check status for"]) -> str:
     """Simulated function to check the status of a given order number."""
     return f"Order {order_number} is currently being processed and will ship in 2 business days."
 
 
-@ai_function
+@tool(approval_mode="never_require")
 def process_return(order_number: Annotated[str, "Order number to process return for"]) -> str:
     """Simulated function to process a return for a given order number."""
     return f"Return initiated successfully for order {order_number}. You will receive return instructions via email."

python/samples/getting_started/workflows/orchestration/handoff_with_code_interpreter_file.py

@@ -41,6 +41,7 @@ from agent_framework import (
     WorkflowEvent,
     WorkflowRunState,
     WorkflowStatusEvent,
+    tool,
 )
 from azure.identity.aio import AzureCliCredential
 

python/samples/getting_started/workflows/orchestration/magentic.py

@@ -15,6 +15,7 @@ from agent_framework import (
     MagenticOrchestratorEvent,
     MagenticProgressLedger,
     WorkflowOutputEvent,
+    tool,
 )
 from agent_framework.openai import OpenAIChatClient, OpenAIResponsesClient
 

python/samples/getting_started/workflows/orchestration/magentic_checkpoint.py

@@ -16,6 +16,7 @@ from agent_framework import (
     WorkflowOutputEvent,
     WorkflowRunState,
     WorkflowStatusEvent,
+    tool,
 )
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity._credentials import AzureCliCredential

python/samples/getting_started/workflows/orchestration/magentic_human_plan_review.py

@@ -12,6 +12,7 @@ from agent_framework import (
     MagenticPlanReviewRequest,
     RequestInfoEvent,
     WorkflowOutputEvent,
+    tool,
 )
 from agent_framework.openai import OpenAIChatClient
 

python/samples/getting_started/workflows/orchestration/sequential_custom_executors.py

@@ -11,6 +11,7 @@ from agent_framework import (
     SequentialBuilder,
     WorkflowContext,
     handler,
+    tool,
 )
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential

python/samples/getting_started/workflows/orchestration/sequential_participant_factory.py

@@ -11,6 +11,7 @@ from agent_framework import (
     Workflow,
     WorkflowContext,
     handler,
+    tool,
 )
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential