Skip to main content

Debug mode

See what your agent is doing internally.

Enable debug​

from pure_agents import Agent, tool

@tool
def calculate(expression: str) -> str:
    """Calculate a mathematical expression."""
    return str(eval(expression))

agent = Agent(tools=[calculate], debug=True)
result = await agent.run("What is 25 * 4?")

Output:

[Step 1/10]
[Call] calculate({'expression': '25 * 4'})
[Result] 100
[Step 2/10]
[Final] The answer is 100.

What debug shows​

OutputMeaning
[Step N/M]Current step in the ReAct loop
[Call] tool(args)Tool being called with arguments
[Result] ...Tool return value
[Final] ...Final response (non-streaming)

Debug with streaming​

Works with streaming too:

agent = Agent(tools=[calculate], debug=True)

async for chunk in agent.stream("Calculate 100 / 4"):
    print(chunk, end="", flush=True)

Max steps​

The agent stops after max_steps to prevent infinite loops:

agent = Agent(max_steps=5, debug=True)

If the agent reaches max steps:

[Step 5/5]
...
Max steps reached without final answer.

Inspecting messages​

Access the conversation history directly:

agent = Agent()
await agent.run("Hello")

for msg in agent.messages:
    print(f"{msg.role}: {msg.content}")
    if msg.tool_calls:
        print(f"  Tool calls: {msg.tool_calls}")