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/agents/anthropic/anthropic_basic.py

@@ -5,6 +5,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework.anthropic import AnthropicClient
+from agent_framework import tool
 
 """
 Anthropic Chat Agent Example
@@ -12,7 +13,8 @@ Anthropic Chat Agent Example
 This sample demonstrates using Anthropic with an agent and a single custom tool.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_ai/azure_ai_basic.py

@@ -7,6 +7,7 @@ from typing import Annotated
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure AI Agent Basic Example
@@ -15,7 +16,8 @@ This sample demonstrates basic usage of AzureAIProjectAgentProvider.
 Shows both streaming and non-streaming responses with function tools.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_ai/azure_ai_provider_methods.py

@@ -10,6 +10,7 @@ from azure.ai.projects.aio import AIProjectClient
 from azure.ai.projects.models import AgentReference, PromptAgentDefinition
 from azure.identity.aio import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure AI Project Agent Provider Methods Example
@@ -25,7 +26,8 @@ with different configurations, which is efficient for multi-agent scenarios.
 Each method returns a ChatAgent that can be used for conversations.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_ai/azure_ai_use_latest_version.py

@@ -7,6 +7,7 @@ from typing import Annotated
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure AI Agent Latest Version Example
@@ -16,7 +17,8 @@ instead of creating a new agent version on each instantiation. The first call cr
 while subsequent calls with `get_agent()` reuse the latest agent version.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_ai/azure_ai_with_code_interpreter_file_download.py

@@ -11,6 +11,7 @@ from agent_framework import (
     HostedCodeInterpreterTool,
     HostedFileContent,
     TextContent,
+    tool,
 )
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential

python/samples/getting_started/agents/azure_ai/azure_ai_with_code_interpreter_file_generation.py

@@ -5,6 +5,7 @@ import asyncio
 from agent_framework import (
     AgentResponseUpdate,
     HostedCodeInterpreterTool,
+    tool,
 )
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential

python/samples/getting_started/agents/azure_ai/azure_ai_with_existing_conversation.py

@@ -8,6 +8,7 @@ from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.ai.projects.aio import AIProjectClient
 from azure.identity.aio import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure AI Agent Existing Conversation Example
@@ -15,7 +16,8 @@ Azure AI Agent Existing Conversation Example
 This sample demonstrates usage of AzureAIProjectAgentProvider with existing conversation created on service side.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_ai/azure_ai_with_explicit_settings.py

@@ -8,6 +8,7 @@ from typing import Annotated
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure AI Agent with Explicit Settings Example
@@ -16,7 +17,8 @@ This sample demonstrates creating Azure AI Agents with explicit configuration
 settings rather than relying on environment variable defaults.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_ai/azure_ai_with_thread.py

@@ -7,6 +7,7 @@ from typing import Annotated
 from agent_framework.azure import AzureAIProjectAgentProvider
 from azure.identity.aio import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure AI Agent with Thread Management Example
@@ -15,7 +16,8 @@ This sample demonstrates thread management with Azure AI Agent, showing
 persistent conversation capabilities using service-managed threads as well as storing messages in-memory.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_ai_agent/azure_ai_basic.py

@@ -7,6 +7,7 @@ from typing import Annotated
 from agent_framework.azure import AzureAIAgentsProvider
 from azure.identity.aio import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure AI Agent Basic Example
@@ -15,7 +16,8 @@ This sample demonstrates basic usage of AzureAIAgentsProvider to create agents w
 lifecycle management. Shows both streaming and non-streaming responses with function tools.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_ai_agent/azure_ai_provider_methods.py

@@ -9,6 +9,7 @@ from agent_framework.azure import AzureAIAgentsProvider
 from azure.ai.agents.aio import AgentsClient
 from azure.identity.aio import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure AI Agent Provider Methods Example
@@ -19,7 +20,8 @@ This sample demonstrates the methods available on the AzureAIAgentsProvider clas
 - as_agent(): Wrap an SDK Agent object without making HTTP calls
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_ai_agent/azure_ai_with_code_interpreter_file_generation.py

@@ -7,6 +7,7 @@ from agent_framework import (
     AgentResponseUpdate,
     HostedCodeInterpreterTool,
     HostedFileContent,
+    tool,
 )
 from agent_framework.azure import AzureAIAgentsProvider
 from azure.ai.agents.aio import AgentsClient

python/samples/getting_started/agents/azure_ai_agent/azure_ai_with_existing_thread.py

@@ -9,6 +9,7 @@ from agent_framework.azure import AzureAIAgentsProvider
 from azure.ai.agents.aio import AgentsClient
 from azure.identity.aio import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure AI Agent with Existing Thread Example
@@ -17,7 +18,8 @@ This sample demonstrates working with pre-existing conversation threads
 by providing thread IDs for thread reuse patterns.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_ai_agent/azure_ai_with_explicit_settings.py

@@ -8,6 +8,7 @@ from typing import Annotated
 from agent_framework.azure import AzureAIAgentsProvider
 from azure.identity.aio import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure AI Agent with Explicit Settings Example
@@ -16,7 +17,8 @@ This sample demonstrates creating Azure AI Agents with explicit configuration
 settings rather than relying on environment variable defaults.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_ai_agent/azure_ai_with_function_tools.py

@@ -8,6 +8,7 @@ from typing import Annotated
 from agent_framework.azure import AzureAIAgentsProvider
 from azure.identity.aio import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure AI Agent with Function Tools Example
@@ -16,7 +17,8 @@ This sample demonstrates function tool integration with Azure AI Agents,
 showing both agent-level and query-level tool configuration patterns.
 """
 
