agentle.agents.agent_run_output

Module for representing and managing agent execution results.

This module provides the AgentRunOutput class which encapsulates all data produced during an agent’s execution cycle. It represents both the final response and metadata about the execution process, including conversation steps and structured outputs.

Example: ```python from agentle.agents.agent import Agent from agentle.generations.providers.google.google_generation_provider import GoogleGenerationProvider

# Create and run an agent agent = Agent(

generation_provider=GoogleGenerationProvider(), model=”gemini-2.0-flash”, instructions=”You are a helpful assistant.”

)

# The result is an AgentRunOutput object result = agent.run(“What is the capital of France?”)

# Access different aspects of the result text_response = result.generation.text conversation_steps = result.steps structured_data = result.parsed # If using a response_schema ```

Functions

Field()

!!! abstract "Usage Documentation"

Classes

AgentRunOutput(*[, generation, ...])

Represents the complete result of an agent execution.

BaseModel()

Alias for pydantic.BaseModel.

Context(*[, context_id, message_history, ...])

Container for contextual information that guides an agent's behavior.

Generation(*, id, object, created, model, ...)

Primary container for AI-generated content with metadata.

Sequence()

All the operations on a read-only sequence.

ToolExecutionResult(*[, type, ...])

Represents the result of a tool execution within a step.