Model
Parameters on the base Model class shared by every Agno model provider, including caching and retry behavior.
The Model class is the base class for all models in Agno. It provides common functionality and parameters that are inherited by specific model implementations like OpenAIChat, Claude, etc. Sampling and request parameters (temperature, max_tokens, top_p, seed, request_params, and similar) are defined on the provider classes, not on the base Model.
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
id | str | Required | The id/name of the model to use |
name | Optional[str] | None | The display name of the model |
provider | Optional[str] | None | The provider of the model |
model_type | ModelType | ModelType.MODEL | Functional role of this model, a ModelType value such as MODEL, OUTPUT_MODEL, or PARSER_MODEL. Set by the agent during initialization |
supports_native_structured_outputs | bool | False | True if the model supports structured outputs natively (e.g. OpenAI). Set by the provider class |
supports_json_schema_outputs | bool | False | True if the model requires a JSON schema for structured outputs. Set by the provider class |
system_prompt | Optional[str] | None | System prompt from the model added to the Agent |
instructions | Optional[List[str]] | None | Instructions from the model added to the Agent |
tool_message_role | str | "tool" | Role used for tool messages |
assistant_message_role | str | "assistant" | Role used for assistant messages |
cache_response | bool | False | Enable caching of model responses to avoid redundant API calls |
cache_ttl | Optional[int] | None | Time-to-live for cached model responses, in seconds. If None, cache never expires |
cache_dir | Optional[str] | None | Directory path for storing cached model responses. If None, uses default cache location |
retries | int | 0 | Number of retries to attempt before raising a ModelProviderError |
delay_between_retries | int | 1 | Delay between retries, in seconds |
exponential_backoff | bool | False | If True, the delay between retries is doubled each time |
retry_with_guidance | bool | True | Retry the model invocation with a guidance message for known errors avoidable with extra instructions |
retry_with_guidance_limit | int | 1 | Number of times to retry the model invocation with guidance |