-
+# 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:
@@ -24,7 +26,7 @@ def get_weather(
     conditions = ["sunny", "cloudy", "rainy", "stormy"]
     return f"The weather in {location} is {conditions[randint(0, 3)]} with a high of {randint(10, 30)}°C."
 
-
+@tool(approval_mode="never_require")
 def get_time() -> str:
     """Get the current UTC time."""
     current_time = datetime.now(timezone.utc)

python/samples/getting_started/agents/azure_ai_agent/azure_ai_with_multiple_tools.py

@@ -9,6 +9,7 @@ from agent_framework import (
     AgentThread,
     HostedMCPTool,
     HostedWebSearchTool,
+    tool,
 )
 from agent_framework.azure import AzureAIAgentsProvider
 from azure.identity.aio import AzureCliCredential
@@ -33,6 +34,8 @@ To set up Bing Grounding:
 4. Copy the connection ID and set it as the BING_CONNECTION_ID environment variable
 """
 
+# 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_time() -> str:
     """Get the current UTC time."""

python/samples/getting_started/agents/azure_ai_agent/azure_ai_with_thread.py

@@ -5,6 +5,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework import AgentThread
+from agent_framework import tool
 from agent_framework.azure import AzureAIAgentsProvider
 from azure.identity.aio import AzureCliCredential
 from pydantic import Field
@@ -16,7 +17,8 @@ This sample demonstrates thread management with Azure AI Agents, comparing
 automatic thread creation with explicit thread management for persistent 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, Field(description="The location to get the weather for.")],
 ) -> str:

python/samples/getting_started/agents/azure_openai/azure_assistants_basic.py

@@ -7,6 +7,7 @@ from typing import Annotated
 from agent_framework.azure import AzureOpenAIAssistantsClient
 from azure.identity import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure OpenAI Assistants Basic Example
@@ -15,7 +16,8 @@ This sample demonstrates basic usage of AzureOpenAIAssistantsClient with automat
 assistant lifecycle management, showing both streaming and non-streaming responses.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_openai/azure_assistants_with_existing_assistant.py

@@ -6,6 +6,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework import ChatAgent
+from agent_framework import tool
 from agent_framework.azure import AzureOpenAIAssistantsClient
 from azure.identity import AzureCliCredential, get_bearer_token_provider
 from openai import AsyncAzureOpenAI
@@ -18,7 +19,8 @@ This sample demonstrates working with pre-existing Azure OpenAI Assistants
 using existing assistant IDs rather than creating new ones.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_openai/azure_assistants_with_explicit_settings.py

@@ -8,6 +8,7 @@ from typing import Annotated
 from agent_framework.azure import AzureOpenAIAssistantsClient
 from azure.identity import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure OpenAI Assistants with Explicit Settings Example
@@ -16,7 +17,8 @@ This sample demonstrates creating Azure OpenAI Assistants with explicit configur
 settings rather than relying on environment variable defaults.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_openai/azure_assistants_with_function_tools.py

@@ -6,6 +6,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework import ChatAgent
+from agent_framework import tool
 from agent_framework.azure import AzureOpenAIAssistantsClient
 from azure.identity import AzureCliCredential
 from pydantic import Field
@@ -17,7 +18,8 @@ This sample demonstrates function tool integration with Azure OpenAI Assistants,
 showing both agent-level and query-level tool configuration patterns.
 """
 
-
+# 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:
@@ -25,7 +27,7 @@ def get_weather(
     conditions = ["sunny", "cloudy", "rainy", "stormy"]
     return f"The weather in {location} is {conditions[randint(0, 3)]} with a high of {randint(10, 30)}°C."
 
-
+@tool(approval_mode="never_require")
 def get_time() -> str:
     """Get the current UTC time."""
     current_time = datetime.now(timezone.utc)

python/samples/getting_started/agents/azure_openai/azure_assistants_with_thread.py

@@ -5,6 +5,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework import AgentThread, ChatAgent
+from agent_framework import tool
 from agent_framework.azure import AzureOpenAIAssistantsClient
 from azure.identity import AzureCliCredential
 from pydantic import Field
@@ -16,7 +17,8 @@ This sample demonstrates thread management with Azure OpenAI Assistants, compari
 automatic thread creation with explicit thread management for persistent 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, Field(description="The location to get the weather for.")],
 ) -> str:

