Les articles Knowledge sont des documents maintenus pour les politiques, les explications et d'autres informations hors catalogue. L'éditeur actuel prend en charge un titre, un extrait, un corps enrichi, des titres, des listes, des liens, des images, de la vidéo, des tableaux, des séparateurs, des boutons, l'alignement et d'autres mises en forme.

Ce guide couvre le cycle de vie du contenu, de la propriété de la source aux états public ou privé et publié ou brouillon. Il explique également pourquoi une republication Helpdesk est nécessaire avant qu'un article modifié apparaisse dans un nouvel instantané public immuable.

Comment cela s'intègre dans Humind

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

Les articles publics et publiés peuvent également être projetés dans un Helpdesk. Les extraits restent des consignes opérationnelles plutôt que des pages Helpdesk publiques. 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 pour créer, modifier, publier, dépublier, déplacer ou supprimer un article. La publication Helpdesk requiert l'accès d'administration Helpdesk correspondant.

• Identifiez le propriétaire faisant autorité de la politique ou du sujet.
• Recherchez les sources Knowledge existantes pour éviter les doublons d'autorité.
• Choisissez le dossier, l'audience, la date de révision et la langue Helpdesk prévue avant de rédiger.

Procédure étape par étape

1. Créer l'article dans le bon dossier

   Ouvrez AI Agent, Knowledge, accédez au dossier prévu, choisissez Nouveau contenu, puis sélectionnez Article. Utilisez une tâche ou une question précise comme titre et rédigez un extrait qui indique exactement aux lecteurs ce que le guide les aide à faire.

   Si le sujet n'est pas une documentation publique, demandez-vous à nouveau si un article privé, un extrait, une page web ou un document n'est pas une meilleure source.

2. Rédiger pour une lecture rapide et l'action

   Commencez par le résultat, puis ajoutez les prérequis, les étapes numérotées, les autorisations ou réserves, la vérification, le dépannage et les liens associés. Utilisez des titres et des listes pour structurer. Ajoutez des tableaux ou des médias uniquement lorsqu'ils réduisent l'ambiguïté.

   Utilisez les libellés exacts et actuels de Humind lorsque vous documentez le produit. N'incluez pas d'identifiants privés, de points de terminaison internes, d'identifiants de connexion, de fonctionnalités spéculatives ni de captures d'écran qui deviendront immédiatement obsolètes.

3. Définir la visibilité et le cycle de vie

   Ouvrez le panneau des paramètres de Knowledge et choisissez public ou privé, puis publié ou brouillon. Le statut public contrôle l'audience ; le statut publié contrôle si l'élément est actif. Un brouillon public n'est pas prêt pour un Helpdesk en ligne.

   Confirmez tout paramètre de période d'activité ou d'éligibilité Helpdesk utilisé par l'entreprise. Gardez l'élément à l'état de brouillon tant que les réviseurs résolvent encore des questions factuelles ou juridiques.

4. Vérifier et tester la source

   Demandez au propriétaire du sujet et à un éditeur de vérifier les faits, les étapes, les liens, la langue et l'accessibilité. Testez ensuite des questions représentatives dans Playground pour voir si l'Agent applique correctement l'article sans entrer en conflit avec une autre source.

   Corrigez l'article ou la source conflictuelle, pas l'invite de test. Commencez une nouvelle conversation après des changements d'état de publication ou de contenu.

5. Publier une nouvelle version Helpdesk si nécessaire

   Si l'article doit figurer dans un Helpdesk public, vérifiez la projection du contenu Helpdesk, la collection, le titre, l'extrait et la langue. Publiez une nouvelle version Helpdesk immuable uniquement lorsque l'ensemble sélectionné complet est cohérent.

   La version Helpdesk précédente reste un instantané historique immuable. Ne vous attendez pas à ce que la modification de Knowledge réécrive rétroactivement une publication plus ancienne.

Autorisations et réserves importantes

• Les statuts public et publié sont des paramètres indépendants et affectent tous deux la disponibilité pour les clients.
• La suppression d'un article est destructive ; dépubliez-le d'abord lorsque la révision ou l'historique est important.
• Le formatage enrichi doit favoriser la compréhension et l'accessibilité plutôt que la décoration.
• La publication Helpdesk capture un instantané du contenu de l'article, donc les modifications ultérieures de Knowledge nécessitent une autre publication.

Vérifier le résultat

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

• Le titre et l'extrait décrivent avec précision le résultat et l'audience.
• Le corps comprend des étapes, des réserves, une vérification, un dépannage et des liens internes valides lorsque c'est pertinent.
• La visibilité, la publication, la période d'activité, le dossier et l'éligibilité Helpdesk sont intentionnels.
• Le dernier instantané Helpdesk contient la version révisée dans la bonne langue et la bonne collection.

Dépannage

L'article est enregistré mais n'est pas public

Vérifiez les statuts public ou privé, publié ou brouillon, la période d'activité, l'éligibilité Helpdesk, la sélection de projection et la langue. Publiez une nouvelle version Helpdesk une fois que toutes les conditions sont correctes.

L'Agent ignore l'article

Confirmez qu'il est enregistré et actif dans l'entreprise actuelle, supprimez les sources Knowledge en conflit, utilisez une nouvelle conversation Playground et posez une question qui correspond réellement au périmètre de l'article.

Un lien interne est rompu

Utilisez la route stable de l'article Helpdesk et un slug publié existant pour la même langue. Ne créez pas de lien vers un brouillon, un élément privé, une URL d'éditeur ou un id de base de données.

Guides associés

• Mettre en place une base de Knowledge fiable
• Organiser le Knowledge avec des dossiers
• Utiliser des snippets pour des consignes réutilisables
• Testez votre Agent dans Playground