Aller au contenu

Prise en main

Cette procédure réalise les premières actions d'administration, puis confirme l'installation avec Smarty et un premier SmartAgent.

Prérequis

  • Installation activée : Activer l'installation.
  • Clé API du fournisseur et références des modèles de conversation et d'embedding : Inférence.
  • Accès HTTPS sortant du serveur vers le fournisseur : Réseau.
  • Un document textuel non confidentiel.
  • Installation activée : Activer l'installation.
  • Clé API du fournisseur et références des modèles de conversation et d'embedding : Inférence.
  • Accès HTTPS sortant de chaque nœud Backend vers le fournisseur : Réseau.
  • Un document textuel non confidentiel.

Procédure

1. Ajouter les fournisseurs et les modèles

Pour ajouter un fournisseur et ses modèles, à partir de l'interface d'administration :

  1. Aller dans la rubrique IA Factory, section Inférence, page Instances.
  2. Ouvrir l'onglet Fournisseurs.
  3. Sélectionner le fournisseur, cliquer sur Configurer et renseigner la clé API.
  4. Ouvrir les modèles du fournisseur et activer la référence de conversation, puis celle d'embedding.

Si l'embedding relève d'un autre fournisseur, l'ajouter de la même façon.

Pour choisir l'embedding par défaut, avant le premier dépôt de document :

  1. Aller dans la rubrique IA Factory, section Capacités, page RAG.
  2. Dans Modèle d'embedding par défaut, cliquer sur Changer.
  3. Sélectionner l'instance d'embedding activée et enregistrer.

Résultat attendu :

  • les instances de conversation et d'embedding apparaissent et leur test de connexion réussit ;
  • le bandeau Modèle d'embedding par défaut affiche l'instance choisie.

2. Activer Smarty

Smarty, l'IA généraliste de la plateforme, est désactivé à l'installation. Pour l'activer, à partir de l'interface d'administration :

  1. Aller dans la rubrique IA Factory, section Assistants, page Smarty.
  2. Ouvrir le studio de configuration avec la roue crantée.
  3. Dans Modèles, ajouter le modèle de conversation aux Modèles autorisés.
  4. Activer En service dans la barre du haut.
  5. Cliquer sur Enregistrer.

Résultat attendu : la page Smarty affiche l'état Opérationnel.

3. Activer Alfred

Alfred, l'assistant intégré qui accompagne le paramétrage, est désactivé à l'installation. Pour l'activer, à partir de l'interface d'administration :

  1. Aller dans la rubrique IA Factory, section Assistants, page Alfred.
  2. Cliquer sur Activer maintenant.
  3. Dans Modèle global, choisir le modèle de conversation, puis cliquer sur Appliquer.

Résultat attendu : aucune fonctionnalité d'Alfred ne signale de modèle manquant.

4. Fixer le quota par défaut

Chaque utilisateur dispose par défaut de 20 € par mois, pour Smarty, les agents et l'AI Gateway. Pour ajuster ce budget, à partir de l'interface d'administration :

  1. Aller dans la rubrique Gouvernance, section Utilisateurs, page Consommation.
  2. Cliquer sur la règle Budget mensuel par utilisateur.
  3. Dans Limites, renseigner le montant mensuel, puis cliquer sur Enregistrer.

Résultat attendu : la colonne Périodes & limites affiche le nouveau montant.

5. Tester Smarty et un SmartAgent

Ce test confirme l'installation de bout en bout : modèles, assistants et recherche documentaire.

Pour tester Smarty, à partir de l'interface utilisateur :

  1. Ouvrir l'accueil et envoyer un message à Smarty.

Pour créer un premier SmartAgent, à partir de l'interface d'administration :

  1. Aller dans la rubrique IA Factory, section Assistants, page SmartAgents.
  2. Cliquer sur Créer un agent.
  3. Dans Général, renseigner le Nom de l'agent, puis cliquer sur Suivant.
  4. Dans Modèles, choisir le modèle de conversation, puis cliquer sur Créer.

Pour tester le SmartAgent, à partir de l'interface utilisateur :

  1. Ouvrir SmartAgents, onglet Mes agents, puis l'agent créé.
  2. Lui envoyer un message.
  3. Déposer le document dans une base documentaire, attendre la fin de son traitement, puis poser une question dont la réponse s'y trouve.

