agents

agents creates a tool-calling agent. The agent can decide when to call the tools that you explicitly provide.

Create an agent

import akasha

agent = akasha.agents(
    model="gemini:gemini-2.5-flash",
    tools=[],
    skills=None,
    stream=False,
)

Common constructor options:

Option	Meaning
tools	A tool or list of tools the agent is allowed to call.
skills	Skill paths or Skill objects that extend the agent.
model	Provider and model alias.
max_round	Maximum agent/tool interaction rounds.
max_past_observation	Maximum prior observations retained for the agent.
stream	Return streaming events instead of one final result.
thinking	Enable supported thinking/reasoning output.
max_resource_bytes	Limit resources read by Skill tooling.

Call an agent

answer = agent("Explain when a tool-calling agent is useful.")
print(answer)

The non-streaming call returns the final answer. The asynchronous equivalent is:

answer = await agent.acall("Run this task asynchronously.")

When stream=True, the call yields event dictionaries. See Streaming events for event handling.

Tool and Skill inputs

Pass only explicit, validated Tools:

def add_numbers(a: int, b: int) -> int:
    """Add two integers."""
    return a + b


tool = akasha.create_tool(
    "Add two integers.",
    add_numbers,
    tool_name="add_numbers",
)
agent = akasha.agents(model="gemini:gemini-2.5-flash", tools=[tool])

Pass Skill directories through skills:

agent = akasha.agents(
    model="gemini:gemini-2.5-flash",
    skills=["./hello-skill"],
)

The directory must contain a SKILL.md. Read Tools and Skills for a complete start-to-finish example.

MCP tools

Discover MCP tools with MultiServerMCPClient, normalize them, and pass the result to tools:

discovered = await client.get_tools()
tools = akasha.normalize_mcp_tools(discovered)
agent = akasha.agents(model="openai:gpt-4o-mini", tools=tools)

See MCP for server startup, transport selection, and security guidance.

Warning

Tools are application capabilities. Validate their inputs and restrict filesystem, network, and credential access.