python/samples/getting_started/agents/azure_openai/azure_chat_client_basic.py

@@ -7,6 +7,7 @@ from typing import Annotated
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure OpenAI Chat Client Basic Example
@@ -15,7 +16,8 @@ This sample demonstrates basic usage of AzureOpenAIChatClient for direct chat-ba
 interactions, showing both streaming and non-streaming responses.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_openai/azure_chat_client_with_explicit_settings.py

@@ -8,6 +8,7 @@ from typing import Annotated
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure OpenAI Chat Client with Explicit Settings Example
@@ -16,7 +17,8 @@ This sample demonstrates creating Azure OpenAI Chat Client with explicit configu
 settings rather than relying on environment variable defaults.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_openai/azure_chat_client_with_function_tools.py

@@ -6,6 +6,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework import ChatAgent
+from agent_framework import tool
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential
 from pydantic import Field
@@ -17,7 +18,8 @@ This sample demonstrates function tool integration with Azure OpenAI Chat Client
 showing both agent-level and query-level tool configuration patterns.
 """
 
-
+# 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:
@@ -25,7 +27,7 @@ def get_weather(
     conditions = ["sunny", "cloudy", "rainy", "stormy"]
     return f"The weather in {location} is {conditions[randint(0, 3)]} with a high of {randint(10, 30)}°C."
 
-
+@tool(approval_mode="never_require")
 def get_time() -> str:
     """Get the current UTC time."""
     current_time = datetime.now(timezone.utc)

python/samples/getting_started/agents/azure_openai/azure_chat_client_with_thread.py

@@ -5,6 +5,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework import AgentThread, ChatAgent, ChatMessageStore
+from agent_framework import tool
 from agent_framework.azure import AzureOpenAIChatClient
 from azure.identity import AzureCliCredential
 from pydantic import Field
@@ -16,7 +17,8 @@ This sample demonstrates thread management with Azure OpenAI Chat Client, compar
 automatic thread creation with explicit thread management for persistent 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, Field(description="The location to get the weather for.")],
 ) -> str:

python/samples/getting_started/agents/azure_openai/azure_responses_client_basic.py

@@ -7,6 +7,7 @@ from typing import Annotated
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure OpenAI Responses Client Basic Example
@@ -15,7 +16,8 @@ This sample demonstrates basic usage of AzureOpenAIResponsesClient for structure
 response generation, showing both streaming and non-streaming responses.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_openai/azure_responses_client_with_explicit_settings.py

@@ -8,6 +8,7 @@ from typing import Annotated
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
 from pydantic import Field
+from agent_framework import tool
 
 """
 Azure OpenAI Responses Client with Explicit Settings Example
