Passer au contenu

Cette page a été traduite automatiquement et peut contenir des inexactitudes. Pour signaler une erreur de traduction, utilisez le module de commentaires en bas de la table des matières, à droite de la page.

Sources de connaissances

Les sources de connaissances permettent aux agents de rechercher et de récupérer des données de catalogue en tant que contexte d’agent. Elles aident les agents à interpréter le contenu du catalogue et à renvoyer les bonnes lignes et les bons champs pour atteindre vos objectifs. Les agents de catalogue reçoivent également les données de lignes à partir du champ de catalogue dans lequel ils sont déployés ; les sources de connaissances ajoutent un contexte de catalogue consultable dans + Agent context. Pour une introduction aux agents Braze, consultez Agents Braze. Pour ajouter une source de connaissances à un agent, consultez Créer des agents personnalisés.

Comment ça fonctionne

Une source de connaissances est une vue organisée d’un catalogue que vous ajoutez en tant que + Agent context. Lorsque vous associez la source de connaissances à un agent, vous n’incluez que les champs qui correspondent à votre cas d’usage. Quand un agent a besoin d’informations du catalogue, il interroge la source de connaissances pour récupérer les lignes correspondantes. Braze renvoie uniquement les données pertinentes du catalogue, et non l’intégralité du catalogue, afin que l’agent puisse travailler avec un contexte ciblé et précis.

Imaginons que vous créez un agent pour recommander des restaurants à New York en fonction de la cuisine préférée d’un utilisateur, qui est un attribut personnalisé. Cet agent fait référence à la source de connaissances du catalogue « nyc_restaurants ». Lorsque vous associez cette source de connaissances à l’agent, vous n’incluez que les champs dont l’agent a besoin — tels que le nom du restaurant, l’emplacement et le type de cuisine — et vous excluez les autres colonnes du catalogue qui ne sont pas utiles aux recommandations.

Les instructions de l’agent décrivent clairement son rôle et ses contraintes :

You are a restaurant recommendation agent. Use your knowledge to help find restaurants for the user. Only include filters in your knowledge source query. Don't ask any followup questions. The user's favorite cuisine is {{custom_attribute.${favorite_cuisine}}}

Si la cuisine préférée d’un utilisateur est la pizza, l’agent peut renvoyer la réponse suivante en se basant sur la source de connaissances :

Here are some pizza recommendations for you:
- Dale's Pizza (Greenwich Village, Manhattan): Dale's Pizza invites you to savor the taste of authentic New York. Nestled in the heart of Manhattan, this iconic pizzeria offers a warm and inviting atmosphere perfect for any occasion.
- Pizza Palace (Carroll Gardens, Brooklyn): Pizza Palace is a highly-rated culinary gem renowned for its exquisite pizza. This inviting spot offers a warm and modern dining experience.

Créer une source de connaissances

Pour créer une source de connaissances :

Accédez à Agent Console > Knowledge Sources.
Sélectionnez Add knowledge source. Dans le menu déroulant, sélectionnez Catalog.
Sélectionnez le catalogue dans le menu déroulant.
(facultatif) Ajoutez une description pour décrire le contenu de la source de connaissances.
Sélectionnez Create knowledge source.

Une source de connaissances « Offers_Cart_Abandonment » qui fait référence au catalogue « Offers_Cart_Abandonment ».

Vous pouvez également créer une source de connaissances pendant la création d’un agent en accédant à la section Instructions de votre agent. Sélectionnez Add knowledge > Create knowledge source.

Utiliser une source de connaissances dans votre agent IA

Vous pouvez gérer les sources de connaissances depuis la section Knowledge Sources. Vous y trouverez des informations telles que les sources de connaissances actives et leur dernière synchronisation. Notez que le nom de la source de connaissances correspond au nom du catalogue utilisé comme source.

Pour utiliser une source de connaissances dans votre agent IA :

Accédez à la section Instructions de votre agent.
Sélectionnez + Agent context > Add knowledge.
Dans le menu déroulant, sélectionnez la source de connaissances.
Sélectionnez Configure fields pour la source de connaissances, puis décochez les champs du catalogue que l’agent ne doit pas utiliser lors de la recherche.

Inclure tous les champs du catalogue peut ajouter un contexte inutile et réduire la qualité des résultats. Décocher les champs qui ne sont pas pertinents pour votre cas d’usage aide l’agent à se concentrer sur les données importantes.

Votre agent peut désormais référencer la source de connaissances et récupérer les données pertinentes du catalogue.

Pour les agents conversationnels, ajoutez une source de connaissances en tant qu’outil dans une étape de workflow au lieu de + Agent context. Consultez Search knowledge sources.

Questions fréquentes

Comment fonctionnent les sources de connaissances ?

Convertir un catalogue en source de connaissances aide les Braze Agents à comprendre la véritable signification des mots et des expressions du catalogue, afin qu’ils puissent trouver plus efficacement des données pertinentes pour produire de meilleurs résultats.

Quand dois-je créer une source de connaissances ?

Créez une source de connaissances lorsqu’un agent doit rechercher ou récupérer des données de catalogue, par exemple pour consulter des destinations, des produits ou des restaurants au cours d’un parcours Canvas, ou pour répondre à des questions sur les produits et la FAQ dans un workflow conversationnel. Les sources de connaissances sont le moyen pris en charge pour ajouter ce contexte de catalogue interrogeable. Les Catalog Agents qui ne font qu’enrichir la ligne sur laquelle ils sont déployés n’ont pas nécessairement besoin d’une source de connaissances, sauf s’ils doivent référencer des données de catalogue supplémentaires au moment de l’exécution.

Puis-je encore associer un catalogue directement comme contexte d’un agent ?

Non. Les nouveaux agents utilisent des sources de connaissances au lieu de l’ancienne option Add catalog fields. Si un agent existant a été configuré avec l’ancienne option Add catalog fields, vous pouvez continuer à l’utiliser pendant que vous migrez vers une source de connaissances équivalente.

Si un agent a reçu une source de connaissances comme contexte, dois-je également lui assigner le catalogue d’origine comme contexte ?

Non. La source de connaissances constitue la référence de catalogue pour l’agent — vous n’avez pas besoin d’associer les deux. Lorsque vous associez la source de connaissances à l’agent, n’incluez que les champs de catalogue dont votre agent a besoin.

Comment évaluer l’efficacité d’une source de connaissances ?

Dupliquez tout agent existant qui associe encore un catalogue directement comme contexte, puis configurez-le pour utiliser la source de connaissances équivalente à la place. Effectuez quelques invocations de test dans la console d’agent pour vérifier la précision, puis envisagez soit de remplacer l’agent existant là où il est déployé, soit de réaliser un test A/B entre l’ancien agent et le nouveau (en utilisant le chemin d’expérience) pour en mesurer l’impact sur les performances.

New Stuff!