enterprise_ai.client
Source : sdks/python/src/enterprise_ai/client.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 EnterpriseAI
Client synchrone.
_ClientBase
Attributs :
| Nom | Type | Requis | Description |
|---|---|---|---|
a2a | A2AClient | oui | Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox. |
agents | AgentsClient | oui | Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox. |
applications | ApplicationsClient | oui | /v1/applications. |
approvals | ApprovalsClient | oui | Validations. Humain dans la boucle : demandes de validation des actions sensibles, avec séparation des tâches, quorum et expiration. Les exécutions d'agents qui atteignent un outil soumis à validation, les promotions de modèles, d'agents, d'outils, de compétences, de serveurs MCP ou de plugins, les accès d'urgence et les mandats créent tous leurs demandes de validation ici. |
audit | AuditClient | oui | /v1/audit. |
authz | AuthzClient | oui | /v1/authz/check (OpenFGA, vérification de relations) et /v1/policies/evaluate (OPA, décision expliquée). |
break_glass | BreakGlassClient | oui | Délégation, mandats et accès d'urgence. Comment un agent, une application ou un sous-agent agit pour le compte de quelqu'un, et comment des droits exceptionnels sont accordés. |
business_units | BusinessUnitsClient | oui | Tenants et organisation. Les tenants, leur hiérarchie, les projets, les environnements et les membres. |
channels | ChannelsClient | oui | Canaux. Channel Gateway : les points d'entrée où les utilisateurs finaux parlent aux agents (web, mobile, e-mail, Slack, Teams, WhatsApp, SMS, voix, API, et les canaux Navin Discord, Telegram, Matrix, Mattermost et Signal). Un message entrant devient un message de session et lance un run de l'agent du canal, dans des limites de taille, de débit et de sessions et avec DLP. |
compliance | ComplianceClient | oui | Instances de l'agent de conformité et d'audit. Activation et cycle de vie des instances du Navin Enterprise Compliance & Audit Agent (ADR-0177, section 8), copie adaptée du modèle de l'agent RAG. Le Control Plane porte l'enregistrement d'activation de chaque instance (son statut, son secteur et son pack, son modèle de déploiement, ses versions et les ressources qu'elle possède), car dans le modèle dédié le runtime de conformité n'existe pas encore au moment de l'activation. Le runtime de conformité lit son activation avec GET /v1/compliance/instances/{instance_id}. |
config | oui | Paramètres de connexion résolus (ClientConfig) partagés par tous les sous-clients. | |
connectors | ConnectorsClient | oui | Connecteurs. Connector Hub : registre des connexions aux systèmes externes (applications SaaS, API, sources de données), leurs identifiants conservés côté serveur, les exécutions de synchronisation, le Credential Broker qui remet des baux de courte durée à la place des secrets, et la Webhook Gateway qui reçoit les événements signés des fournisseurs. |
context | ContextClient | oui | 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. |
contracts | ContractsClient | oui | Contrats et manifestes. Schémas JSON publiés (contrats) des documents de la plateforme, et manifestes déclaratifs qui créent ou mettent à jour des objets à partir d'un document, dans l'esprit de l'infrastructure as code. |
delegations | DelegationsClient | oui | Délégation, mandats et accès d'urgence. Comment un agent, une application ou un sous-agent agit pour le compte de quelqu'un, et comment des droits exceptionnels sont accordés. |
dlp | DlpClient | oui | Vie privée et protection des données. Services de protection des données du tenant : classification, DLP (prévention des fuites de données), tokenisation et chiffrement par enveloppe. |
encryption | EncryptionClient | oui | Vie privée et protection des données. Services de protection des données du tenant : classification, DLP (prévention des fuites de données), tokenisation et chiffrement par enveloppe. |
evaluation | EvaluationClient | oui | Évaluation et red team. Qualité des systèmes d'IA du tenant : suites d'évaluation, exécutions, barrières de qualité avant promotion, comparaisons A/B avec une référence et campagnes de red team. |
evidence | EvidenceClient | oui | Preuves. Couche de preuve du journal d'audit : sceaux signés, paquets vérifiables hors ligne, moniteur d'intégrité, Audit Gateway, charges utiles chiffrées, accès audités, gels juridiques et preuves de purge, et configuration d'exécution des exécutions d'agents. |
execution_context | ExecutionContextClient | oui | Contexte d'exécution. Context Authority : émet, vérifie et révoque des documents ExecutionContext signés, la preuve qu'un appel est fait par un principal, un run d'agent et une chaîne de délégation donnés, pour une audience donnée et pour peu de temps. |
file_security | FileSecurityClient | oui | Sécurité des fichiers. Contrôles antivirus et de contenu de chaque fichier qui entre dans la plateforme, avant qu'un analyseur, un modèle ou un magasin ne le voie. |
finops | FinopsClient | oui | FinOps. Gestion des coûts de l'usage de l'IA : grilles tarifaires, événements d'usage, estimations, quotas et réservations, répartition du coût des GPU, rapprochement de la facturation et alertes. |
gateway | GatewayClient | oui | 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. |
governance | GovernanceClient | oui | Gouvernance. Registre de gouvernance : une vue agrégée des actifs d'IA du tenant, pour savoir ce qui existe, qui en est responsable et quel est son niveau de risque. |
identity | IdentityClient | oui | /v1/me, /v1/members, /v1/api-keys, /v1/service-identities, /v1/authz, /v1/secrets, /v1/identity/quota-profiles et /v1/identity/group-mappings. |
incidents | IncidentsClient | oui | Incidents. Incidents de sécurité et d'exploitation du tenant : gravité, statut, chronologie, actions de confinement, alertes Alertmanager et transmission au SIEM. |
isolation | IsolationClient | oui | 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. |
license | LicenseClient | oui | Licences. Licence de l'installation : activation d'une licence signée, état courant et historique. |
llm | LlmClient | oui | Point d'entrée unique sur /v1/gateway/chat/completions, /v1/gateway/embeddings et /v1/multimodal/vision ; chaque appel conserve les contrôles de la passerelle (vérification préalable de l'effort, politique, DLP, quotas). |
llm_management | LlmManagementClient | oui | Gestion des LLM. Projets LLM d'un tenant, leur quota et les clés virtuelles LiteLLM que les applications utilisent pour appeler les modèles. |
mandates | MandatesClient | oui | Délégation, mandats et accès d'urgence. Comment un agent, une application ou un sous-agent agit pour le compte de quelqu'un, et comment des droits exceptionnels sont accordés. |
manifests | ManifestsClient | oui | Contrats et manifestes. Schémas JSON publiés (contrats) des documents de la plateforme, et manifestes déclaratifs qui créent ou mettent à jour des objets à partir d'un document, dans l'esprit de l'infrastructure as code. |
marketplace | MarketplaceClient | oui | Marketplace. Catalogue de packs signés (ensembles d'agents, sous-agents, skills, outils, connecteurs, serveurs MCP et ressources), leurs contrôles de publication, le contrôle de mise en production, les éditeurs de confiance, les installations par environnement et le circuit de gestion des changements. |
mcp | McpClient | oui | Passerelle MCP. Registre des serveurs MCP amont (Model Context Protocol) et MCP Gateway, un proxy JSON-RPC 2.0 qui applique les contrôles de la plateforme à chaque appel : isolation par projet, appelants permis, listes d'autorisation d'outils et de ressources, scopes, DLP, politique, quota, contrôle d'injection de prompt, comptage et audit. |
mcp_runtime | McpRuntimeClient | oui | Runtime MCP. MCP Runtime : des instances isolées de serveur MCP démarrées à la demande pour un utilisateur d'un projet, à partir des modèles du catalogue de la plateforme, exécutées par ToolHive dans l'espace de noms du projet et joignables via la MCP Gateway. |
memory | MemoryClient | oui | Mémoire. Memory Manager : éléments de mémoire durables des agents et des utilisateurs, conformes au Memory Contract v1, avec ACL, durée de vie, conservation légale, versionnage et recherche hybride. |
models | ModelsClient | oui | 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. |
multimodal | MultimodalClient | oui | Multimodal. Médias et traitement multimodal : stockage chiffré de médias et travaux de vision, génération et retouche d'images, traitement et génération de vidéos, transcription de la parole, diarisation, synthèse vocale et DLP multimodale. |
navin_library | NavinLibraryClient | oui | Bibliothèque Navin. La bibliothèque Navin est le catalogue embarqué de skills, plugins, commandes, agents, presets MCP et canaux prêts à l'emploi. Un projet active ce dont il a besoin, installe des serveurs MCP et des canaux à partir de presets et garde ses propres règles, les instructions durables que reçoit chaque run du projet. |
organizations | OrganizationsClient | oui | Tenants et organisation. Les tenants, leur hiérarchie, les projets, les environnements et les membres. |
platform_manager | PlatformManagerClient | oui | Platform Manager. Espace Platform Manager de la console : la passerelle du Control Plane vers le Navin Manager, qui installe, connecte et exploite les services de la plateforme sur les machines du client, ainsi que le coffre-fort informatique des administrateurs de la plateforme. |
plugins | PluginsClient | oui | Plugins. Registre et cycle de vie d'exécution des plugins : des images OCI signées exécutées par la plateforme dans une sandbox (classe de runtime gVisor, Kata ou Wasm), avec un Deployment et une NetworkPolicy Kubernetes générés à partir du manifeste. |
policies | PoliciesClient | oui | Politiques. Politiques fondées sur les attributs (ABAC) qui décident de chaque action sensible de la plateforme, avec le Policy Contract v1, le journal des décisions, la simulation, les révisions et les bundles OPA signés. |
privacy | PrivacyClient | oui | /v1/privacy, /v1/retention, /v1/lineage. |
projects | ProjectsClient | oui | Tenants et organisation. Les tenants, leur hiérarchie, les projets, les environnements et les membres. |
prompts | PromptsClient | oui | Prompts. Registre de prompts : modèles de prompt versionnés avec variables typées et rendu validé. |
providers | ProvidersClient | oui | 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. |
quotas | QuotasClient | oui | FinOps. Gestion des coûts de l'usage de l'IA : grilles tarifaires, événements d'usage, estimations, quotas et réservations, répartition du coût des GPU, rapprochement de la facturation et alertes. |
rag | RagClient | oui | Bases de connaissances. Bases de connaissances pour la génération augmentée par récupération (RAG) : les documents sont analysés, extraits, contrôlés pour les données personnelles et l'empoisonnement, découpés, vectorisés via le Model Gateway et recherchés avec des filtres d'ACL et d'habilitation. |
rag_agent | RagAgentClient | oui | Instances de l'agent RAG. Activation et cycle de vie des instances du Navin Enterprise RAG Agent. Le Control Plane porte l'enregistrement d'activation de chaque instance (son statut, son modèle de déploiement, ses versions et les ressources qu'elle possède), car dans le modèle dédié le runtime du RAG n'existe pas encore au moment de l'activation. Le runtime du RAG lit son activation avec GET /v1/rag-agent/instances/{instance_id} et refuse de servir des conversations tant que le statut n'est pas ready ou degraded (instance_not_ready). |
realtime | RealtimeClient | oui | Voix en temps réel. Sessions de voix en temps réel : un jeton de salle LiveKit et un protocole d'événements WebSocket pour diffuser de l'audio vers un agent, avec consentement des participants, tours de parole, transcriptions filtrées par la DLP, enregistrements facultatifs et comptage d'usage. |
risk | RiskClient | oui | Risques et conformité. Gestion des risques des systèmes d'IA du tenant : évaluations au titre de l'AI Act européen, contrôles rattachés à l'ISO/IEC 42001, au NIST AI RMF, au RGPD et à l'AI Act, preuves et dérogations limitées dans le temps. |
routes | RoutesClient | oui | 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. |
runs | RunsClient | oui | Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox. |
sandbox | SandboxClient | oui | Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox. |
schedules | SchedulesClient | oui | Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox. |
security | SecurityClient | oui | /v1/security/posture et /v1/security/settings. |
sessions | SessionsClient | oui | Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox. |
skills | SkillsClient | oui | Skills. Skill Registry et Skill Loader. Un skill est un ensemble d'instructions signé et versionné (en ligne, ou artefact Git ou OCI) avec les permissions dont il a besoin ; les agents chargent les skills accordés dans leur manifeste. |
soc | SocClient | oui | SOC et réponse aux incidents IA. Opérations de sécurité pour l'IA (AI-SDR) : détections, ordres de confinement typés, registre des coupe-circuits (Kill Switch Registry), accusés de confinement, rétablissement à quatre yeux, preuves scellées des incidents et rapprochement des transactions à effet de bord. |
storage | StorageClient | oui | Stockage. Profils de stockage : les buckets et conteneurs du client dans lesquels la plateforme écrit (exports d'audit, preuves, documents, médias, exports, sauvegardes), avec leur référence d'identifiants et leurs capacités découvertes par de vrais appels. |
system | SystemClient | oui | Points d'accès en lecture au niveau de la plateforme (aucune donnée de tenant). |
telemetry | TelemetryClient | oui | Télémétrie. Traces, journal des requêtes, flux en direct et objectifs de niveau de service (SLO) de la plateforme. |
telephony | TelephonyClient | oui | Téléphonie. Téléphonie (ADR-0173) : PBX d'entreprise, bord SIP et agents vocaux IA du tenant. Navin Enterprise garde les données (trunks, extensions, numéros, règles de routage, flux SVI, files, agents humains et IA, conférences, quotas), compile les fichiers gérés d'Asterisk, les tables de routage Kamailio et les objets LiveKit SIP par pool PBX, et les publie vers les moteurs par AMI, JSONRPC et Twirp avec versions et retour arrière ; il n'exécute jamais de commande système. Le Navin Manager installe et exploite les moteurs. |
tenants | TenantsClient | oui | Tenants et organisation. Les tenants, leur hiérarchie, les projets, les environnements et les membres. |
tokenization | TokenizationClient | oui | Vie privée et protection des données. Services de protection des données du tenant : classification, DLP (prévention des fuites de données), tokenisation et chiffrement par enveloppe. |
tools | ToolsClient | oui | /v1/tools : registre et Tool Gateway (portées, politique, DLP, approbation, coût). |
triggers | TriggersClient | oui | Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox. |
Constructeur EnterpriseAI
EnterpriseAI(base_url: str | None = None, http_client: httpx.Client | None = None, transport: httpx.BaseTransport | None = None, **kwargs: Any) -> None
Construit la configuration à partir des arguments et des variables EAI_*, puis branche chaque sous-client sur un SyncTransport.
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
base_url | str | None | None | non | Adresse de l'API ; None reprend EAI_BASE_URL, puis une adresse locale. |
http_client | httpx.Client | None | None | non | httpx.Client existant pour envoyer les requêtes ; par défaut, un client est créé à partir de la configuration. |
transport | httpx.BaseTransport | None | None | non | Transport partagé par les sous-clients d'un même client. |
**kwargs | Any | non | Champs de ClientConfig (api_key, token, tenant, locale, timeout, retries...) ; toute autre clé est passée à httpx.Client. |
EnterpriseAI.close
close() -> None
Ferme le transport et ses connexions HTTP ; également appelée à la fin d'un bloc with.
Cet élément ne prend aucun paramètre.
Retour : None.
Classe AsyncEnterpriseAI
Client asynchrone : chaque méthode des sous-clients renvoie un attendable.
_ClientBase
Attributs :
| Nom | Type | Requis | Description |
|---|---|---|---|
a2a | A2AClient | oui | Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox. |
agents | AgentsClient | oui | Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox. |
applications | ApplicationsClient | oui | /v1/applications. |
approvals | ApprovalsClient | oui | Validations. Humain dans la boucle : demandes de validation des actions sensibles, avec séparation des tâches, quorum et expiration. Les exécutions d'agents qui atteignent un outil soumis à validation, les promotions de modèles, d'agents, d'outils, de compétences, de serveurs MCP ou de plugins, les accès d'urgence et les mandats créent tous leurs demandes de validation ici. |
audit | AuditClient | oui | /v1/audit. |
authz | AuthzClient | oui | /v1/authz/check (OpenFGA, vérification de relations) et /v1/policies/evaluate (OPA, décision expliquée). |
break_glass | BreakGlassClient | oui | Délégation, mandats et accès d'urgence. Comment un agent, une application ou un sous-agent agit pour le compte de quelqu'un, et comment des droits exceptionnels sont accordés. |
business_units | BusinessUnitsClient | oui | Tenants et organisation. Les tenants, leur hiérarchie, les projets, les environnements et les membres. |
channels | ChannelsClient | oui | Canaux. Channel Gateway : les points d'entrée où les utilisateurs finaux parlent aux agents (web, mobile, e-mail, Slack, Teams, WhatsApp, SMS, voix, API, et les canaux Navin Discord, Telegram, Matrix, Mattermost et Signal). Un message entrant devient un message de session et lance un run de l'agent du canal, dans des limites de taille, de débit et de sessions et avec DLP. |
compliance | ComplianceClient | oui | Instances de l'agent de conformité et d'audit. Activation et cycle de vie des instances du Navin Enterprise Compliance & Audit Agent (ADR-0177, section 8), copie adaptée du modèle de l'agent RAG. Le Control Plane porte l'enregistrement d'activation de chaque instance (son statut, son secteur et son pack, son modèle de déploiement, ses versions et les ressources qu'elle possède), car dans le modèle dédié le runtime de conformité n'existe pas encore au moment de l'activation. Le runtime de conformité lit son activation avec GET /v1/compliance/instances/{instance_id}. |
config | oui | Paramètres de connexion résolus (ClientConfig) partagés par tous les sous-clients. | |
connectors | ConnectorsClient | oui | Connecteurs. Connector Hub : registre des connexions aux systèmes externes (applications SaaS, API, sources de données), leurs identifiants conservés côté serveur, les exécutions de synchronisation, le Credential Broker qui remet des baux de courte durée à la place des secrets, et la Webhook Gateway qui reçoit les événements signés des fournisseurs. |
context | ContextClient | oui | 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. |
contracts | ContractsClient | oui | Contrats et manifestes. Schémas JSON publiés (contrats) des documents de la plateforme, et manifestes déclaratifs qui créent ou mettent à jour des objets à partir d'un document, dans l'esprit de l'infrastructure as code. |
delegations | DelegationsClient | oui | Délégation, mandats et accès d'urgence. Comment un agent, une application ou un sous-agent agit pour le compte de quelqu'un, et comment des droits exceptionnels sont accordés. |
dlp | DlpClient | oui | Vie privée et protection des données. Services de protection des données du tenant : classification, DLP (prévention des fuites de données), tokenisation et chiffrement par enveloppe. |
encryption | EncryptionClient | oui | Vie privée et protection des données. Services de protection des données du tenant : classification, DLP (prévention des fuites de données), tokenisation et chiffrement par enveloppe. |
evaluation | EvaluationClient | oui | Évaluation et red team. Qualité des systèmes d'IA du tenant : suites d'évaluation, exécutions, barrières de qualité avant promotion, comparaisons A/B avec une référence et campagnes de red team. |
evidence | EvidenceClient | oui | Preuves. Couche de preuve du journal d'audit : sceaux signés, paquets vérifiables hors ligne, moniteur d'intégrité, Audit Gateway, charges utiles chiffrées, accès audités, gels juridiques et preuves de purge, et configuration d'exécution des exécutions d'agents. |
execution_context | ExecutionContextClient | oui | Contexte d'exécution. Context Authority : émet, vérifie et révoque des documents ExecutionContext signés, la preuve qu'un appel est fait par un principal, un run d'agent et une chaîne de délégation donnés, pour une audience donnée et pour peu de temps. |
file_security | FileSecurityClient | oui | Sécurité des fichiers. Contrôles antivirus et de contenu de chaque fichier qui entre dans la plateforme, avant qu'un analyseur, un modèle ou un magasin ne le voie. |
finops | FinopsClient | oui | FinOps. Gestion des coûts de l'usage de l'IA : grilles tarifaires, événements d'usage, estimations, quotas et réservations, répartition du coût des GPU, rapprochement de la facturation et alertes. |
gateway | AsyncGatewayClient | oui | 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. |
governance | GovernanceClient | oui | Gouvernance. Registre de gouvernance : une vue agrégée des actifs d'IA du tenant, pour savoir ce qui existe, qui en est responsable et quel est son niveau de risque. |
identity | IdentityClient | oui | /v1/me, /v1/members, /v1/api-keys, /v1/service-identities, /v1/authz, /v1/secrets, /v1/identity/quota-profiles et /v1/identity/group-mappings. |
incidents | IncidentsClient | oui | Incidents. Incidents de sécurité et d'exploitation du tenant : gravité, statut, chronologie, actions de confinement, alertes Alertmanager et transmission au SIEM. |
isolation | IsolationClient | oui | 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. |
license | LicenseClient | oui | Licences. Licence de l'installation : activation d'une licence signée, état courant et historique. |
llm | LlmClient | oui | Point d'entrée unique sur /v1/gateway/chat/completions, /v1/gateway/embeddings et /v1/multimodal/vision ; chaque appel conserve les contrôles de la passerelle (vérification préalable de l'effort, politique, DLP, quotas). |
llm_management | LlmManagementClient | oui | Gestion des LLM. Projets LLM d'un tenant, leur quota et les clés virtuelles LiteLLM que les applications utilisent pour appeler les modèles. |
mandates | MandatesClient | oui | Délégation, mandats et accès d'urgence. Comment un agent, une application ou un sous-agent agit pour le compte de quelqu'un, et comment des droits exceptionnels sont accordés. |
manifests | ManifestsClient | oui | Contrats et manifestes. Schémas JSON publiés (contrats) des documents de la plateforme, et manifestes déclaratifs qui créent ou mettent à jour des objets à partir d'un document, dans l'esprit de l'infrastructure as code. |
marketplace | MarketplaceClient | oui | Marketplace. Catalogue de packs signés (ensembles d'agents, sous-agents, skills, outils, connecteurs, serveurs MCP et ressources), leurs contrôles de publication, le contrôle de mise en production, les éditeurs de confiance, les installations par environnement et le circuit de gestion des changements. |
mcp | McpClient | oui | Passerelle MCP. Registre des serveurs MCP amont (Model Context Protocol) et MCP Gateway, un proxy JSON-RPC 2.0 qui applique les contrôles de la plateforme à chaque appel : isolation par projet, appelants permis, listes d'autorisation d'outils et de ressources, scopes, DLP, politique, quota, contrôle d'injection de prompt, comptage et audit. |
mcp_runtime | McpRuntimeClient | oui | Runtime MCP. MCP Runtime : des instances isolées de serveur MCP démarrées à la demande pour un utilisateur d'un projet, à partir des modèles du catalogue de la plateforme, exécutées par ToolHive dans l'espace de noms du projet et joignables via la MCP Gateway. |
memory | MemoryClient | oui | Mémoire. Memory Manager : éléments de mémoire durables des agents et des utilisateurs, conformes au Memory Contract v1, avec ACL, durée de vie, conservation légale, versionnage et recherche hybride. |
models | ModelsClient | oui | 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. |
multimodal | MultimodalClient | oui | Multimodal. Médias et traitement multimodal : stockage chiffré de médias et travaux de vision, génération et retouche d'images, traitement et génération de vidéos, transcription de la parole, diarisation, synthèse vocale et DLP multimodale. |
navin_library | NavinLibraryClient | oui | Bibliothèque Navin. La bibliothèque Navin est le catalogue embarqué de skills, plugins, commandes, agents, presets MCP et canaux prêts à l'emploi. Un projet active ce dont il a besoin, installe des serveurs MCP et des canaux à partir de presets et garde ses propres règles, les instructions durables que reçoit chaque run du projet. |
organizations | OrganizationsClient | oui | Tenants et organisation. Les tenants, leur hiérarchie, les projets, les environnements et les membres. |
platform_manager | PlatformManagerClient | oui | Platform Manager. Espace Platform Manager de la console : la passerelle du Control Plane vers le Navin Manager, qui installe, connecte et exploite les services de la plateforme sur les machines du client, ainsi que le coffre-fort informatique des administrateurs de la plateforme. |
plugins | PluginsClient | oui | Plugins. Registre et cycle de vie d'exécution des plugins : des images OCI signées exécutées par la plateforme dans une sandbox (classe de runtime gVisor, Kata ou Wasm), avec un Deployment et une NetworkPolicy Kubernetes générés à partir du manifeste. |
policies | PoliciesClient | oui | Politiques. Politiques fondées sur les attributs (ABAC) qui décident de chaque action sensible de la plateforme, avec le Policy Contract v1, le journal des décisions, la simulation, les révisions et les bundles OPA signés. |
privacy | PrivacyClient | oui | /v1/privacy, /v1/retention, /v1/lineage. |
projects | ProjectsClient | oui | Tenants et organisation. Les tenants, leur hiérarchie, les projets, les environnements et les membres. |
prompts | PromptsClient | oui | Prompts. Registre de prompts : modèles de prompt versionnés avec variables typées et rendu validé. |
providers | ProvidersClient | oui | 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. |
quotas | QuotasClient | oui | FinOps. Gestion des coûts de l'usage de l'IA : grilles tarifaires, événements d'usage, estimations, quotas et réservations, répartition du coût des GPU, rapprochement de la facturation et alertes. |
rag | RagClient | oui | Bases de connaissances. Bases de connaissances pour la génération augmentée par récupération (RAG) : les documents sont analysés, extraits, contrôlés pour les données personnelles et l'empoisonnement, découpés, vectorisés via le Model Gateway et recherchés avec des filtres d'ACL et d'habilitation. |
rag_agent | RagAgentClient | oui | Instances de l'agent RAG. Activation et cycle de vie des instances du Navin Enterprise RAG Agent. Le Control Plane porte l'enregistrement d'activation de chaque instance (son statut, son modèle de déploiement, ses versions et les ressources qu'elle possède), car dans le modèle dédié le runtime du RAG n'existe pas encore au moment de l'activation. Le runtime du RAG lit son activation avec GET /v1/rag-agent/instances/{instance_id} et refuse de servir des conversations tant que le statut n'est pas ready ou degraded (instance_not_ready). |
realtime | RealtimeClient | oui | Voix en temps réel. Sessions de voix en temps réel : un jeton de salle LiveKit et un protocole d'événements WebSocket pour diffuser de l'audio vers un agent, avec consentement des participants, tours de parole, transcriptions filtrées par la DLP, enregistrements facultatifs et comptage d'usage. |
risk | RiskClient | oui | Risques et conformité. Gestion des risques des systèmes d'IA du tenant : évaluations au titre de l'AI Act européen, contrôles rattachés à l'ISO/IEC 42001, au NIST AI RMF, au RGPD et à l'AI Act, preuves et dérogations limitées dans le temps. |
routes | RoutesClient | oui | 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. |
runs | RunsClient | oui | Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox. |
sandbox | SandboxClient | oui | Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox. |
schedules | SchedulesClient | oui | Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox. |
security | SecurityClient | oui | /v1/security/posture et /v1/security/settings. |
sessions | SessionsClient | oui | Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox. |
skills | SkillsClient | oui | Skills. Skill Registry et Skill Loader. Un skill est un ensemble d'instructions signé et versionné (en ligne, ou artefact Git ou OCI) avec les permissions dont il a besoin ; les agents chargent les skills accordés dans leur manifeste. |
soc | SocClient | oui | SOC et réponse aux incidents IA. Opérations de sécurité pour l'IA (AI-SDR) : détections, ordres de confinement typés, registre des coupe-circuits (Kill Switch Registry), accusés de confinement, rétablissement à quatre yeux, preuves scellées des incidents et rapprochement des transactions à effet de bord. |
storage | StorageClient | oui | Stockage. Profils de stockage : les buckets et conteneurs du client dans lesquels la plateforme écrit (exports d'audit, preuves, documents, médias, exports, sauvegardes), avec leur référence d'identifiants et leurs capacités découvertes par de vrais appels. |
system | SystemClient | oui | Points d'accès en lecture au niveau de la plateforme (aucune donnée de tenant). |
telemetry | TelemetryClient | oui | Télémétrie. Traces, journal des requêtes, flux en direct et objectifs de niveau de service (SLO) de la plateforme. |
telephony | TelephonyClient | oui | Téléphonie. Téléphonie (ADR-0173) : PBX d'entreprise, bord SIP et agents vocaux IA du tenant. Navin Enterprise garde les données (trunks, extensions, numéros, règles de routage, flux SVI, files, agents humains et IA, conférences, quotas), compile les fichiers gérés d'Asterisk, les tables de routage Kamailio et les objets LiveKit SIP par pool PBX, et les publie vers les moteurs par AMI, JSONRPC et Twirp avec versions et retour arrière ; il n'exécute jamais de commande système. Le Navin Manager installe et exploite les moteurs. |
tenants | TenantsClient | oui | Tenants et organisation. Les tenants, leur hiérarchie, les projets, les environnements et les membres. |
tokenization | TokenizationClient | oui | Vie privée et protection des données. Services de protection des données du tenant : classification, DLP (prévention des fuites de données), tokenisation et chiffrement par enveloppe. |
tools | ToolsClient | oui | /v1/tools : registre et Tool Gateway (portées, politique, DLP, approbation, coût). |
triggers | TriggersClient | oui | Agents. Registre des agents du tenant et exécution côté serveur de leurs runs : étapes, budgets, points de reprise, heartbeats, sous-agents, messages d'agent à agent (A2A), sessions de conversation, planifications cron, déclencheurs sur événement et exécutions en sandbox. |
Constructeur AsyncEnterpriseAI
AsyncEnterpriseAI(base_url: str | None = None, http_client: httpx.AsyncClient | None = None, transport: httpx.AsyncBaseTransport | None = None, **kwargs: Any) -> None
Construit la configuration à partir des arguments et des variables EAI_*, puis branche chaque sous-client sur un AsyncTransport.
| Nom | Type | Défaut | Requis | Description |
|---|---|---|---|---|
base_url | str | None | None | non | Adresse de l'API ; None reprend EAI_BASE_URL, puis une adresse locale. |
http_client | httpx.AsyncClient | None | None | non | httpx.AsyncClient existant pour envoyer les requêtes ; par défaut, un client est créé à partir de la configuration. |
transport | httpx.AsyncBaseTransport | None | None | non | Transport partagé par les sous-clients d'un même client. |
**kwargs | Any | non | Champs de ClientConfig (api_key, token, tenant, locale, timeout, retries...) ; toute autre clé est passée à httpx.AsyncClient. |
AsyncEnterpriseAI.close
async close() -> None
Ferme le transport et ses connexions HTTP (une coroutine) ; également appelée par async with.
Cet élément ne prend aucun paramètre.
Retour : None.