- Base de connaissances
- IA
- IA
- Créer et personnaliser des agents dans Agent Builder
BêtaCréer et personnaliser des agents dans Agent Builder
Dernière mise à jour: 23 juillet 2026
Disponible avec le ou les abonnements suivants, sauf mention contraire :
-
Marketing Hub Pro, Enterprise
-
Sales Hub Pro, Enterprise
-
Service Hub Pro, Enterprise
-
Data Hub Pro, Enterprise
-
Content Hub Pro, Enterprise
-
CRM intelligent Pro, Enterprise
-
Crédits HubSpot requis
Créez des agents personnalisés (BÊTA) capables d’analyser les données, de générer des résultats et de prendre des mesures en fonction des processus de votre entreprise. Dans le générateur moderne, vous pouvez définir ce qu’un agent doit faire, à quelles données il peut accéder et comment il doit réagir.
Les agents personnalisés permettent de standardiser la façon dont les tâches sont effectuées et de réduire les efforts manuels en appliquant une logique cohérente à vos données. Cette option est utile pour les processus qui nécessitent d’examiner des fiches d’informations, de générer des résultats structurés ou de prendre des décisions basées sur plusieurs sources de données.
Pour une vue d’ensemble de la configuration des fonctionnalités d’IA dans votre compte, consultez la procédure de configuration de votre compte HubSpot pour l’adoption de fonctionnalités d’IA.
Remarque : Vous pouvez gérer l'accès aux fonctionnalités d'IA dans vos paramètres d'IA et configurer les données partagées. Consultez la FAQ sur la fiabilité et la sécurité de l'IA et les cartes de modèle d'IA de HubSpot pour obtenir des informations détaillées sur les contrôles de sécurité de l'IA, l'utilisation des données et la conformité.
Avant de commencer
Avant de commencer à créer et à personnaliser les agents dans Agent Builder, examinez les exigences et les considérations en la matière.
-
Un super administrateur doit activer les options suivantes dans les paramètres IA :
-
Donner aux utilisateurs l'accès aux outils et fonctionnalités de l'IA générative
-
Données du CRM
-
Données de conversion des clients
-
Données de fichiers
-
Fournir aux utilisateurs l'accès à Breeze Assistant
-
Autorisations requises L’autorisation d’un super administrateur ou de Breeze Studio est requise pour créer et personnaliser des agents dans Agent Builder.
Autorisations requises Les utilisateurs peuvent avoir besoin d’autorisations supplémentaires en fonction de l’objectif de l’agent. Par exemple, un agent qui génère une page de destination a besoin des autorisations Modifier et publier pour modifier et publier des pages de destination.
Créer un agent dans Agent Builder
Créez un agent personnalisé en définissant ses instructions, en sélectionnant des actions et en configurant les données et les entrées qu’il utilisera.
-
Dans votre compte HubSpot, cliquez sur Plus, puis accédez à Agents > Agent Hub . Si l’option n’apparaît pas dans votre compte, accédez directement à Agents > Agent Hub .
-
Dans l’onglet Intro , cliquez sur le menu déroulant Créer en haut à droite et sélectionnez Agents.
- Dans Agent Builder, configurez les instructions, les actions, les connaissances et les entrées de votre agent.
Mode d’emploi
Définissez ce que l’agent doit faire et comment il doit se comporter. Indiquez le rôle de l’agent, ses objectifs, son approche et les résultats attendus.
Dans Agent Builder, saisissez du texte dans le champ Instructions. Définir clairement le rôle, l’objectif, l’approche et les résultats attendus de l’agent.
Par exemple, vous pouvez ajouter les instructions suivantes :
Role:
You’re a customer onboarding review agent responsible for preparing internal handoffs after a deal is closed.
Goal:
Analyze customer information and summarize key details needed for a successful onboarding process.
Approach:
Review contact and company properties, deal details, and recent activity.
Identify important context such as customer goals, purchased products, timeline expectations, and risks.
Flag any missing or unclear information that may impact onboarding.
Output:
Section 1: Customer summary (3-5 bullet points).
Section 2: Key onboarding considerations.
Section 3: Missing information or risks.
Keep responses concise, structured, and actionable.
Actions
Sélectionnez les actions que l’agent peut effectuer. Les actions déterminent les tâches que l’agent peut accomplir en fonction des instructions.
-
Dans Agent Builder, cliquez sur Ajouter une action dans le panneau de gauche.
-
Dans le panneau de droite, cliquez sur les onglets HubSpot, Par défaut ou MCP et sélectionnez vos actions.
-
HubSpot : faites votre choix parmi différents types d’actions (par exemple, Obtenez des données, Générez, Agissez). Pour filtrer les types d’actions, cliquez sur le menu déroulant Types et sélectionnez un type (par exemple, Générer).
-
Par défaut : sélectionnez parmi les actions par défaut telles que Parcourir le web ou Lire vos enregistrements HubSpot CRM.
-
Navigation sur le web : donne à l’agent l’accès pour naviguer sur le web.
-
Lire vos fiches d’informations CRM HubSpot : cela permet à l’agent de lire vos fiches d’informations CRM.
-
Écrire dans les fiches d’informations de votre CRM HubSpot : cette option permet à l’agent d’écrire dans les fiches d’informations de votre CRM.
-
-
MCP : connectez votre agent à des systèmes externes à l’aide du protocole MCP (Model Context Protocol). Découvrez-en davantage sur les serveurs MCP pris en charge.
-
Connaissances
Ajoutez le contexte spécifique du cas d’utilisation auquel l’agent peut se référer lors de la génération de résultats, tels que les documents chargés, les directives de la marque, les coffres-forts de connaissances ou les données pertinentes du CRM.
Utilisez la section Connaissances pour fournir des informations sur lesquelles l’agent peut s’appuyer lors de l’analyse des données ou de la génération de réponses. Contrairement aux entrées, ce contexte est disponible pour l’agent sans être redéfini à chaque exécution.
Par exemple, un agent axé sur l’onboarding peut s’appuyer sur les détails de la transaction, les informations relatives à l’entreprise associée et l’activité récente, tandis qu’un agent axé sur le contenu peut utiliser des documents ou des fichiers téléchargés.
-
Dans Agent Builder, cliquez sur Ajouter des connaissances dans la section Connaissances .
-
Dans le panneau de droite, cliquez sur Personnalisé, Par défaut ou Intégrations et sélectionnez vos connaissances.
-
Personnalisé : sélectionnez un coffre de connaissances. Découvrez-en davantage sur la gestion du contexte des agents avec les coffres-forts de connaissances.
-
Par défaut : sélectionnez dans le contexte par défaut tel que votre kit de marque ou vos profils de client idéal.
-
Intégrations : cliquez sur une intégration pour configurer ce qui est inclus.
-
Entrées
Définissez les données spécifiques que l’agent utilise à chaque exécution, telles qu’une fiche d’informations, une valeur fournie par l’utilisateur ou des informations transmises par un autre outil ou processus.
Utilisez les entrées pour spécifier ce sur quoi l’agent doit agir pour une exécution donnée. Contrairement aux connaissances, les entrées sont fournies au moment de l’exécution et peuvent varier en fonction du contexte.
Par exemple, un agent axé sur l’onboarding peut utiliser des entrées telles que le nom de la transaction, la date de fermeture ou les objectifs du client, tandis qu’un agent axé sur le contenu peut nécessiter un sujet, une audience ou un message clé.
-
Dans Agent Builder, cliquez sur Ajouter une entrée dans la section Entrées .
-
Cliquez sur le menu déroulant Type d’entrée et sélectionnez une option (par exemple, Objet CRM).
- Dans le champ Libellé , saisissez un nom pour la saisie.
Gérer l’accès des agents
Contrôlez les utilisateurs qui ont accès à chaque agent. Par défaut, les super administrateurs peuvent modifier les agents et tous les utilisateurs peuvent les exécuter.
Si la configuration d’un agent repose sur d’autres fonctionnalités HubSpot (par exemple, blog ou pages de destination) auxquelles un utilisateur n’a pas accès, l’agent ne peut pas être exécuté par cet utilisateur, même s’il est autorisé à modifier ou à exécuter l’agent.
-
Dans Agent Builder, cliquez sur l’icône des trois points verticaux et sélectionnez Attribuer l’accès en haut à gauche.
-
Dans le panneau de droite, sélectionnez une option d’accès :
-
Les propriétaires et les super administrateurs peuvent modifier et exécuter : seul l’utilisateur qui a créé ou installé l’agent et les super administrateurs peuvent modifier et exécuter l’agent.
-
Les propriétaires et les super administrateurs peuvent modifier, tout le monde peut exécuter : seul l’utilisateur qui a créé ou installé l’agent et les super administrateurs peuvent modifier l’agent. Chaque utilisateur peut exécuter l’agent.
-
Tout le monde peut modifier et exécuter : tout utilisateur peut modifier et exécuter l’agent.
-
Accès personnalisé des équipes et des utilisateurs : seuls les utilisateurs et les équipes sélectionnés peuvent modifier ou exécuter l’agent. Si vous sélectionnez cette option, des options d’accès supplémentaires apparaîtront :
-
Exécuter et modifier : les utilisateurs ou équipes sélectionnés peuvent exécuter et modifier l’agent.
-
Exécuter : les utilisateurs ou équipes sélectionnés peuvent exécuter l’agent.
-
-
- Lorsque vous avez terminé, cliquez sur Mettre à jour la catégorie.
Tester un agent dans Agent Builder
Tester votre agent pour confirmer que les résultats répondent à vos attentes. Les tests permettent de confirmer que l’agent utilise les bonnes entrées, de référencer les bonnes données et d’obtenir les résultats attendus.
Remarque : Le test d’un agent ne consomme pas de crédits. Découvrez-en davantage sur la consultation des coûts estimés des agents dans Agent Builder.
-
Dans le panneau de droite, saisissez les entrées requises.
-
Cliquez sur Tester l’agent.
-
Dans la boîte de dialogue, cliquez sur Exécuter.
-
Dans l’onglet Résultats , examinez le résultat selon les éléments suivants :
-
Confirmez que l’agent suit le format attendu.
-
L’agent utilise les données et le contexte attendus.
-
Identifiez les éventuelles lacunes, inexactitudes ou réponses peu claires.
-
-
Mettez à jour la configuration de l’agent si nécessaire :
-
Affiner les instructions pour plus de clarté ou de spécificité.
-
Ajuster les sources de connaissances si des données pertinentes sont manquantes ou incorrectes.
-
Mettre à jour les entrées pour s’assurer que les informations requises sont incluses.
-
-
Répétez les tests jusqu’à ce que les résultats soient cohérents et répondent à vos exigences. Continuez ensuite à examiner les coûts de crédit estimés et fixez les limites de tirage.
Examiner les coûts de crédit estimés et définir les limites d’exécution
Après avoir testé l’agent, vérifiez les crédits HubSpot estimés nécessaires pour la tâche. Vous pouvez également définir des limites d’exécution pour contrôler le nombre de crédits qu’un agent peut utiliser pendant l’exécution, ce qui vous permet de gérer l’utilisation des crédits sur votre compte.
-
Dans Agent Builder, cliquez sur Historique des exécutions en haut de la page.
-
Dans le panneau de gauche, cliquez sur une exécution d’agent.
-
Dans le panneau de droite, consultez les crédits estimés.
Ces estimations sont fournies à titre indicatif uniquement. Les coûts réels peuvent varier. Découvrez-en davantage surl’affichage des coûts de crédit estimés pour les agents et la définition des limites d’exécution mensuelles.
Publier un agent personnalisé
Une fois que vous avez testé votre agent et confirmé que le résultat répond à vos attentes, enregistrez et publiez l’agent pour le rendre disponible à l’utilisation.
-
Dans Agent Builder, cliquez sur Enregistrer et publier les modifications.
- Pour exécuter l’agent, cliquez sur Exécuter dans l’angle supérieur droit. Découvrez-en davantage sur l’exécution et la vérification de la sortie de l’agent dans la boîte de réception de l’agent.
Après la publication, utilisez l’agent dans vos processus généraux et incluez des agents dans d’autres automatisations. Découvrez-en davantage sur l’ajout d’agents à des workflows .