Les snippets fournissent de courtes consignes opérationnelles à l'Agent. Ils sont utiles lorsque la même instruction doit s'appliquer d'une conversation à l'autre ou lorsqu'un produit nécessite une explication ciblée qui n'a pas sa place dans un article public ou dans un champ de catalogue synchronisé.

Ce guide se concentre sur le cycle de vie et la maintenance des snippets. Les snippets restent privés dans les paramètres actuels de Knowledge, ils ne doivent donc jamais être traités comme des pages publiques de Helpdesk.

Comment cela s'intègre dans Humind

Knowledge est la source maintenue des informations hors catalogue utilisées par Humind. Les articles, snippets, pages web importées, documents et sources externes de centre d'aide ont des règles de propriété et de visibilité différentes. Choisissez un type de source qui correspond à la manière dont les informations seront maintenues.

Les articles publics publiés peuvent également être projetés dans un Helpdesk. Les snippets restent des consignes opérationnelles plutôt que des pages publiques de Helpdesk. Le fait de conserver une source faisant autorité pour chaque politique réduit les réponses contradictoires et rend les mises à jour auditables.

Avant de commencer

Accès : Un accès en écriture à Knowledge est requis. Une révision axée sur les produits peut également nécessiter un accès en lecture au catalogue.

• Définissez la situation exacte et le comportement souhaité.
• Confirmez la source factuelle et vérifiez s'il existe déjà un article ou un snippet.
• Préparez une question correspondante et une question non correspondante dans Playground.

Flux de travail étape par étape

1. Déterminer si un snippet est approprié

   Choisissez un snippet pour des consignes concises et stables qui doivent influencer l'Agent sans nécessiter de page publique. Choisissez un article pour des politiques ou des explications structurées. Choisissez le catalogue pour des informations produit synchronisées à partir des données commerciales.

   Si l'instruction change quotidiennement, dépend d'un système externe ou duplique une politique complète, corrigez la conception de la source avant de créer le snippet.

2. Rédiger le snippet

   Ouvrez AI Agent, Knowledge, choisissez Nouveau contenu, puis sélectionnez Snippet. Donnez-lui un titre facile à retrouver qui nomme le scénario, le produit ou la règle. Rédigez une instruction directe avec suffisamment de contexte pour distinguer quand elle s'applique.

   Pour le travail sur les produits, le panneau de détail du produit ou le panneau Test product peut afficher des actions produit de Knowledge. Veillez à ce que la consigne soit liée au bon produit et vérifiez l'entreprise et le marché actuels.

3. Résoudre les chevauchements et définir le périmètre

   Recherchez dans Knowledge et dans les fiches produit concernées des formulations similaires. Regroupez les conflits au lieu d'ajouter un libellé de priorité à un nouveau snippet. Un collègue doit pouvoir expliquer quelle source prévaut et pourquoi.

   Utilisez une intention client stable ou un contexte produit. Évitez les formulations larges telles que 'recommandez toujours ce produit', sauf si l'entreprise a approuvé ce comportement et que les exceptions sont explicites.

4. Tester et maintenir

   Exécutez des scénarios correspondants, non correspondants, de suivi et de produit indisponible dans Playground. Vérifiez le produit choisi, l'explication factuelle et si le snippet écarte de meilleures alternatives.

   Ajoutez un responsable et un déclencheur de révision. Mettez à jour ou supprimez les snippets lorsque les campagnes se terminent, que les produits changent ou qu'un article maintenu devient la meilleure source.

Autorisations et points importants

• Les snippets restent privés et ne sont pas inclus comme articles de Helpdesk.
• Un snippet ne doit pas primer sur des données produit Shopify incorrectes ni sur une politique publique maintenue.
• Des consignes larges peuvent affecter des conversations sans rapport, les tests négatifs sont donc obligatoires.
• Le périmètre produit doit être vérifié dans l'entreprise et le marché actifs.

Vérifier le résultat

Utilisez cette liste de contrôle avant de considérer le travail comme terminé :

• Le snippet a un seul objectif, un responsable, un périmètre et une source factuelle.
• Aucun article, aucune valeur de catalogue ni aucun autre snippet n'entre en conflit avec lui.
• Les tests correspondants et de suivi s'améliorent tandis que les tests non correspondants restent inchangés.
• L'équipe sait quand le snippet doit être révisé ou supprimé.

Résolution des problèmes

Le snippet semble ne jamais s'appliquer

Confirmez qu'il est enregistré dans l'entreprise active, précisez le titre et l'instruction, vérifiez la source factuelle et testez une requête clairement correspondante dans une nouvelle conversation.

Le snippet domine les recommandations de produits

Supprimez les formulations de recommandation générales, limitez le produit ou le scénario et testez un acheteur ayant des besoins différents pour confirmer que des alternatives restent disponibles.

Un lecteur public a besoin des mêmes informations

Créez ou améliorez un article public structuré de Knowledge comme source faisant autorité, puis ne conservez dans le snippet que la petite instruction opérationnelle si elle reste nécessaire.

Guides associés

• Utilisez des extraits pour mettre en avant des produits et des scénarios
• Créer et publier un article Knowledge
• Gérer les produits, les filtres, les collections et les promotions
• Testez votre Agent dans Playground