@@ -16,7 +17,8 @@ This sample demonstrates creating Azure OpenAI Responses Client with explicit co
 settings rather than relying on environment variable defaults.
 """
 
-
+# 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:

python/samples/getting_started/agents/azure_openai/azure_responses_client_with_function_tools.py

@@ -6,6 +6,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework import ChatAgent
+from agent_framework import tool
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
 from pydantic import Field
@@ -17,7 +18,8 @@ This sample demonstrates function tool integration with Azure OpenAI Responses C
 showing both agent-level and query-level tool configuration patterns.
 """
 
-
+# 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:
@@ -25,7 +27,7 @@ def get_weather(
     conditions = ["sunny", "cloudy", "rainy", "stormy"]
     return f"The weather in {location} is {conditions[randint(0, 3)]} with a high of {randint(10, 30)}°C."
 
-
+@tool(approval_mode="never_require")
 def get_time() -> str:
     """Get the current UTC time."""
     current_time = datetime.now(timezone.utc)

python/samples/getting_started/agents/azure_openai/azure_responses_client_with_thread.py

@@ -5,6 +5,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework import AgentThread, ChatAgent
+from agent_framework import tool
 from agent_framework.azure import AzureOpenAIResponsesClient
 from azure.identity import AzureCliCredential
 from pydantic import Field
@@ -16,7 +17,8 @@ This sample demonstrates thread management with Azure OpenAI Responses Client, c
 automatic thread creation with explicit thread management for persistent 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, Field(description="The location to get the weather for.")],
 ) -> str:

python/samples/getting_started/agents/custom/custom_agent.py

@@ -12,6 +12,7 @@ from agent_framework import (
     ChatMessage,
     Role,
     TextContent,
+    tool,
 )
 
 """

python/samples/getting_started/agents/custom/custom_chat_client.py

@@ -15,6 +15,7 @@ from agent_framework import (
     TextContent,
     use_chat_middleware,
     use_function_invocation,
+    tool,
 )
 from agent_framework._clients import TOptions_co
 

python/samples/getting_started/agents/github_copilot/github_copilot_basic.py

@@ -19,8 +19,10 @@ from typing import Annotated
 
 from agent_framework.github import GithubCopilotAgent, GithubCopilotOptions
 from pydantic import Field
+from agent_framework import tool
 
-
+# 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:

python/samples/getting_started/agents/github_copilot/github_copilot_with_session.py

@@ -14,8 +14,10 @@ from typing import Annotated
 
 from agent_framework.github import GithubCopilotAgent, GithubCopilotOptions
 from pydantic import Field
+from agent_framework import tool
 
-
+# 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:

python/samples/getting_started/agents/ollama/ollama_agent_basic.py

@@ -4,6 +4,7 @@ import asyncio
 from datetime import datetime
 
 from agent_framework.ollama import OllamaChatClient
+from agent_framework import tool
 
 """
 Ollama Agent Basic Example
@@ -17,7 +18,8 @@ https://ollama.com/
 
 """
 
-
+# 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_time(location: str) -> str:
     """Get the current time."""
     return f"The current time in {location} is {datetime.now().strftime('%I:%M %p')}."

python/samples/getting_started/agents/ollama/ollama_chat_client.py

@@ -4,6 +4,7 @@ import asyncio
 from datetime import datetime
 
 from agent_framework.ollama import OllamaChatClient
+from agent_framework import tool
 
 """
 Ollama Chat Client Example
@@ -17,7 +18,8 @@ https://ollama.com/
 
 """
 
-
+# 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_time():
     """Get the current time."""
     return f"The current time is {datetime.now().strftime('%I:%M %p')}."

python/samples/getting_started/agents/ollama/ollama_with_openai_chat_client.py

@@ -6,6 +6,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework.openai import OpenAIChatClient
+from agent_framework import tool
 
 """
 Ollama with OpenAI Chat Client Example
@@ -19,7 +20,8 @@ Environment Variables:
 - OLLAMA_MODEL: The model name to use (e.g., "mistral", "llama3.2", "phi3")
 """
 
-
+# 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:

python/samples/getting_started/agents/openai/openai_assistants_basic.py

@@ -8,6 +8,7 @@ from typing import Annotated
 from agent_framework.openai import OpenAIAssistantProvider
 from openai import AsyncOpenAI
 from pydantic import Field
+from agent_framework import tool
 
 """
 OpenAI Assistants Basic Example
