Aller au contenu

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.

  1. ServiceDémarré avec le Backend
  2. ActivationURL publique et réseau
  3. CléDroit et clé d'accès
  4. 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 port 8001 ouvert 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 8001 sous le nom d'accès des outils raccordés, par exemple gateway.example.test. Il transmet l'adresse du client dans X-Forwarded-For, car la liste Réseau filtre cette adresse.
  • Port 8001 des nœuds gateway ouvert 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 :

  1. Aller dans la rubrique IA Factory, section Assistants, page AI Gateway.
  2. Dans Mise en service, renseigner l'URL publique, par exemple https://gateway.example.test:8001.
  3. 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/12 et 192.168.0.0/16. Pour un accès Zero Trust avec agent, ajoutez sa plage d'adresses, par exemple 100.64.0.0/10.
  4. Activer l'interrupteur en tête de page, puis cliquer sur Enregistrer et confirmer la mise en service.

La confirmation porte sur la conservation du contenu des appels, réglable dans Conservation des appels (14 jours par défaut).

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 :

  1. Ouvrir la fiche de la personne, onglet Droits, et lui attribuer Utiliser l'AI Gateway.
  2. Cette personne ouvre ses paramètres, section AI Gateway, et clique sur Créer une clé AI Gateway.
  3. Renseigner le Nom de la clé, l'Outil raccordé et la Date d'expiration, puis cliquer sur Créer la clé.
  4. 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.

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.