Skip to main content
Adjusts SDK-wide settings such as cache backend, session timeout, retry policy, and logging. configure() is synchronous and must be called before initialize(). Once the SDK is initialized, re-configuration is rejected to prevent inconsistent runtime state. Any options not supplied keep their existing values.

​
Parameters

​
str
Override the default cache storage path on disk.
​
str | None
Cache backend selection. Pass "sqlite" to enable on-disk caching, or None to disable it.
​
int
Session timeout in minutes. Accepted range is 5-1440.
​
TimeoutConfig | dict
Per-operation timeout overrides. Pass either a TimeoutConfig instance or a plain dict with the fields you want to override.
​
RetryPolicy | dict | None
Retry policy for transient failures. Pass a RetryPolicy, a dict, or None to disable retries entirely.
​
str
Logging verbosity. One of "DEBUG", "INFO", "WARNING", "ERROR".
​
logging.Logger
Custom logger instance to replace the SDK’s internal logger.

​
Returns

Returns None.

​
Example

​
Raises

  • InvalidInputError: when configure() is called after initialize(), or when an option value falls outside its accepted range.
See Error Codes for the full SDK exception hierarchy.

​
See also