LLM Frames

LLM context frame and function calling helper dataclasses

This page documents LLM-specific types that don’t belong on a base-type page: LLMContextFrame (which inherits directly from Frame) and the helper dataclasses used by function calling frames. All other LLM-related frames are documented on their base-type pages. See Related Frames below for links.

LLMContextFrame

Contains a complete LLM context. Acts as a signal to LLM services to ingest the provided context and generate a response.

Inherits directly from Frame (not DataFrame, ControlFrame, or SystemFrame).

context · LLMContext · required

The LLM context containing messages, tools, and configuration.

Function Calling Helper Dataclasses

These are plain dataclasses used as fields within function calling frames, not frames themselves.

FunctionCallFromLLM

Represents a function call returned by the LLM, ready for execution.

function_name · str · required

The name of the function to call.

tool_call_id · str · required

A unique identifier for the function call.

arguments · Mapping[str, Any] · required

The arguments to pass to the function.

context · Any · required

The LLM context at the time the function call was made.

FunctionCallResultProperties

Configures how a function call result is handled after execution.

run_llm · bool | None · default: "None"

Whether to run the LLM after receiving this result.

on_context_updated · Callable[[], Awaitable[None]] | None · default: "None"

Async callback to execute when the context is updated with the result.

is_final · bool · default: "True"

Whether this is the final result for the function call. Set to False to send an intermediate update from an async function call registered with cancel_on_interruption=False.

Related Frames

LLM-related frames organized by base type:

• Data Frames: Context Management, Thinking, Tool Configuration, Function Call Results
• Control Frames: Response Boundaries, Context Summarization, Thought Frames, Function Calling, Service Settings
• System Frames: Function Calling