define_agent()

def define_agent(
    *,
    name: str,
    instructions: str | None = None,
    model: str | None = None,
    temperature: float | None = None,
    reasoning_effort: str | None = None,
    tools: list[Any] | None = None,
    builtin_tools: list[str | BuiltinTool] | None = None,
    **kwargs: Any,
) -> Agent

from klisk import define_agent, tool, get_tools

# Basic agent with instructions
agent = define_agent(
    name="Assistant",
    instructions="You are a helpful assistant.",
)

# Agent with custom model and temperature
agent = define_agent(
    name="CreativeWriter",
    instructions="You are a creative writing assistant.",
    model="gpt-4.1",
    temperature=0.9,
)

# Agent with LiteLLM (Anthropic Claude)
agent = define_agent(
    name="ClaudeAgent",
    instructions="You are Claude, an AI assistant.",
    model="anthropic/claude-3-5-sonnet-20240620",
)

# Agent with reasoning effort (o-series model)
agent = define_agent(
    name="Reasoner",
    instructions="You solve complex problems step by step.",
    model="o3-mini",
    reasoning_effort="high",
)

# Agent with custom tools
agent = define_agent(
    name="ToolUser",
    instructions="You can search and greet users.",
    tools=get_tools("search", "greet"),
)

# Agent with builtin tools (OpenAI only)
agent = define_agent(
    name="Researcher",
    instructions="You research topics using web search.",
    model="gpt-4o",
    builtin_tools=["web_search", "code_interpreter"],
)