Sources de connaissances

Les sources de connaissances aident vos agents IA à interpréter les données du catalogue et à récupérer les informations pertinentes pour atteindre vos objectifs. Pour une introduction aux agents Braze, consultez Agents Braze. Pour ajouter des connaissances à un agent, consultez Créer des agents personnalisés.

Comment ça fonctionne

Les sources de connaissances sont un type de contexte d’agent. Un agent IA peut référencer une source de connaissances pour récupérer des données du catalogue de manière plus précise que si le catalogue était référencé directement dans les instructions de l’agent.

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 référence la source de connaissances du catalogue « nyc_restaurants ». Lorsque vous créez cette source de connaissances, 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 contribuent pas aux recommandations.

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

1

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 :

1
2
3

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 connaissance

Pour créer une source de connaissance :

1. Accédez à Agent Console > Knowledge Sources.
2. Sélectionnez Add Knowledge Source. Dans le menu déroulant, sélectionnez Catalog.
3. Sélectionnez le catalogue dans le menu déroulant.
4. Passez en revue les champs du catalogue et désélectionnez ceux qui ne s’appliquent pas au cas d’usage de votre agent. Nous recommandons d’exclure les champs de catalogue qui ne sont pas utiles pour la récupération ou la génération — limitez la source de connaissance aux seuls champs dont votre agent a besoin.
5. (facultatif) Ajoutez une description pour décrire le contenu de la source de connaissance.
6. Sélectionnez Add Knowledge Source.

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

Vous pouvez également créer une source de connaissance 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 détails tels que les sources de connaissances actives et la date de 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 :

1. Accédez à la section Instructions de votre agent.
2. Sélectionnez + Agent context > Add knowledge.
3. Dans le menu déroulant, sélectionnez la source de connaissances.

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

Questions fréquentes

Comment fonctionnent les sources de connaissances ?

La conversion d’un catalogue en source de connaissances aide les Braze Agents à comprendre la signification réelle 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 lorsque vous configurez un agent personnalisé (Canvas Step Agent ou Catalog Agent) qui a besoin de données de catalogue comme contexte. Les sources de connaissances aident les agents à récupérer les données du catalogue de manière plus précise que lorsqu’ils référencent le catalogue directement dans les instructions de l’agent.

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

Non. La source de connaissances remplace le catalogue en tant que contexte de l’agent : vous n’avez pas besoin d’attacher les deux. Lorsque vous créez la source de connaissances, incluez uniquement les champs du catalogue dont votre agent a besoin.

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

Dupliquez tout agent existant qui référence un catalogue standard, et modifiez-le pour qu’il référence la source de connaissances équivalente à la place. Effectuez quelques invocations de test dans la console de l’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 nouvel agent (en utilisant l’étape chemin d’expérience) pour comprendre l’impact sur les performances.