Concepts de base

HeartBeatAgents s'articule autour de quelques concepts fondamentaux. Les comprendre vous aidera à concevoir des agents efficaces et à tirer le meilleur parti de la plateforme.

Agents

Un agent est une entité IA autonome avec un rôle, une personnalité et un ensemble de capacités définis. Chaque agent dispose d'un fournisseur et d'un modèle de LLM principal, d'ordres permanents qui régissent son comportement, d'un accès à des outils et canaux spécifiques, et de son propre espace mémoire. Les agents fonctionnent de manière indépendante, et vous pouvez en exécuter plusieurs, chacun spécialisé pour une fonction différente (support, ventes, ingénierie, etc.).

Propriétés clés : nom, description, fournisseur, modèle, ordres permanents, niveau d'autonomie (supervisé, semi-autonome, entièrement autonome), statut (actif, en pause, archivé).

Conversations

Une conversation est un fil de messages entre un utilisateur et un agent. Les conversations conservent leur état sur plusieurs tours et peuvent s'étendre sur des heures, des jours, voire des semaines. Chaque conversation appartient à un agent précis et est associée à un canal précis : l'unité principale d'interaction, et la source de la mémoire épisodique.

Propriétés clés : identifiant de conversation, identifiant d'agent, canal, identités des participants, historique des messages, statut (active, résolue, escaladée), métadonnées.

Outils

Les outils sont des capacités discrètes qu'un agent peut invoquer pendant une conversation. Chaque outil a un nom, une description (que le LLM lit pour comprendre quand l'utiliser), des paramètres d'entrée et un gestionnaire d'exécution. Les outils sont fournis par les intégrations : connectez une intégration Stripe, et des outils comme stripe_get_customer et stripe_create_refund deviennent disponibles.

Propriétés clés : nom de l'outil, description, schéma des paramètres, source d'intégration, permissions requises, limites de débit.

Planification

Un objectif formulé en langage naturel est décomposé en une séquence d'étapes ordonnées selon leurs dépendances, qui vous est présentée pour approbation, modification ou rejet, avant toute exécution. Voir Planification.

Aperçu en direct

Un agent peut exécuter un véritable serveur de développement ou un processus de longue durée à l'intérieur de son espace de travail isolé (sandbox) et vous renvoyer un aperçu en direct et fonctionnel, pas une simple description. Voir Aperçu en direct.

Délégation

Un agent peut confier une sous-tâche à un autre agent auquel il a été autorisé à accéder et récupérer le résultat, de la même manière qu'une personne délègue à un collègue. Voir Délégation.

Mémoire

La mémoire offre aux agents une continuité entre les conversations, sous la forme de trois types :

• Épisodique : stocke l'historique des conversations. Permet aux agents de se rappeler des interactions précédentes.
• Sémantique : stocke les faits et connaissances extraits : préférences, informations de compte, décisions.
• Procédurale : stocke les schémas de comportement appris, pour que les agents réutilisent les processus multi-étapes ayant réussi pour des types de tâches récurrents.

Tous les types de mémoire utilisent des embeddings vectoriels pour la récupération, si bien que les agents retrouvent les souvenirs pertinents par similarité sémantique, pas seulement par correspondance de mots-clés.

Canaux

Les canaux sont les plateformes de communication où les agents interagissent avec les utilisateurs : plus de 20 pris en charge, dont Slack, Discord, Microsoft Teams, Telegram, WhatsApp, SMS, e-mail et chat web. Chaque canal dispose de son propre adaptateur qui normalise les messages dans un format standard ; un agent peut être connecté à plusieurs canaux simultanément, les conversations conservant leur contexte quel que soit le canal sur lequel elles ont lieu. Voir le Guide des canaux pour la liste complète et les étapes de configuration.

Voix

La voix est une conversation parlée en temps réel avec un agent dans le navigateur, distincte des canaux textuels ci-dessus. Elle nécessite un projet LiveKit (transport) et un fournisseur vocal (Deepgram ou ElevenLabs) connectés avant de fonctionner. Voir Voix et Configuration de la voix.

Intégrations

Les intégrations connectent un agent à des services externes, généralement via une authentification OAuth 2.0. Connecter une intégration découvre et expose automatiquement ses outils à vos agents : Google Workspace, Microsoft 365, GitHub, Jira, HubSpot, Salesforce, Stripe, Notion, et plus encore. Voir le Guide des intégrations pour le catalogue complet et le modèle de sécurité.

Ordres permanents

Les ordres permanents sont des instructions persistantes qui définissent le comportement d'un agent à travers toutes ses conversations. Contrairement à une simple invite système, ils sont structurés (définitions de rôle, règles de comportement, limites de connaissance, politiques d'escalade, limites opérationnelles) et versionnés, ce qui permet d'annuler une modification produisant un comportement indésirable. C'est le facteur individuel le plus déterminant pour la qualité d'un agent.

Propriétés clés : texte de l'ordre, numéro de version, date de création, statut actif, agent associé, historique des modifications.

À voir aussi

• Référence API : invoquer des agents et interroger la mémoire par programmation
• Première configuration : créer votre premier agent