Résultat attendu :

  • Smarty et le SmartAgent répondent ;
  • la réponse à la question cite le document.

Remarque

Si le modèle de conversation n'est pas proposé à la création de l'agent, autorisez-le dans la rubrique Gouvernance, section Studio, page Modèles.

Cas particuliers

Ferme privée pour la conversation

Une ferme privée remplace le fournisseur cloud pour le modèle de conversation. Pour l'ajouter, à partir de l'interface d'administration :

  1. Aller dans la rubrique IA Factory, section Inférence, page Instances, onglet Fournisseurs.
  2. Ajouter une ferme et lui donner un nom unique.
  3. Renseigner son URL HTTPS complète, par exemple https://inference.example.org/v1, et sa clé API.
  4. Lancer la découverte des modèles servis.
  5. Sélectionner une référence connue du référentiel livré et renseigner ses prix virtuels d'entrée et de sortie par million de jetons, strictement positifs.
  6. Importer le modèle.

Une ferme privée sert la conversation. Pour l'embedding, choisir un fournisseur dont le catalogue livré propose cette capacité.

La connexion au fournisseur échoue
Cause Vérifier
TLS ou proxy DNS depuis le serveur, autorité du fournisseur, réglages Plateforme > Réseau sortant et flux autorisés.
Accès refusé Clé, droits du compte fournisseur et modèle demandé.
Activation refusée Référence exacte du catalogue, capacités publiées et quota du fournisseur.
OCR et images

Ces modèles sont facultatifs et distincts de la conversation et de l'embedding. Le catalogue doit proposer une offre du bon type, compatible avec le package installé. En SaaS, seules les API de modèles directement consommables sont prises en charge, sans endpoint serverless ni dédié à déployer.

L'OCR local utilise un détecteur et un reconnaisseur, sur CPU, à préparer aux révisions du catalogue avant usage : prérequis. L'essai d'une instance média est compté dans la consommation.

Contrôler les points d'entrée depuis le serveur

Ces commandes interrogent l'API, le Frontend et le lien interne entre eux. Remplacez smartagt.example.test par le nom configuré, et localhost par l'adresse IP du serveur si l'API y écoute (YAML Avancé d'Installer le Backend). Avec le certificat généré par SmartAGT, -k est nécessaire ; après Installer vos certificats, remplacez-le par --cacert <autorité de vos certificats>.

curl --fail -k https://localhost:8000/api/v1/core/security/jwt/public-key
curl --fail -k https://smartagt.example.test:9000/ -o /dev/null
curl --fail -k https://smartagt.example.test:9000/api/v1/platform/internal-link
curl.exe --fail -k https://localhost:8000/api/v1/core/security/jwt/public-key
curl.exe --fail -k https://smartagt.example.test:9000/ -o NUL
curl.exe --fail -k https://smartagt.example.test:9000/api/v1/platform/internal-link

Résultat attendu :

  • l'API retourne sa clé publique ;
  • le Frontend répond avec le statut 200 ;
  • le lien interne indique "available": true.
Contrôler les points d'entrée de chaque nœud

Ces commandes interrogent l'API d'un nœud Platform, puis le Frontend d'un nœud Frontend et son lien interne vers l'API. Rejouez-les pour chaque nœud, avec son nom. L'API présente par défaut le certificat généré par SmartAGT, d'où -k. Le Frontend présente votre certificat, vérifié par --cacert.

curl --fail -k https://<nœud Platform>:8000/api/v1/core/security/jwt/public-key
curl --fail --cacert <autorité de vos certificats> https://<nœud Frontend>:9000/ -o /dev/null
curl --fail --cacert <autorité de vos certificats> https://<nœud Frontend>:9000/api/v1/platform/internal-link
curl.exe --fail -k https://<nœud Platform>:8000/api/v1/core/security/jwt/public-key
curl.exe --fail --cacert <autorité de vos certificats> https://<nœud Frontend>:9000/ -o NUL
curl.exe --fail --cacert <autorité de vos certificats> https://<nœud Frontend>:9000/api/v1/platform/internal-link

Résultat attendu :

  • chaque API retourne sa clé publique
  • chaque Frontend répond avec le statut 200
  • chaque lien interne indique "available": true