HubSpot Agent Builder : créer vos propres agents IA dans HubSpot (guide 2026)

Depuis l'été 2026, HubSpot ne se contente plus de proposer des agents IA tout faits. Avec Agent Builder, chaque entreprise peut construire ses propres agents, directement dans son portail, branchés sur ses données CRM, ses documents et ses règles métier. C'est probablement l'outil le plus structurant de l'année pour les équipes commerciales, marketing et service client qui utilisent HubSpot.

Dans cet article, on fait le tour complet : ce qu'est Agent Builder, comment un agent est construit, ce qu'il sait faire, comment le déclencher, ce que ça coûte, et les points de vigilance à connaître avant de se lancer. Les fonctionnalités évoluent vite : nous indiquons ce qui est disponible, ce qui est encore en bêta, et nos sources en fin d'article.

Agent Builder, c'est quoi exactement ?

Agent Builder est l'outil de HubSpot pour créer des agents IA personnalisés et des workflows agentiques. Un agent, c'est un assistant à qui vous confiez un rôle précis (préparer un rendez-vous, analyser une fiche, rédiger une synthèse, mettre à jour des propriétés) et qui l'exécute en s'appuyant sur vos données.

Un peu d'historique pour s'y retrouver. Le 23 juillet 2026, HubSpot a réorganisé son offre IA :

• Breeze Studio est devenu Agent Builder, l'atelier de création d'agents.

• Breeze Agents est devenu Agent Hub, l'espace unique où vivent les agents préconçus de HubSpot et vos agents personnalisés.

• Breeze Copilot est devenu Breeze Assistant, l'assistant conversationnel qui peut désormais lancer vos agents.

• Les différents pools de crédits IA ont été fusionnés en un seul : les HubSpot Credits.

Agent Builder est aujourd'hui en bêta publique. On le trouve dans le portail, dans Agent Hub, via le menu Create.

Où se situe Agent Builder dans l'écosystème HubSpot

Quatre briques fonctionnent ensemble :

• Agent Hub : le tableau de bord. On y active les agents préconçus (Customer Agent, Prospecting Agent, Data Agent, Deal Progression…), on suit leurs résultats et on retrouve l'historique de chaque exécution.

• Agent Builder : l'atelier où l'on conçoit ses propres agents.

• Les workflows agentiques : des workflows HubSpot dans lesquels un ou plusieurs agents deviennent des étapes, aux côtés des actions classiques. Lors de son Spotlight d'automne 2026, HubSpot a annoncé la possibilité de transformer un workflow existant en workflow agentique en un clic.

• Le contexte : ce que HubSpot sait de votre entreprise (ton, marque, ICP) et vos knowledge vaults, les bases de connaissances que vous mettez à disposition de vos agents.

L'anatomie d'un agent : 5 éléments à configurer

Un agent créé dans Agent Builder repose sur cinq briques. C'est leur qualité, bien plus que la puissance du modèle, qui fait la qualité du résultat.

1. Les instructions

C'est le cahier des charges de l'agent, rédigé en langage courant : son rôle, son objectif, sa démarche et le format de sortie attendu. HubSpot donne l'exemple d'un agent de revue d'onboarding qui produit trois sections : un résumé client, les points clés d'onboarding, et les informations manquantes ou les risques.

2. Les entrées

Ce que l'agent reçoit à chaque exécution : une fiche CRM (contact, entreprise, transaction, ticket, objet personnalisé…), une valeur saisie par un utilisateur, ou une information transmise par un autre outil. Chaque entrée a un type et un libellé.

3. Les outils

Ce que l'agent a le droit de faire. Trois familles :

• Les actions HubSpot, classées en trois catégories : récupérer des données (Get data), générer du contenu (Generate) et agir (Take action).

• Les outils par défaut : navigation web, lecture des fiches CRM et écriture dans les fiches CRM.

