Struct AgentCall 

pub struct AgentCall<O> {
    pub input: AgentInput,
    pub options: O,
    pub cancellation: CancellationToken,
    pub timeout: Option<Timeout>,
    pub hooks: Hooks,
    pub sandbox: Option<Arc<dyn Sandbox>>,
}

Parameters of one agent call.

Fields

input: AgentInput

The input.

options: O

Per-call options.

cancellation: CancellationToken

Cancels the call.

timeout: Option<Timeout>

Overrides the agent’s timeouts when set.

hooks: Hooks

Hooks invoked after the agent’s own hooks, then awaited concurrently.

sandbox: Option<Arc<dyn Sandbox>>

Sandbox passed to tools.

Implementations

impl AgentCall<()>

pub fn new(input: impl Into<AgentInput>) -> Self

A call without options.

pub fn prompt(text: impl Into<String>) -> Self

A call with a single user prompt.

pub fn messages(messages: impl IntoIterator<Item = Message>) -> Self

A call with a conversation.

impl<O> AgentCall<O>

pub fn options<P>(self, options: P) -> AgentCall<P>

Sets the per-call options.

pub fn cancellation(self, token: CancellationToken) -> Self

Sets the cancellation token.

pub fn timeout(self, timeout: impl Into<Timeout>) -> Self

Overrides the agent’s timeouts.

pub fn hooks(self, hooks: Hooks) -> Self

Adds hooks (invoked after the agent’s hooks, awaited concurrently).

pub fn on_step_end(self, f: impl HookFn<StepResult>) -> Self

Adds a step-end hook.

pub fn on_end(self, f: impl HookFn<EndEvent>) -> Self

Adds an end hook.

pub fn sandbox(self, sandbox: Arc<dyn Sandbox>) -> Self

Sets the sandbox passed to tools.

pub fn streaming(self) -> AgentStreamCall<O>

Converts into a streaming call.

Trait Implementations

impl<O: Debug> Debug for AgentCall<O>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<O> From<AgentCall<O>> for AgentStreamCall<O>

fn from(call: AgentCall<O>) -> Self

Converts to this type from the input type.