Tools

from gwenflow import Agent, ChatOpenAI, Tool

def get_weather(city: str, unit: str = "celsius") -> str:
    """Return the current weather for a city.

    Args:
        city: Name of the city, in English.
        unit: "celsius" or "fahrenheit".
    """
    return f"Sunny and 22 degrees in {city}"

agent = Agent(
    name="Weather",
    llm=ChatOpenAI(model="gpt-5-mini"),
    tools=[Tool(get_weather)],
)

from pydantic import Field

def search_orders(customer_id: str = Field(description="The customer's id, e.g. C-1042.")) -> str:
    """Search the orders of a customer."""
    ...

from dataclasses import dataclass
from pydantic import Field
from gwenflow import BaseTool

@dataclass(kw_only=True)
class TicketSearch(BaseTool):
    name: str = "search_tickets"
    description: str = "Search the support tickets by keyword."
    base_url: str = "https://support.example.com/api"
    max_results: int = 10

    def _run(self, query: str = Field(description="Keywords to search for.")):
        ...
        return results[: self.max_results]

agent = Agent(name="Support", llm=llm, tools=[TicketSearch(base_url="https://...")])

Tool(send_email, max_retries=1)

agent = Agent(
    name="Analyst",
    llm=llm,
    tools=[GrepTool(base_dir="."), ReadFileTool(base_dir=".")],
    max_tool_output_tokens=2000,
)

from gwenflow.registry import make_tools

tools = make_tools(["wikipedia", "duckduckgo", "website"])