• Les serveurs MCP : grâce au Model Context Protocol, un agent peut se connecter à des systèmes externes, à partir d'une liste de serveurs MCP pris en charge par HubSpot.

C'est ici que se joue une grande partie de la gouvernance : un agent ne doit avoir que les outils dont il a réellement besoin. Une étape de validation humaine peut être placée avant les actions sensibles.

4. Les connaissances

Ce sur quoi l'agent s'appuie, en plus de vos données CRM :

• le contexte par défaut de votre portail, comme votre brand kit et vos ICP ;

• vos knowledge vaults, des bases de connaissances ciblées (détail plus bas) ;

• vos intégrations configurées.

Ces connaissances sont disponibles à chaque exécution, sans avoir à les redéfinir.

5. Les accès

Qui peut modifier l'agent et qui peut le lancer. Quatre niveaux existent, du plus fermé (seuls le propriétaire et les Super Admins modifient et exécutent) au plus ouvert (tout le monde modifie et exécute), avec un mode personnalisé par équipe ou par utilisateur.

Les knowledge vaults : donner du contexte métier à vos agents

Un agent sans contexte produit des réponses génériques. Les knowledge vaults (en bêta) servent à lui donner le vôtre : vos fiches produits, votre documentation interne, vos consignes de support, vos grilles tarifaires, vos argumentaires.

• Formats acceptés : PDF, DOCX, PPTX, XLSX, CSV, Markdown, HTML, TXT, JSON, XML (50 Mo maximum par fichier), ainsi que des images JPEG, PNG et WebP (10 Mo maximum).

• Contenus HubSpot : par exemple des articles de votre base de connaissances.

• Segments CRM : des listes d'objets CRM, y compris d'objets personnalisés.

• Limites : jusqu'à 50 knowledge vaults par compte, chacun avec ses propres droits d'accès.

Les agents utilisent toujours la dernière version des documents ajoutés, et leurs réponses peuvent citer le document source, avec la page ou la section pour les fichiers PDF et Word.

Créer un agent : deux façons de faire

En langage courant. Vous décrivez à Breeze Assistant ce que l'agent doit faire. Il propose une configuration (objectif, outils, sources de connaissances) et l'ouvre dans Agent Builder pour que vous l'ajustiez.

Pas à pas. Depuis Agent Hub, menu Create puis Agent, vous renseignez vous-même les instructions, les entrées, les outils, les connaissances et les accès.

Dans les deux cas, la suite est la même :

1. Tester : HubSpot permet de tester un agent sans consommer de crédits, pour vérifier les entrées utilisées et les données réellement consultées.

2. Ajuster les instructions et les connaissances, puis retester.

3. Publier une fois les résultats validés.

Déclencher un agent : trois modes

• Depuis une fiche CRM : l'agent s'ajoute sous forme de carte sur un ou plusieurs types d'objets. Un commercial ouvre une transaction et lance l'agent en un clic.

