Struct Agent 

pub struct Agent<M>
where
    M: ModelAdapter,
{ /* private fields */ }

A configured agent ready to start a session.

Build one with Agent::builder, supplying at minimum a ModelAdapter. Then call Agent::start with a SessionConfig to obtain a LoopDriver that drives the agentic loop.

Example

use agentkit_loop::{
    Agent, LoopStep, PromptCacheRequest, PromptCacheRetention, SessionConfig,
};
use agentkit_tools_core::ToolRegistry;

let agent = Agent::builder()
    .model(adapter)
    .tools(ToolRegistry::new())
    .build()?;

let mut driver = agent
    .start(
        SessionConfig::new("s1").with_cache(
            PromptCacheRequest::automatic().with_retention(PromptCacheRetention::Short),
        ),
    )
    .await?;

// Submit input and advance

Implementations

impl<M> Agent<M>

where M: ModelAdapter,

pub fn builder() -> AgentBuilder<M>

Create a new AgentBuilder for configuring this agent.

pub async fn start( self, config: SessionConfig, ) -> Result<LoopDriver<M::Session>, LoopError>

Consume the agent and start a new session, returning a LoopDriver.

This calls ModelAdapter::start_session and emits an AgentEvent::RunStarted event to all registered observers.

Errors

Returns LoopError if the model adapter fails to create a session.