Agent Development

Build AI agents using the Spoon AI ReAct framework.

Agent Hierarchy

SpoonReactSkill  → Skills + x402 Payments
    ↓
SpoonReactMCP   → MCP Tool Integration
    ↓
SpoonReactAI    → Base ReAct + Tool Calling
    ↓
ToolCallAgent   → Tool Execution
    ↓
BaseAgent       → Pydantic Foundation

Quick Start

from spoon_ai.agents import SpoonReactMCP
from spoon_ai.chat import ChatBot
from spoon_ai.tools import ToolManager
from spoon_ai.tools.mcp_tool import MCPTool

# Create agent with MCP tool
agent = SpoonReactMCP(
    name="my_agent",
    llm=ChatBot(model_name="gpt-4o"),
    tools=ToolManager([MCPTool(...)]),
    max_steps=15
)

await agent.initialize()
result = await agent.run("Your query here")

Scripts

References

Configuration

Best Practices

1. Pre-load MCP tool parameters before use
2. Use concurrent execution for independent tools
3. Implement retry with exponential backoff
4. Keep system prompts focused and specific
5. Never hardcode API keys