Sources de données en direct (menu, liste de prix, stock)

Une source de données est une URL qui vous appartient (un menu, une liste de prix, un stock, des créneaux disponibles) que la plateforme récupère selon un calendrier, transforme en texte brut et place devant l'agent au début de l'appel. Aucune recherche pendant l'appel : l'agent répond à « quelle est la crêpe la moins chère ? » à partir de la liste entière, dès le premier mot.

Quand l'utiliser#

• La base de connaissances sert aux documents qui changent rarement et que l'on interroge. Un catalogue qui change chaque jour et doit se lire d'un bloc (prix, composition) convient mieux à une source de données.
• Un outil va chercher une réponse pendant que l'appelant attend. Utilisez un outil pour les recherches par client (une commande, une réservation) et une source de données pour la liste que tout le monde demande.

Connecter une source#

1. Ouvrez l'agent et allez dans l'onglet Data sources.
2. Cliquez sur Add data source et répondez à Where does the data come from? en choisissant votre fournisseur. iotSoft POS est en tête de liste ; si votre fournisseur n'y figure pas, utilisez Catalogue JSON API ou Text or CSV page.
3. Saisissez l'URL et, si votre fournisseur l'exige, l'Access token. Le jeton est stocké comme secret sur le projet et n'est plus jamais affiché.
4. Réglez Refresh every (minutes) (minimum 5, 60 par défaut) et, si besoin, Max characters (15000 par défaut).
5. Cliquez sur Connect and fetch. La première récupération a lieu immédiatement : vous voyez tout de suite si l'adresse et le jeton fonctionnent.
6. Attach la source à l'agent, puis Save et Deploy.

Preview what the agent sees affiche le texte exact que reçoit l'agent.

Comment elle reste à jour#

Chaque source est récupérée en arrière-plan selon son propre calendrier, par exactement un serveur à la fois ; un appel n'attend jamais une récupération. Une récupération qui ne trouve rien de nouveau ne touche pas aux données stockées et note seulement quand la source a été vérifiée : la liste montre à la fois la dernière vérification et le dernier changement. Une récupération échouée conserve le dernier instantané valide et marque la source error avec la raison ; rien ne change en cours d'appel. Refresh now récupère hors calendrier.

Décrire votre propre JSON#

Avec Catalogue JSON API, le Mapping (JSON) indique à la plateforme où se trouve chaque chose dans votre flux, en notation pointée : la liste des catégories (list_path), le nom de catégorie, les articles, le nom et le prix de chaque article, sa composition et ses groupes d'options. Les groupes gratuits deviennent la composition de l'article ou un choix du client ; les groupes payants deviennent des suppléments. Ajustez le mapping jusqu'à ce que l'aperçu se lise comme un client l'entendrait.

Bon à savoir#

• Jusqu'à 8 sources par agent.
• Un flux plus grand que la limite est coupé à une frontière de catégorie et le texte indique que la liste continue, afin que l'agent n'affirme jamais qu'un article n'existe pas.
• Les adresses de réseaux privés sont refusées.
• Supprimer une source supprime aussi son jeton stocké.