Activer AI Gateway
AI Gateway ouvre les modèles de SmartAGT aux outils raccordés, par une API compatible OpenAI. Son service est installé et démarré avec le Backend ; cette procédure l'active en quatre étapes.
- ServiceDémarré avec le Backend
- ActivationURL publique et réseau
- CléDroit et clé d'accès
- TestPremier appel
Prérequis
- Backend installé, service AI Gateway compris : Installer le Backend.
- Modèle de conversation raccordé : Prise en main.
- Nom DNS d'accès des outils raccordés, par exemple
gateway.example.test, résolu vers ce serveur, et port8001ouvert en entrée sur le pare-feu du serveur.
- Backend installé, service AI Gateway créé sur les nœuds du rôle
gateway: Installer le Backend. - Modèle de conversation raccordé : Prise en main.
- Load balancer HTTPS devant ces nœuds, à l'écoute du port
8001sous le nom d'accès des outils raccordés, par exemplegateway.example.test. Il transmet l'adresse du client dansX-Forwarded-For, car la liste Réseau filtre cette adresse. - Port
8001des nœudsgatewayouvert en entrée au seul load balancer.
Procédure
1. Vérifier le service
systemctl is-active SmartAGT-AI-Gateway-Service
Résultat attendu : la commande affiche active.
Get-Service SmartAGT-AI-Gateway-Service
Résultat attendu : l'état est Running.
Déclarez le load balancer dans le YAML commun des nœuds Backend, puis redémarrez le service AI Gateway de chaque nœud gateway, un nœud après l'autre :
smartagt:
gateway:
server:
trusted_proxies:
- <adresse IP du load balancer>
Sans cette déclaration, AI Gateway refuse les appels relayés par le load balancer.
sudo systemctl restart SmartAGT-AI-Gateway-Service
systemctl is-active SmartAGT-AI-Gateway-Service
Résultat attendu : sur chaque nœud gateway, la commande affiche active.
Restart-Service SmartAGT-AI-Gateway-Service
Get-Service SmartAGT-AI-Gateway-Service
Résultat attendu : sur chaque nœud gateway, l'état est Running.
2. Activer AI Gateway
Pour activer AI Gateway, à partir de l'interface d'administration :
- Aller dans la rubrique IA Factory, section Assistants, page AI Gateway.
- Dans Mise en service, renseigner l'URL publique, par exemple
https://gateway.example.test:8001. - Dans Réseau, vérifier que les adresses des outils raccordés figurent dans la liste. Par défaut, elle autorise les réseaux privés
10.0.0.0/8,172.16.0.0/12et192.168.0.0/16. Pour un accès Zero Trust avec agent, ajoutez sa plage d'adresses, par exemple100.64.0.0/10. - Activer l'interrupteur en tête de page, puis cliquer sur Enregistrer et confirmer la mise en service.
La confirmation récapitule les réglages, dont la Conservation du contenu. Elle est désactivée par défaut et se règle dans Conservation des appels.
Résultat attendu : l'interrupteur affiche Activé.
3. Créer une clé
Chaque appel s'authentifie par une clé AI Gateway, que seul un compte disposant du droit Utiliser l'AI Gateway peut créer. Ce droit n'est attribué à personne par défaut.
Pour créer une première clé, à partir de l'interface d'administration :
- Ouvrir la fiche de la personne, onglet Droits, et lui attribuer Utiliser l'AI Gateway.
- Cette personne ouvre ses paramètres, section AI Gateway, et clique sur Créer une clé AI Gateway.
- Renseigner le Nom de la clé, l'Outil raccordé et la Date d'expiration, puis cliquer sur Créer la clé.
- Copier la clé affichée, qui commence par
sagt_gw_: elle ne sera plus jamais affichée.
Résultat attendu : la clé apparaît dans la liste des clés de la personne.
4. Tester un appel
Depuis un poste dont l'adresse figure dans la liste Réseau :
curl -k https://gateway.example.test:8001/v1/models -H "Authorization: Bearer <clé>"
curl.exe -k https://gateway.example.test:8001/v1/models -H "Authorization: Bearer <clé>"
-k accepte le certificat généré par SmartAGT ; après Installer vos certificats, remplacez-le par --cacert <autorité de vos certificats>.
Résultat attendu : la commande affiche en JSON la liste des modèles de conversation ouverts par AI Gateway.
Remarque
Un code 403 signale une adresse absente de la liste Réseau (address_not_allowed) ou une AI Gateway non activée (gateway_not_activated). Un code 401 signale une clé absente, inconnue ou expirée. Les journaux app-gateway et access-gateway, dans le dossier des journaux du Backend, précisent la cause.
Cas particuliers
Clé pour une application
Pour une application plutôt qu'une personne, créez un compte de service : rubrique IAM, Comptes de service, fiche du compte, onglet Clés AI Gateway, bouton Émettre une clé. La première clé active d'un compte de service occupe un siège de licence.
Modèles ouverts
Par défaut, AI Gateway ouvre tous les modèles de conversation. Pour restreindre ce catalogue : rubrique Gouvernance, section AI Gateway, page Modèles.
Contrat de l'API
Le contrat de cette version se lit sur https://gateway.example.test:8001/api/docs, avec une clé AI Gateway. AI Gateway sert les appels Chat Completions, en JSON et en SSE.
AI Gateway derrière un proxy
Déclarez les adresses du proxy dans le YAML du Backend, puis redémarrez le service AI Gateway :
smartagt:
gateway:
server:
trusted_proxies:
- <adresse IP du proxy>
AI Gateway lit alors l'adresse du client dans les en-têtes transmis par ce proxy, et c'est cette adresse que la liste Réseau autorise. Un appel relayé par un proxy non déclaré est refusé. Seules les adresses IPv4 sont acceptées : Configurer un reverse proxy.
Écoute et certificat
AI Gateway écoute par défaut sur le port 8001 de toutes les adresses du serveur, toujours en HTTPS. L'écoute et votre certificat se déclarent dans le YAML du Backend, sous smartagt.gateway.server (host, port, certfile, keyfile) : voir le YAML Avancé d'Installer le Backend et Installer vos certificats.
Serveur réservé à AI Gateway
Sur un serveur réservé à AI Gateway, utilisez le même package Backend, le même YAML et la KEK du Backend existant. Appliquez l'étape 1 d'Installer le Backend, sautez les étapes 2 et 3, puis à l'étape 4 créez seulement le service AI Gateway.
Nœud réservé à AI Gateway
Déclarez-le dans deployment.nodes avec le seul rôle gateway, puis suivez le cas particulier « Ajouter un nœud Backend » d'Installer le Backend. Ajoutez-le ensuite aux nœuds du load balancer.