enterprise_ai.llm.routing
Source : sdks/python/src/enterprise_ai/llm/routing/__init__.py. Retour à l'index de la référence du SDK Python.
Cette page est générée par tools/docs/gen_sdk_reference.py depuis les sources du SDK et les dossiers de textes OpenAPI. Ne la modifiez pas à la main : changez la source et régénérez.
Classe RoutesClient
LLM et passerelle de modèles. Fournisseurs de modèles, registre des modèles, règles de routage et passerelle de modèles (Model Gateway) : le seul chemin par lequel agents et applications appellent les modèles.
Resource
RoutesClient.create
create(route: dict[str, Any]) -> Any
Créer une règle de routage. Crée une règle de routage du tenant et répond 201. Un principal de plateforme sans tenant répond 403 platform_only ; une stratégie inconnue 422 parameter_invalid. Audité (route.create). Demande tenant_admin, platform_admin ou ai_platform_engineer.
Route : /v1/routes (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
route | dict[str, Any] | oui | Document de route envoyé comme corps de la requête. |
Retour : Any. Réponse JSON décodée de l'opération « Créer une règle de routage ».
Erreurs levées : les erreurs typées du transport (Erreurs).
RoutesClient.delete
delete(route_id: str) -> Any
Supprimer une règle de routage. Supprime une règle de routage du tenant et répond 204. Règle inconnue : 404 route_not_found. Audité (route.delete). Demande tenant_admin, platform_admin ou ai_platform_engineer.
Route : /v1/routes/{rid} (DELETE).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
route_id | str | oui | Identifiant de la règle de routage. |
Retour : Any. Réponse JSON décodée de l'opération « Supprimer une règle de routage ».
Erreurs levées : les erreurs typées du transport (Erreurs).
RoutesClient.list
list(**page: Any) -> Any
Lister les règles de routage. Règles de routage du tenant par priorité puis par nom, chacune avec ses critères, sa stratégie, ses candidats, ses replis, ses contraintes et son target_model (le premier candidat). Demande un rôle de lecteur.
Route : /v1/routes (GET).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
**page | Any | non | Options de pagination : limit (nombre maximal de routes par page) et cursor (curseur de la page à lire). |
Retour : Any. Réponse JSON décodée de l'opération « Lister les règles de routage ».
Erreurs levées : les erreurs typées du transport (Erreurs).
RoutesClient.replace
replace(route_id: str, route: dict[str, Any]) -> Any
Remplacer une règle de routage. Remplace les critères, la stratégie, les candidats, les replis, les contraintes, la priorité et l'indicateur d'activation d'une règle du tenant (les champs omis prennent leur valeur par défaut ; le nom est conservé). Règle inconnue : 404 route_not_found. Audité (route.update). Demande tenant_admin, platform_admin ou ai_platform_engineer.
Route : /v1/routes/{rid} (PUT).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
route_id | str | oui | Identifiant de la règle de routage. | |
route | dict[str, Any] | oui | Document de route complet qui remplace l'actuel. |
Retour : Any. Réponse JSON décodée de l'opération « Remplacer une règle de routage ».
Erreurs levées : les erreurs typées du transport (Erreurs).
RoutesClient.simulate
simulate(model: str | None = None, task: str | None = None, data_classification: str | None = None, **extra: Any) -> Any
Simuler le routage d'une requête. Indique vers quel modèle une requête serait routée, sans l'appeler : la règle donnée par route_id ou la première règle active qui correspond, les listes d'autorisation et d'interdiction du tenant (restreintes par la requête), la classification et la politique de repli. Répond le modèle choisi, les replis, les candidats écartés avec leur raison et la règle utilisée ; aucun modèle éligible répond 422 no_eligible_model. Les modèles restreints ne sont admis que pour tenant_admin et security_officer avec allow_restricted. Demande un rôle de lecteur.
Route : /v1/routes/simulate (POST).
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
model | str | None | None | non | Seulement les grilles dont le motif de modèle correspond à cet identifiant de modèle (motif glob insensible à la casse). |
task | str | None | None | non | Type de tâche de l'appel simulé, utilisé par les règles de routage. |
data_classification | str | None | None | non | Classification des données de l'appel simulé, de public à secret. |
**extra | Any | non | Champs supplémentaires fusionnés dans le corps de la requête. |
Retour : Any. Réponse JSON décodée de l'opération « Simuler le routage d'une requête ».
Erreurs levées : les erreurs typées du transport (Erreurs).
Fonctions
classification_allows
classification_allows(model_max: str, data: str) -> bool
Vrai quand un modèle autorisé jusqu'à model_max peut traiter des données classées data.
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
model_max | str | oui | Classification la plus haute pour laquelle le modèle est autorisé, sur la même échelle. | |
data | str | oui | Classification des données : public, internal, confidential, restricted ou secret. |
Retour : bool. Vrai quand data n'est pas au-dessus de model_max.
eligible_models
eligible_models(models: Iterable[dict[str, Any]], data_classification: str = 'internal', region: str | None = None, capability: str | None = None) -> list[dict[str, Any]]
Filtre localement les entrées du registre : approuvées, autorisées pour les données, dans la région, avec la capacité.
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
models | Iterable[dict[str, Any]] | oui | Entrées du registre ou Model Manifests à filtrer. | |
data_classification | str | 'internal' | non | Classification des données à traiter (internal par défaut), comparée à data_classification_max. |
region | str | None | None | non | Région que le modèle doit servir quand il déclare data_residency.regions ; aucun filtre si elle est omise. |
capability | str | None | None | non | Capacité que le modèle doit lister dans capabilities ; aucun filtre si elle est omise. |
Retour : list[dict[str, Any]]. Entrées dont le statut est approved ou restricted et qui passent tous les filtres, dans l'ordre d'entrée.
fallback_chain
fallback_chain(model: dict[str, Any]) -> list[str]
Identifiant du modèle principal suivi de ses modèles de repli déclarés.
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
model | dict[str, Any] | oui | Entrée du registre ou Model Manifest avec model_id et fallbacks. |
Retour : list[str]. Liste d'identifiants de modèles : le principal d'abord, puis les modèles de repli dans l'ordre.