Documentation Index Fetch the complete documentation index at: https://docs.praison.ai/llms.txt
Use this file to discover all available pages before exploring further.
FailoverManager
Defined in the failover
Rust AI Agent SDK
Manages failover between multiple LLM auth profiles. Provides automatic failover when rate limits or errors occur, with configurable retry behavior and cooldown periods.
Fields Name Type Description configFailoverConfigFailover configuration profilesVec<AuthProfile>Registered profiles current_indexusizeCurrent profile index callbacksVec<FailoverCallback>Failover callbacks
Methods newfn new ( config : FailoverConfig ) -> Self
Create a new failover manager.
Parameters: Name Type configFailoverConfig
default_configfn default_config () -> Self
Create with default config.
add_profilefn add_profile ( &mut self , profile : AuthProfile ) -> ()
Add an auth profile.
Parameters: Name Type profileAuthProfile
remove_profilefn remove_profile ( &mut self , name : & str ) -> bool
Remove a profile by name.
Parameters: get_profilefn get_profile ( & self , name : & str ) -> Option < & AuthProfile >
Get a profile by name.
Parameters: get_profile_mutfn get_profile_mut ( &mut self , name : & str ) -> Option < &mut AuthProfile >
Get a mutable profile by name.
Parameters: list_profilesfn list_profiles ( & self ) -> & [ AuthProfile ]
List all profiles.
get_next_profilefn get_next_profile ( &mut self ) -> Option < & AuthProfile >
Get the next available profile. Returns profiles in priority order, skipping those that are rate limited or in cooldown.
mark_failurefn mark_failure ( &mut self , profile_name : & str , error : & str , is_rate_limit : bool ) -> ()
Mark a profile as failed.
Parameters: Name Type profile_name&strerror&stris_rate_limitbool
mark_successfn mark_success ( &mut self , profile_name : & str ) -> ()
Mark a profile as successful.
Parameters: on_failoverfn on_failover ( &mut self , callback : FailoverCallback ) -> ()
Register a callback for failover events.
Parameters: Name Type callbackFailoverCallback
get_retry_delayfn get_retry_delay ( & self , attempt : u32 ) -> Duration
Calculate retry delay for an attempt.
Parameters: statusfn status ( & self ) -> FailoverStatus
Get failover manager status.
reset_allfn reset_all ( &mut self ) -> ()
Reset all profiles to available status.
lenGet the number of profiles.
is_emptyfn is_empty ( & self ) -> bool
Check if empty.
Source
View on GitHub praisonai/src/failover/mod.rs at line 292
