AgentResult

Result from agent execution, wrapping pydantic-ai's RunResult.

Quick Example

from mamba_agents import Agent

agent = Agent("gpt-4o")
result = await agent.run("What is 2 + 2?")

# Access output
print(result.output)  # "4"

# Access usage
usage = result.usage()
print(f"Tokens: {usage.total_tokens}")

# Access messages
new_msgs = result.new_messages()
all_msgs = result.all_messages()

Properties and Methods

Member	Type	Description
output	OutputT	The typed output from the agent
data	OutputT	Alias for output
usage()	TokenUsage	Token usage for this run
new_messages()	list	Messages from this run only
all_messages()	list	Complete message history

API Reference

AgentResult dataclass

AgentResult(_result: RunResult[T])

Wrapper for agent run results with additional metadata.

Provides convenient access to the result output, message history, and usage statistics.

ATTRIBUTE	DESCRIPTION
_result	The underlying pydantic-ai RunResult. TYPE: RunResult[T]

output property

output: T

Get the final output from the agent run.

RETURNS	DESCRIPTION
T	The typed output from the agent.

data property

data: T

Alias for output (for backwards compatibility).

RETURNS	DESCRIPTION
T	The typed output from the agent.

usage

usage() -> Usage

Get token usage statistics for this run.

RETURNS	DESCRIPTION
Usage	Usage statistics including input/output tokens.

Source code in src/mamba_agents/agent/result.py

def usage(self) -> Usage:
    """Get token usage statistics for this run.

    Returns:
        Usage statistics including input/output tokens.
    """
    return self._result.usage()

new_messages

new_messages() -> list[Any]

Get new messages generated during this run.

RETURNS	DESCRIPTION
list[Any]	List of messages from this run (for message history).

Source code in src/mamba_agents/agent/result.py

def new_messages(self) -> list[Any]:
    """Get new messages generated during this run.

    Returns:
        List of messages from this run (for message history).
    """
    return self._result.new_messages()

all_messages

all_messages() -> list[Any]

Get all messages including history.

RETURNS	DESCRIPTION
list[Any]	Complete message history including new messages.

Source code in src/mamba_agents/agent/result.py

def all_messages(self) -> list[Any]:
    """Get all messages including history.

    Returns:
        Complete message history including new messages.
    """
    return self._result.all_messages()