@@ -16,7 +17,8 @@ This sample demonstrates basic usage of OpenAIAssistantProvider with automatic
 assistant lifecycle management, showing both streaming and non-streaming responses.
 """
 
-
+# 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:

python/samples/getting_started/agents/openai/openai_assistants_provider_methods.py

@@ -8,6 +8,7 @@ from typing import Annotated
 from agent_framework.openai import OpenAIAssistantProvider
 from openai import AsyncOpenAI
 from pydantic import Field
+from agent_framework import tool
 
 """
 OpenAI Assistant Provider Methods Example
@@ -18,7 +19,8 @@ This sample demonstrates the methods available on the OpenAIAssistantProvider cl
 - as_agent(): Wrap an SDK Assistant object without making HTTP calls
 """
 
-
+# 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:

python/samples/getting_started/agents/openai/openai_assistants_with_existing_assistant.py

@@ -8,6 +8,7 @@ from typing import Annotated
 from agent_framework.openai import OpenAIAssistantProvider
 from openai import AsyncOpenAI
 from pydantic import Field
+from agent_framework import tool
 
 """
 OpenAI Assistants with Existing Assistant Example
@@ -16,7 +17,8 @@ This sample demonstrates working with pre-existing OpenAI Assistants
 using the provider's get_agent() and as_agent() methods.
 """
 
-
+# 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:

python/samples/getting_started/agents/openai/openai_assistants_with_explicit_settings.py

@@ -8,6 +8,7 @@ from typing import Annotated
 from agent_framework.openai import OpenAIAssistantProvider
 from openai import AsyncOpenAI
 from pydantic import Field
+from agent_framework import tool
 
 """
 OpenAI Assistants with Explicit Settings Example
@@ -16,7 +17,8 @@ This sample demonstrates creating OpenAI Assistants with explicit configuration
 settings rather than relying on environment variable defaults.
 """
 
-
+# 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:

python/samples/getting_started/agents/openai/openai_assistants_with_function_tools.py

@@ -9,6 +9,7 @@ from typing import Annotated
 from agent_framework.openai import OpenAIAssistantProvider
 from openai import AsyncOpenAI
 from pydantic import Field
+from agent_framework import tool
 
 """
 OpenAI Assistants with Function Tools Example
@@ -17,7 +18,8 @@ This sample demonstrates function tool integration with OpenAI Assistants,
 showing both agent-level and query-level tool configuration patterns.
 """
 
-
+# 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:
@@ -25,7 +27,7 @@ def get_weather(
     conditions = ["sunny", "cloudy", "rainy", "stormy"]
     return f"The weather in {location} is {conditions[randint(0, 3)]} with a high of {randint(10, 30)}C."
 
-
+@tool(approval_mode="never_require")
 def get_time() -> str:
     """Get the current UTC time."""
     current_time = datetime.now(timezone.utc)

python/samples/getting_started/agents/openai/openai_assistants_with_thread.py

@@ -6,6 +6,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework import AgentThread
+from agent_framework import tool
 from agent_framework.openai import OpenAIAssistantProvider
 from openai import AsyncOpenAI
 from pydantic import Field
@@ -17,7 +18,8 @@ This sample demonstrates thread management with OpenAI Assistants, showing
 persistent conversation threads and context preservation across interactions.
 """
 
-
+# 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:

python/samples/getting_started/agents/openai/openai_chat_client_basic.py

@@ -5,6 +5,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework.openai import OpenAIChatClient
+from agent_framework import tool
 
 """
 OpenAI Chat Client Basic Example
@@ -13,7 +14,8 @@ This sample demonstrates basic usage of OpenAIChatClient for direct chat-based
 interactions, showing both streaming and non-streaming responses.
 """
 
-
+# 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:

python/samples/getting_started/agents/openai/openai_chat_client_with_explicit_settings.py

@@ -7,6 +7,7 @@ from typing import Annotated
 
 from agent_framework.openai import OpenAIChatClient
 from pydantic import Field