• Dans un workflow : l'agent devient une étape d'un workflow agentique, déclenchée automatiquement (changement d'étape, création d'un ticket, soumission d'un formulaire…). Sur les éditions Starter, l'automatisation passe par le panneau latéral ; sur Professional et Enterprise, par le workflow builder d'Agent Hub.

• De façon planifiée ou via Breeze Assistant : un agent peut tourner à intervalle régulier, ou être appelé directement dans une conversation avec l'assistant.

Ce que vous pouvez construire concrètement

Quelques exemples d'agents qui répondent à des irritants réels des équipes. Ce sont des illustrations de ce que l'outil permet, à adapter à votre contexte.

Côté ventes

• Préparation de rendez-vous : avant chaque réunion, l'agent reprend l'historique du compte, les derniers échanges et les transactions en cours, et produit un brief en cinq points sur la fiche.

• Qualification de lead : à chaque soumission de formulaire, l'agent évalue le lead au regard de votre ICP et de vos transactions gagnées, renseigne un score et une justification.

• Revue de pipeline : chaque lundi, l'agent signale les transactions sans activité récente, sans prochaine étape ou avec une date de clôture dépassée.

Côté marketing

• Enrichissement et nettoyage : compléter des propriétés manquantes à partir du site web de l'entreprise, harmoniser des valeurs saisies à la main.

• Production de contenu cadrée : rédiger des déclinaisons (emails, posts, landing pages) en respectant votre ton et votre brand kit.

Côté service client et pilotage

• Synthèse de ticket : résumer un échange long et proposer une réponse fondée sur vos consignes de support.

• Passation ventes vers onboarding : à la signature, produire la note d'onboarding (contexte client, engagements pris, risques, informations manquantes).

• Alerte de renouvellement : croiser l'historique de support, l'activité et les échéances pour signaler les comptes à risque.

HubSpot cite le cas d'Ignite Reading, un programme de tutorat en ligne : un agent récupère automatiquement le calendrier scolaire de chaque district. Une tâche de 15 à 20 minutes par district prend désormais quelques secondes, soit plus de 350 heures économisées par an selon l'entreprise.

Combien ça coûte ?

Agent Builder n'est pas un abonnement séparé : il est inclus dans les hubs. En revanche, chaque exécution d'agent consomme des HubSpot Credits, quand l'agent réfléchit, agit ou génère du contenu. Le coût dépend de la complexité de la tâche.

Concrètement, d'après le catalogue produits et services de HubSpot (tarification standard) :

• Un agent personnalisé consomme 1 crédit par action unit. Le nombre d'action units dépend du prompt et des outils mobilisés : HubSpot affiche une estimation des crédits quand vous testez l'agent pendant sa configuration.

• Pour comparaison, le customer agent consomme 50 crédits par conversation résolue, le prospecting agent 100 crédits par lead, et une action IA dans un workflow 10 crédits.

• Chaque abonnement inclut un volume mensuel de crédits, fixé par l'édition la plus haute : 500 en Starter, 3 000 en Professional, 5 000 en Enterprise (5 000 et 10 000 avec Data Hub ou Customer Platform). Les crédits ne s'additionnent pas entre hubs et se réinitialisent chaque mois.

• Au-delà, le crédit coûte un centime en pay-as-you-go (0,01 $ dans le catalogue, facturé par tranches de 10 crédits), ou s'achète par packs de 1 000 crédits à 10 $ par mois.

Les comptes passés au modèle « sièges + crédits » ont leurs propres volumes inclus et leurs propres taux.

Pour garder la main sur la consommation :

• L'onglet Run history affiche une estimation des crédits par exécution (indicative, le coût réel peut varier).

• Vous pouvez fixer des limites d'exécution mensuelles par agent pour garder la consommation sous contrôle.

• Les tests en phase de construction ne consomment pas de crédits.

Notre conseil : avant de déployer un agent sur l'ensemble d'une base, mesurez sa consommation sur un échantillon et projetez-la sur le volume réel. Un agent déclenché sur chaque contact créé n'a pas le même coût qu'un agent lancé à la demande par un commercial.

Estimez votre consommation avant de déployer. Notre simulateur de crédits HubSpot convertit vos volumes (conversations, leads, fiches enrichies, exécutions d'agents personnalisés) en crédits, les compare à ce qui est inclus dans votre abonnement et chiffre le dépassement. L'analyse peut vous être envoyée en PDF.

Quels abonnements faut-il ?

D'après la documentation HubSpot (mise à jour d'octobre 2026), Agent Builder est accessible avec Marketing, Sales, Service, Data et Content Hub en éditions Starter, Professional et Enterprise, et avec Smart CRM en Professional et Enterprise. Les workflows agentiques demandent une édition Professional ou Enterprise.

Côté paramétrage, un Super Admin doit activer les outils d'IA générative et l'accès aux données nécessaires (CRM, conversations, fichiers) dans les paramètres IA. Pour créer un agent, il faut être Super Admin ou disposer de la permission Agent Builder. Et un agent ne peut utiliser que ce à quoi l'utilisateur a lui-même accès.

La disponibilité varie selon les fonctionnalités et évolue souvent : vérifiez toujours dans votre portail avant de planifier un déploiement.

Les points de vigilance

• C'est encore une bêta. Les écrans, les noms et les règles de facturation bougent régulièrement. Ce qui est vrai aujourd'hui peut changer au prochain trimestre.

• Un agent reflète la qualité de vos données. Propriétés mal renseignées, doublons, étapes de pipeline floues : l'agent les reproduira à grande échelle. Le nettoyage et la structuration passent avant l'automatisation.

• Un agent peut se tromper. Même avec le bon contexte, il peut mal interpréter une fiche ou inventer une information. Testez sur des cas réels, prévoyez une validation humaine sur les actions sensibles, et ne l'exposez pas directement à vos clients sans phase d'observation.

• Les droits sont un sujet à part entière. Qui peut modifier l'agent, qui peut le lancer, quels outils d'écriture lui sont ouverts : à décider avant la mise en production, pas après.

• Le coût se pilote. Sans limite d'exécution, un agent mal déclenché peut consommer beaucoup de crédits en peu de temps.

Notre approche chez Yuzu Corp

Un agent IA ne corrige pas un processus mal défini : il l'accélère. Avant de construire, on commence toujours par trois questions. Quelle tâche, précisément, fait perdre du temps à vos équipes ? Quelles données l'agent doit-il lire, et sont-elles fiables ? Qui valide ce qu'il produit ?

C'est seulement ensuite qu'on conçoit l'agent : des instructions courtes et testables, un périmètre d'outils minimal, des knowledge vaults propres, une phase de test sur vos vrais dossiers, et un suivi de la consommation. Construire moins d'agents, mais des agents qui servent vraiment.

Partenaire HubSpot Diamond, Yuzu Corp a déployé plus de 20 agents IA chez ses clients en 2026. Si vous voulez identifier les deux ou trois agents qui auraient le plus d'impact dans votre organisation, parlons-en.

FAQ

Agent Builder et Breeze Studio, c'est la même chose ?

Oui. Breeze Studio a été renommé Agent Builder le 23 juillet 2026, lors de la réorganisation de l'offre IA de HubSpot autour d'Agent Hub.

Faut-il savoir coder pour utiliser Agent Builder ?

Non. Les agents se configurent en langage courant, et Breeze Assistant peut même proposer une première configuration à partir d'une simple description. La connexion à des systèmes externes via MCP peut en revanche demander un accompagnement technique.

Un agent peut-il modifier mes données CRM ?

Oui, si vous lui donnez l'outil d'écriture dans les fiches CRM. C'est pourquoi il faut limiter ses outils au strict nécessaire et prévoir une validation humaine pour les actions sensibles.

Les tests consomment-ils des crédits ?

Non, HubSpot permet de tester un agent sans consommer de crédits. Les exécutions réelles, elles, en consomment.

Quelle différence entre un agent et un workflow agentique ?

L'agent est l'unité qui accomplit une tâche. Le workflow agentique est un workflow HubSpot qui enchaîne des déclencheurs, des actions classiques et un ou plusieurs agents pour automatiser un processus complet.

Sources

• HubSpot Knowledge Base : Create and customize agents in the agent builder

• HubSpot Knowledge Base : Understand Agent Hub

• HubSpot Knowledge Base : Manage Breeze context with knowledge vaults

• HubSpot Spotlight, automne 2026

• Small Business Trends : HubSpot unveils Agent Hub and Builder

• HubSpot : Product & Services Catalog (HubSpot Credits)

Article à jour en octobre 2026. Agent Builder étant en bêta publique, certaines fonctionnalités peuvent évoluer.