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 ligne 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 Braze Agents, consultez Braze Agents. Pour ajouter une source de connaissances à un agent, consultez Créer des agents personnalisés.
Comment ça marche
Une source de connaissances est une vue organisée d’un catalogue que vous ajoutez en tant que + Contexte de l’agent. Lorsque vous associez la source de connaissances à un agent, vous n’incluez que les champs utiles à 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 le catalogue complet, pour que l’agent dispose d’un contexte ciblé et précis.
Imaginons que vous créiez un agent chargé de recommander des restaurants à New York en fonction de la cuisine préférée d’un utilisateur, qui est un attribut personnalisé. Cet agent s’appuie sur la source de connaissances du catalogue « nyc_restaurants ». Lorsque vous associez cette source de connaissances à l’agent, vous n’incluez que les champs dont il a besoin (comme le nom du restaurant, son emplacement et le type de cuisine) et vous excluez les autres colonnes du catalogue qui ne servent pas 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 à partir de 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 à Agents > Sources de connaissances.
- Sélectionnez Ajouter une source de connaissances. Dans la liste déroulante, sélectionnez Catalogue.
- Sélectionnez le catalogue dans la liste déroulante.
- (facultatif) Ajoutez une description pour indiquer le contenu de la source de connaissances.
- Sélectionnez Créer une source de connaissances.

Vous pouvez également créer une source de connaissances pendant la création d’un agent, depuis la section Instructions de votre agent. Sélectionnez Ajouter des connaissances > Créer une source de connaissances.
Utiliser une source de connaissances dans votre agent IA
Vous pouvez gérer vos sources de connaissances depuis la section Sources de connaissances. Vous y trouverez des informations comme les sources de connaissances actives et la date de leur dernière synchronisation. 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 + Contexte de l’agent > Ajouter des connaissances.
- Dans la liste déroulante, sélectionnez la source de connaissances.
- Sélectionnez Configurer les champs pour la source de connaissances, puis décochez les champs du catalogue que l’agent ne doit pas utiliser lors de ses recherches.
Inclure tous les champs du catalogue peut ajouter du contexte superflu et réduire la qualité des résultats. En décochant les champs qui ne sont pas pertinents pour votre cas d’usage, vous aidez l’agent à se concentrer sur les données qui comptent vraiment.
Votre agent peut désormais consulter la source de connaissances et récupérer les données de catalogue pertinentes.
Pour les agents conversationnels, ajoutez une source de connaissances en tant qu’outil dans une étape de workflow plutôt que via + Contexte de l’agent. Consultez la section Rechercher dans les sources de connaissances.
Foire aux questions
Comment fonctionnent les sources de connaissances ?
Convertir un catalogue en source de connaissances aide les Braze Agents à comprendre le véritable sens des mots et des expressions du catalogue. Les agents peuvent ainsi trouver plus efficacement des données pertinentes et 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 trouver des destinations, des produits ou des restaurants au cours d’un parcours Canvas, ou pour répondre à des questions sur les produits et à des questions fréquentes dans un flux de travail conversationnel. Les sources de connaissances sont la méthode prise en charge pour ajouter ce contexte de catalogue consultable. Les agents de catalogue qui se contentent d’enrichir la ligne sur laquelle ils sont déployés n’ont pas forcément besoin d’une source de connaissances, sauf s’ils doivent consulter d’autres données de catalogue au moment de l’exécution.
Puis-je encore associer directement un catalogue à un agent comme contexte ?
Non. Les nouveaux agents utilisent des sources de connaissances au lieu de l’ancienne option Ajouter des champs de catalogue. Si un agent existant a été configuré avec cette ancienne option Ajouter des champs de catalogue, vous pouvez continuer à l’utiliser pendant votre migration vers une source de connaissances équivalente.
Si un agent dispose d’une source de connaissances comme contexte, dois-je aussi lui associer le catalogue d’origine comme contexte ?
Non. La source de connaissances constitue la référence du catalogue pour l’agent : inutile 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 un agent existant qui utilise encore un catalogue associé directement comme contexte, puis configurez-le pour qu’il utilise plutôt la source de connaissances équivalente. Lancez quelques invocations de test dans la console des agents pour vérifier la précision des résultats. Ensuite, vous pouvez soit remplacer l’agent existant là où il est déployé, soit réaliser un test A/B entre l’ancien et le nouvel agent (à l’aide d’une étape Chemin d’expérience) pour mesurer l’impact sur les performances.