agentic.ModelRequest

Page status: scaffold Source state: generated Applies to: Shepherd v1.0-dev Owner: @docs-system-owner (TBD) Validation: scripts/gen_shepherd_api_inventory.py --check

This is reference — exact, generated facts. The mental model lives in concepts; recipes live in guides.

Pre-rename surface

Generated from the internal agentic facade; names and paths change at the Shepherd rename.

class

ModelRequest dataclass

Provider request payload (embedded in EffectDeclaration).

messages instance-attribute

messages: tuple[ProviderMessage, ...]

settings instance-attribute

settings: ProviderSettings

tools instance-attribute

tools: tuple[ToolSpec, ...]

__init__

__init__(
    messages: tuple[ProviderMessage, ...],
    tools: tuple[ToolSpec, ...],
    settings: ProviderSettings,
) -> None