# Utilisez Beeuni comme backend d’agent pour votre produit Connectez votre produit à un agent qui parcourt les sites des fournisseurs, consulte les sources autorisées, effectue des comparaisons et renvoie les résultats via le SDK Beeuni. Canonical page: https://beeuni.ai/blog/fr/use-beeuni-as-your-agent-backend Utilisez l’API Beeuni ou le SDK TypeScript pour créer des sessions d’agent depuis votre application. Votre produit gère l’interface et ses utilisateurs ; Beeuni exécute les outils de l’agent et renvoie des messages et des fichiers. Imaginez un outil d’achat qui compare des fournisseurs. Un utilisateur sélectionne des produits et des fournisseurs approuvés ; l’agent consulte leurs catalogues publics, lit les tarifs depuis un service documentaire connecté et crée un tableau comparatif. Votre application gère la connexion et la vérification, tandis que la session Beeuni rassemble les informations et effectue la comparaison. ## Définissez la tâche envoyée par votre interface Énumérez les données d’entrée, les actions autorisées, le format de sortie et les cas d’échec. Pour l’exemple des catalogues, fournissez les pages des fournisseurs approuvés, les références aux documents de catalogue connectés et les champs à comparer. Demandez une ligne par produit, son prix indiqué et sa devise, ainsi qu’une référence à la source. Les dimensions manquantes doivent être signalées comme inconnues. La tâche ne doit pas passer de commandes. - **Responsabilités de l’application :** authentifier les personnes, déterminer qui peut accéder à chaque tâche, valider les données d’entrée et présenter le résultat. - **Configuration du projet :** choisir l’agent, le modèle, les compétences et les outils autorisés nécessaires à ce type de travail. - **Travail de la session :** envoyer la demande, suivre son avancement et examiner les messages et fichiers de sortie renvoyés. ## Donnez à la session accès aux sources nécessaires Configurez le projet avec les outils de navigation et de connexion nécessaires à la tâche. Pour un service documentaire privé, connectez un compte et accordez à l’agent l’accès au connecteur concerné. Un lien inclus dans une demande ne donne pas accès à lui seul. Veillez à ce que le compte sélectionné et les sources autorisées correspondent au client qui a envoyé la demande ; le [guide des connecteurs](/docs/fr/connect/connectors) explique l’accès aux comptes. L’agent peut alors consulter les documents sélectionnés à l’aide de ces outils, visiter les pages publiques des produits et écrire un script pour faire correspondre les codes produits et les formats d’emballage. Demandez-lui d’enregistrer avec le résultat les valeurs obtenues, les emplacements des sources et les heures de consultation. Si un catalogue est illisible ou si une page exige une autre connexion, signalez ce problème dans l’interface au lieu d’inventer un prix. ## Gardez les identifiants sur votre serveur Le [guide du SDK](/docs/fr/sdk) explique comment installer `@beeuni/sdk`, créer un client et authentifier les requêtes. Gardez la clé API sur votre serveur, hors du code exécuté dans le navigateur. Déterminez les projets Beeuni auxquels chaque client peut accéder. Séparez leurs fichiers et leurs comptes connectés lorsque c’est nécessaire, et vérifiez les autorisations sur votre serveur avant de transmettre les demandes. Le [guide d’authentification](/docs/fr/sdk/auth) présente les méthodes de connexion disponibles. ## Affichez l’avancement et gérez les reconnexions Le SDK permet de créer des sessions, d’attendre qu’elles soient prêtes et d’envoyer une demande. Le [guide complet](/docs/fr/sdk/example) explique comment recevoir les événements et lire la réponse. Utilisez ces événements pour afficher l’avancement réel. Les étapes « Ouverture des pages des fournisseurs », « Comparaison des produits » et « Résultat prêt » doivent chacune correspondre à une tâche ou à un état que vous pouvez observer. Associez un enregistrement de tâche dans votre application à chaque comparaison. Enregistrez les références aux sources sélectionnées, les colonnes demandées, les identifiants de projet et de session Beeuni, ainsi que l’emplacement du résultat dès qu’il est disponible. Cet enregistrement relie l’écran de vérification au travail déjà en cours. ``` Application task record — illustrative fields, not an SDK payload app_task_id approved_source_references requested_columns beeuni_project_id beeuni_session_id output_reference review_status ``` Prenons le cas d’un utilisateur qui sélectionne trois catalogues de fournisseurs puis actualise la page. L’interface actualisée retrouve la tâche de l’application et sa session Beeuni existante. Elle lit l’avancement enregistré et reprend le suivi du travail. Créer une nouvelle session à chaque chargement de page dupliquerait la tâche. La connexion peut aussi être interrompue avant que votre serveur ne reçoive la confirmation de l’envoi. Le résultat est alors incertain ; cela ne prouve pas que rien ne s’est passé. Vérifiez la session avant de renvoyer la demande. Si vous ne pouvez toujours pas déterminer si elle a été acceptée, signalez cette incertitude au lieu de lancer automatiquement une autre comparaison. ## Vérifiez le résultat dans votre application Pour comparer les catalogues, vérifiez les colonnes obligatoires, les fichiers lisibles, les références aux sources et les produits qui n’ont pas pu être mis en correspondance. Les différences de format d’emballage sont un piège fréquent : le prix d’une boîte de douze ne peut pas être comparé directement au prix d’un article. Conservez le montant et l’unité indiqués, et ajoutez un prix normalisé uniquement si la source permet de faire la conversion. L’écran de vérification doit permettre à l’utilisateur d’ouvrir la source d’un prix et de voir les correspondances non résolues. Le fichier peut être prêt alors que certaines lignes nécessitent encore une vérification ; gérez ces états séparément dans votre application. ## Permettez aux utilisateurs de corriger un résultat sans en perdre le contexte Supposons que deux fournisseurs désignent la même chaise par des noms différents. L’agent les laisse comme deux produits distincts, mais la personne chargée de la vérification reconnaît qu’il s’agit du même article. Une correction utile indique les deux lignes des sources et la relation voulue : « Comparez-les comme s’il s’agissait du même produit, mais conservez séparément la finition et le format d’emballage indiqués. » Un simple « réessayez » laisse l’agent deviner ce qui n’allait pas. Consignez cette correction avec la tâche et gardez le résultat précédent à disposition. Le résultat suivant peut corriger la correspondance entre les produits tout en modifiant une autre ligne. Affichez la comparaison révisée et sa version précédente afin que la personne chargée de la vérification puisse examiner les deux. Décidez quelle version le bouton de téléchargement fournit et consignez celle qui a été approuvée. L’approbation peut publier la comparaison dans un écran interne d’achat. Envoyer une commande à un fournisseur est une action distincte, qui exige ses propres autorisations et sa propre confirmation. Définissez cette limite dans l’application avant de donner à l’agent accès aux outils d’achat. La création d’un tableur ne doit pas déclencher automatiquement une commande. ## Déterminez la quantité de travail qu’une demande peut lancer Fixez des limites pratiques à l’envoi, par exemple le nombre de catalogues et le travail autorisé dans une seule demande. Comparer trois courts tarifs n’est pas la même chose que rapprocher une archive complète de produits. Présentez le périmètre accepté avant de commencer afin qu’une personne puisse réduire la demande ou opter pour un traitement en arrière-plan. Consultez les informations d’utilisation et de facturation sur la plateforme lorsqu’elles sont disponibles, plutôt que de calculer le montant final à partir de la longueur des messages. Si votre produit exige un plafond de dépenses strict ou la garantie d’une annulation, vérifiez comment l’intégration le fait respecter. Un compte à rebours ou un bouton « Arrêter » ne suffit pas à prouver que le travail et les frais ont cessé. ## Testez l’intégration avec des cas que vous pouvez vérifier manuellement Conservez un petit ensemble de catalogues dont l’interprétation attendue est connue : un tarif clair, un scan illisible, deux devises, des formats d’emballage contradictoires et un produit sans correspondance évidente. Utilisez-les lorsque vous modifiez le modèle, les instructions ou la configuration du projet. Comparez les lignes obtenues et leurs références aux sources, y compris les éléments que l’agent laisse sans réponse. Quittez aussi la page pendant une exécution, revenez-y et envoyez une correction après l’affichage du résultat. Vérifiez quel résultat est téléchargé et si une autre personne connectée peut accéder à la tâche. Le catalogue peut être interprété correctement alors que votre application affiche la mauvaise version ou la rend accessible au mauvais compte. Testez ensemble le résultat de l’agent et l’interface qui l’entoure.