+from agent_framework import tool
 
 """
 OpenAI Chat Client with Explicit Settings Example
@@ -15,7 +16,8 @@ This sample demonstrates creating OpenAI Chat Client with explicit configuration
 settings rather than relying on environment variable defaults.
 """
 
-
+# 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:

python/samples/getting_started/agents/openai/openai_chat_client_with_function_tools.py

@@ -6,6 +6,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework import ChatAgent
+from agent_framework import tool
 from agent_framework.openai import OpenAIChatClient
 from pydantic import Field
 
@@ -16,7 +17,8 @@ This sample demonstrates function tool integration with OpenAI Chat Client,
 showing both agent-level and query-level tool configuration patterns.
 """
 
-
+# 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:
@@ -24,7 +26,7 @@ def get_weather(
     conditions = ["sunny", "cloudy", "rainy", "stormy"]
     return f"The weather in {location} is {conditions[randint(0, 3)]} with a high of {randint(10, 30)}°C."
 
-
+@tool(approval_mode="never_require")
 def get_time() -> str:
     """Get the current UTC time."""
     current_time = datetime.now(timezone.utc)

python/samples/getting_started/agents/openai/openai_chat_client_with_thread.py

@@ -5,6 +5,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework import AgentThread, ChatAgent, ChatMessageStore
+from agent_framework import tool
 from agent_framework.openai import OpenAIChatClient
 from pydantic import Field
 
@@ -15,7 +16,8 @@ This sample demonstrates thread management with OpenAI Chat Client, showing
 conversation threads and message history preservation across interactions.
 """
 
-
+# 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:

python/samples/getting_started/agents/openai/openai_responses_client_basic.py

@@ -5,6 +5,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework import ChatAgent
+from agent_framework import tool
 from agent_framework.openai import OpenAIResponsesClient
 from pydantic import Field
 
@@ -15,7 +16,8 @@ This sample demonstrates basic usage of OpenAIResponsesClient for structured
 response generation, showing both streaming and non-streaming responses.
 """
 
-
+# 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:

python/samples/getting_started/agents/openai/openai_responses_client_with_code_interpreter.py

@@ -8,6 +8,7 @@ from agent_framework import (
     CodeInterpreterToolResultContent,
     HostedCodeInterpreterTool,
     TextContent,
+    tool,
 )
 from agent_framework.openai import OpenAIResponsesClient
 

python/samples/getting_started/agents/openai/openai_responses_client_with_explicit_settings.py

@@ -7,6 +7,7 @@ from typing import Annotated
 
 from agent_framework.openai import OpenAIResponsesClient
 from pydantic import Field
+from agent_framework import tool
 
 """
 OpenAI Responses Client with Explicit Settings Example
@@ -15,7 +16,8 @@ This sample demonstrates creating OpenAI Responses Client with explicit configur
 settings rather than relying on environment variable defaults.
 """
 
-
+# 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:

python/samples/getting_started/agents/openai/openai_responses_client_with_function_tools.py

@@ -6,6 +6,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework import ChatAgent
+from agent_framework import tool
 from agent_framework.openai import OpenAIResponsesClient
 from pydantic import Field
 
@@ -16,7 +17,8 @@ This sample demonstrates function tool integration with OpenAI Responses Client,
 showing both agent-level and query-level tool configuration patterns.
 """
 
-
+# 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:
@@ -24,7 +26,7 @@ def get_weather(
     conditions = ["sunny", "cloudy", "rainy", "stormy"]
     return f"The weather in {location} is {conditions[randint(0, 3)]} with a high of {randint(10, 30)}°C."
 
-
+@tool(approval_mode="never_require")
 def get_time() -> str:
     """Get the current UTC time."""
     current_time = datetime.now(timezone.utc)

python/samples/getting_started/agents/openai/openai_responses_client_with_thread.py

@@ -5,6 +5,7 @@ from random import randint
 from typing import Annotated
 
 from agent_framework import AgentThread, ChatAgent
+from agent_framework import tool
 from agent_framework.openai import OpenAIResponsesClient
 from pydantic import Field
 
@@ -15,7 +16,8 @@ This sample demonstrates thread management with OpenAI Responses Client, showing
 persistent conversation context and simplified response handling.
 """
 
-
+# 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: