Assistant IA
L'assistant IA est un widget dans le coin inférieur droit de l'interface d'administration. En mode réduit, c'est un bouton sphérique ; un clic dessus ouvre le panneau de l'assistant. Tant que l'assistant travaille, la sphère pulse — cela indique que l'agent exécute encore une tâche, même si le panneau est fermé.
Le panneau comporte deux onglets (dans l'interface française — « Documentation » et « Agent MCP ») :
| Onglet | Que fait-il |
|---|---|
| documentation | répond aux questions sur la documentation OneEntry — ne modifie rien dans le projet |
| Agent MCP | exécute une tâche décrite en termes simples : trouve lui-même l'opération Admin API nécessaire, crée et modifie les données du projet |
Les onglets ont des historiques séparés : les questions sur la documentation ne sont pas incluses dans la conversation avec l'agent, et vice versa.
Chaque lancement de l'agent consomme des ressources du compte AI sélectionné dans le panneau : l'agent interroge le modèle plusieurs fois pour une seule tâche — il cherche l'opération, analyse ses paramètres, l'appelle, vérifie le résultat. Le coût de chaque lancement est affiché sous la réponse, le solde total — dans l'onglet Paramètres → Agents IA.
Panneau de l'assistant
Dans l'en-tête du panneau, à droite des onglets, il y a trois boutons :
- développer / réduire — élargit le panneau ou le ramène à sa taille normale ;
- effacer l'historique — efface la conversation de l'onglet ouvert. Le bouton est inactif tant qu'il n'y a rien dans la conversation ou que l'assistant répond encore ;
- fermer — réduit le panneau à nouveau en sphère. Le panneau se ferme également par un clic n'importe où en dehors de celui-ci.
Onglet de l'agent MCP
L'agent exécute une tâche décrite avec ses propres mots — par exemple « crée une page sur la livraison » ou « crée des produits à partir de ce tableau ». Il travaille avec l'Admin API via un ensemble d'outils : il cherche l'opération nécessaire, analyse ses paramètres, l'appelle, télécharge des fichiers. Parmi les outils, il y a aussi une recherche dans la documentation OneEntry — l'agent lit lui-même la documentation s'il a besoin de comprendre comment le module est structuré.
L'agent agit au nom de l'administrateur actuel et avec ses droits : ce qui vous est inaccessible, l'agent ne peut pas y accéder non plus. La suppression de données est interdite à l'agent, et il exécute les opérations protégées uniquement après votre confirmation (voir ci-dessous).
Choix de l'agent et du modèle
Dans la partie supérieure de l'onglet, dans les champs Agent et Modèle, vous choisissez le compte AI et le modèle qui exécuteront la tâche. Les comptes proviennent de Paramètres → Agents IA. La liste ne contient que des modèles capables d'appeler des outils : sans cela, l'agent ne peut pas travailler avec l'API.
S'il n'y a pas de compte AI dans le projet, au lieu de choisir, le panneau affiche un avertissement indiquant que l'agent IA n'est pas configuré et qu'il doit être créé dans les paramètres. Créez un compte dans l'onglet Paramètres → Agents IA.
Lancement de la tâche
- Décrivez la tâche dans le champ de requête.
- Si nécessaire, joignez un fichier avec le bouton en forme de trombone — par exemple, un tableau avec des produits. Un seul fichier peut être joint à la requête. Les types de fichiers autorisés et la taille maximale sont définis par le serveur ; un fichier trop volumineux ne sera pas accepté par le panneau et il vous sera proposé de le diviser en parties. Une image ne peut être jointe que si le modèle sélectionné sait lire les images — sinon, choisissez un autre modèle ou joignez un document.
- Cliquez sur le bouton de lancement (dans l'interface française — « Lancer »). Tant que l'agent travaille, le bouton est remplacé par le bouton d'annulation (« Annuler ») — il arrête l'exécution.
Tant que la tâche est en cours, les étapes de l'agent sont visibles dans le fil : quelle opération il cherche, laquelle il appelle, quel fichier il télécharge. L'étape avec des détails peut être développée par un clic. Lorsque l'agent a terminé, sa réponse apparaît sous les étapes, et sous la réponse — le coût du lancement : le nombre de tokens et le coût en dollars.
L'agent prend en compte plusieurs des derniers échanges terminés dans la conversation, donc la tâche suivante peut être formulée comme une continuation de la préc édente.
Confirmation des opérations protégées
Avant une opération protégée, l'agent s'arrête et affiche une carte avec une demande de permission. Elle contient — la méthode et l'adresse de la requête, les données qui seront envoyées, et ce qui se trouve actuellement à cette adresse. La décision est prise sur la requête elle-même, et non sur le résumé du modèle :
- le bouton de permission (dans l'interface française — « Autoriser ») — l'agent exécute l'opération ;
- le bouton de refus (« Refuser ») — l'opération n'est pas exécutée.
Si la réponse n'atteint pas le serveur, la carte en informera, et les boutons redeviendront disponibles.
Ce qu'il est important de savoir
- Fermer le panneau n'annule pas la tâche. L'agent continue de travailler, les étapes et la réponse apparaîtront lorsque le panneau sera à nouveau ouvert. Mais après la fermeture du panneau ou le changement d'onglet, il n'est pas possible d'arrêter une tâche déjà lancée depuis le panneau, et le texte de la requête non envoyé ainsi que le fichier joint disparaissent.
- L'historique est stocké uniquement en mémoire de la page. Après le rechargement de la page, la conversation avec l'agent disparaît. La fermeture de l'onglet du navigateur ou le rechargement pendant le travail de l'agent interrompent la tâche.
- Si la limite du compte AI est atteinte ou si le modèle sélectionné n'est pas approprié, la tâche ne sera pas lancée — le panneau affichera la raison.