1. Meilleures pratiques pour l’impl\u00e9mentation et l’orchestration
Le d\u00e9ploiement r\u00e9ussi d’agents sur la plateforme EKB n\u00e9cessite une planification strat\u00e9gique et le respect des meilleures pratiques d’orchestration.Planification strat\u00e9gique
Identifier les cas d’utilisation \u00e0 forte valeur
Exploitez les capacit\u00e9s de la plateforme en ciblant les secteurs o\u00f9 les agents EKB excellent :- Finance : agents interrogeant des bases SQL pour des rapports P&L et des analyses de risque.
- RH : agents \u00ab Resume Screener \u00bb analysant des PDF et r\u00e9digeant des e-mails.
- D\u00e9veloppement logiciel : agents \u00ab PR Reviewer \u00bb pour l’analyse de code et la documentation.
- Ventes : agents \u00ab Lead Enrichment \u00bb int\u00e9grant Web Search et Salesforce.
- Support client : agents de support de niveau 1 avec acc\u00e8s ERP et base de connaissances.
D\u00e9finir le p\u00e9rim\u00e8tre de l’agent
| P\u00e9rim\u00e8tre | Description | Configuration EKB |
|---|---|---|
| Mono-fonction | G\u00e8re un workflow sp\u00e9cifique (par ex., r\u00e9initialisation de mot de passe) | Prompt de personnalit\u00e9 cibl\u00e9, toolkit unique |
| Multi-d\u00e9partement | Couvre les t\u00e2ches d’\u00e9quipe (par ex., g\u00e9n\u00e9raliste RH) | Collections de connaissances multiples, Workflow Manager |
| Assistant d’entreprise | D\u00e9l\u00e8gue \u00e0 des agents sp\u00e9cialis\u00e9s | Utilise le toolkit de communication inter-agents pour la d\u00e9l\u00e9gation multi-agents |
Mod\u00e8les de conception d’agents
Mod\u00e8le 1 : Sp\u00e9cialiste unique Un agent d\u00e9di\u00e9 \u00e9quip\u00e9 de connaissances approfondies dans un domaine sp\u00e9cifique et d’outils cibl\u00e9s. Par exemple, un agent \u00ab Data Analyst \u00bb configur\u00e9 avec le toolkit Base de donn\u00e9es et le toolkit d’ex\u00e9cution de code Python. Mod\u00e8le 2 : Syst\u00e8mes multi-agents Utilisez le toolkit de communication inter-agents pour cr\u00e9er un syst\u00e8me o\u00f9 un \u00ab Agent manager \u00bb d\u00e9compose les requ\u00eates complexes et d\u00e9l\u00e8gue les t\u00e2ches \u00e0 des \u00ab Agents ex\u00e9cutants \u00bb sp\u00e9cialis\u00e9s. Cela assure la s\u00e9paration des responsabilit\u00e9s et une meilleure pr\u00e9cision pour les flux de travail complexes.Strat\u00e9gie de base de connaissances
Le toolkit Base de connaissances alimente la g\u00e9n\u00e9ration augment\u00e9e par la recherche (RAG). Pour optimiser les performances :- D\u00e9coupage : La plateforme g\u00e8re le d\u00e9coupage, mais une structure de document claire am\u00e9liore la r\u00e9cup\u00e9ration.
- Versionnement : Supprimez les documents obsol\u00e8tes pour \u00e9viter les r\u00e9ponses contradictoires.
Exemple complet de prompt de personnalit\u00e9 : Agent support IT
Bonne pratique : Raffinement it\u00e9ratif
Aucun prompt de personnalit\u00e9 n’est parfait d\u00e8s le premier jour. Apr\u00e8s le d\u00e9ploiement :- Consultez les journaux de conversation dans l’interface de chat
- Identifiez les cas o\u00f9 l’agent a \u00e9chou\u00e9 ou donn\u00e9 des r\u00e9ponses incorrectes
- Mettez \u00e0 jour le prompt de personnalit\u00e9 pour addresser ces sc\u00e9narios sp\u00e9cifiques
- Utilisez l’historique des versions pour suivre les modifications
- R\u00e9p\u00e9tez mensuellement pour une am\u00e9lioration continue
Techniques avanc\u00e9es d’ing\u00e9nierie de prompts
Exemples Few-Shot (apprentissage en contexte)
Incluez 2-3 exemples d’interactions directement dans votre prompt de personnalit\u00e9 pour d\u00e9montrer le comportement souhait\u00e9 :Contraintes n\u00e9gatives (ce qu’il ne faut PAS faire)
Listez explicitement les comportements interdits pour r\u00e9duire les hallucinations et les erreurs :- \u00ab N’inventez jamais d’informations sur un employ\u00e9 s’il n’est pas trouv\u00e9. Dites : ‘Je ne trouve pas cet ID employ\u00e9. Veuillez v\u00e9rifier et r\u00e9essayer.’ \u00bb
- \u00ab Ne fournissez jamais d’instructions de r\u00e9initialisation de mot de passe pour des comptes que vous ne pouvez pas v\u00e9rifier. \u00bb
- \u00ab N’assumez jamais les permissions. En cas de doute, escaladez. \u00bb
Raisonnement par \u00e9tapes (Chain-of-Thought)
Instructez l’agent \u00e0 expliquer son processus de raisonnement pour la transparence :Logique conditionnelle pour la gestion multi-sc\u00e9narios
Utilisez des structures SI-ALORS pour g\u00e9rer diff\u00e9rents types de requ\u00eates :Tester votre prompt de personnalit\u00e9
Utilisez l’interface de chat pour tester ces sc\u00e9narios avant le d\u00e9ploiement :| Sc\u00e9nario de test | Comportement attendu | Validation |
|---|---|---|
| Chemin nominal | L’utilisateur fournit toutes les infos ; l’agent termine la t\u00e2che avec succ\u00e8s | La fonctionnalit\u00e9 de base fonctionne |
| Informations manquantes | L’agent pose des questions de clarification au lieu d’assumer | Logique de collecte d’informations |
| Demande hors p\u00e9rim\u00e8tre | L’agent d\u00e9cline poliment et explique pourquoi | Application des limites |
| Requ\u00eate ambigu\u00e9 | L’agent demande des pr\u00e9cisions avant d’agir | Garde-fous de s\u00e9curit\u00e9 |
| D\u00e9faillance d’outil | L’agent explique le probl\u00e8me et sugg\u00e8re des alternatives | Gestion des erreurs |
| D\u00e9clencheur d’escalade | L’agent identifie correctement le besoin d’intervention humaine | Logique d’escalade |
Orchestration des outils et toolkits
S\u00e9lectionnez les toolkits EKB appropri\u00e9s pour \u00e9tendre les capacit\u00e9s de l’agent :- Toolkit Base de connaissances : R\u00e9cup\u00e9ration RAG \u00e0 partir de documents propri\u00e9taires.
- Toolkit Recherche web : Acc\u00e8s \u00e0 des informations en temps r\u00e9el.
- Toolkit Base de donn\u00e9es : Interrogation de bases de donn\u00e9es SQL et Smart Tables.
- Toolkits Python/Node.js : Sandboxes d’ex\u00e9cution de code s\u00e9curis\u00e9es.
- Toolkit Gestionnaire de documents : Cr\u00e9ation et modification de documents dans le chat.
- Toolkit Smart Table Manager : Gestion de donn\u00e9es interne de type NoSQL.
- Toolkit Communication inter-agents : D\u00e9l\u00e9gation de t\u00e2ches \u00e0 d’autres agents.
- Toolkit Workflow Manager : Ex\u00e9cution de flux de travail d’automatisation d\u00e9terministes.
- Toolkit G\u00e9n\u00e9ration d’images : Cr\u00e9ation d’images avec DALL-E 3.
Workflow de test et it\u00e9ration
Utilisez le panneau central Chat/Canvas pour les tests it\u00e9ratifs. | Spécifiez les modèles d’utilisation exacts des outils | Comptez sur l’agent pour savoir quand utiliser les outils | | Définissez le format de réponse avec des sections numérotées | Laissez l’agent choisir sa propre structure de sortie | | Fixez des limites de longueur | Acceptez des réponses verbeuses ou incohérentes | | Utilisez des titres et une structure dans le prompt lui-même | Écrivez un long paragraphe sans organisation | | Versionnez via l’onglet Historique et itérez mensuellement | Configurez une fois et ne mettez jamais à jour | 💡 Astuce de pro : Modèles de prompts par cas d’utilisation- Chemin nominal : Requ\u00eate standard avec tout le contexte.
- Informations manquantes : L’agent pose-t-il des questions de clarification ? | Hallucination de données | Invente des informations | Instructez l’agent dans le prompt de personnalité de dire « Je ne sais pas » lorsque les informations manquent. | | Échec d’authentification d’outil | Erreur non autorisé | Vérifiez les identifiants dans les paramètres d’intégrations, contrôlez l’expiration des tokens et les portées. | Assurez-vous que votre agent est prêt pour le déploiement avec le cadre de vérification EKB.
- ✅ Vérification de la configuration : Prompts structurés, bon modèle sélectionné.
- ✅ Vérification de sécurité : Principe du moindre privilège appliqué, workflows d’approbation configurés.
- ✅ Vérification de test : Chemin nominal, cas limites et déclencheurs d’outils testés dans le chat.
- ✅ Documentation : Guides utilisateur et étapes de dépannage préparés.
6. Optimisation des performances
Stratégies d’amélioration continue pour maintenir l’efficacité des agents :- Ingénierie de prompt système : Affinez continuellement les prompts de personnalité basés sur les journaux d’interaction.
- Optimisation de la base de connaissances : Auditez régulièrement les documents, optimisez les tailles de fichiers et les conventions de nommage.
- Gestion du contexte et des tokens : Équilibrez la qualité des réponses avec le coût en gérant l’utilisation de la fenêtre de contexte.
- Utilisation des outils : Minimisez les appels inutiles, exploitez l’exécution parallèle quand c’est possible.
| L’agent n’utilise pas les outils | Répond « Je n’ai pas accès » | Vérifiez que l’outil est activé, que la description est claire et que le prompt encourage explicitement son utilisation. |
|---|
- D\u00e9clencheurs d’outils : V\u00e9rifiez que les toolkits sp\u00e9cifiques s’activent correctement.
- Cas limites : Requ\u00eates ambigu\u00e9es ou hors p\u00e9rim\u00e8tre.
- Latence : V\u00e9rifiez les performances sur des cha\u00eenes d’outils complexes.
- Ton et style : Formel ? Amical ? Technique ? Empathique ?
- Crit\u00e8res d’escalade : Quand d\u00e9l\u00e9guer \u00e0 un humain ou un agent sp\u00e9cialis\u00e9
- Structure des r\u00e9ponses : Comment les r\u00e9ponses doivent-elles \u00eatre format\u00e9es ?
- Directives d’utilisation des outils : Quand et comment utiliser les outils
- R\u00e8gles comportementales : Comportements obligatoires et interdits
- P\u00e9rim\u00e8tre et limites : Qu’est-ce que l’agent PEUT faire ? Qu’est-ce qui est HORS P\u00c9RIM\u00c8TRE ?
- Public cible : Qui interagira avec cet agent ?
- D\u00e9claration de mission : Quel est l’objectif principal de l’agent ?
Que mettre dans le prompt de personnalit\u00e9 ?
- Protection contre les injections de prompts : Validez les entr\u00e9es pour pr\u00e9venir les surcharges malveillantes.
- Journalisation d’audit : Activez la journalisation de toutes les actions pour la conformit\u00e9.
- Contr\u00f4les d’acc\u00e8s aux donn\u00e9es : Utilisez des acc\u00e8s bas\u00e9s sur les r\u00f4les et le masquage des donn\u00e9es personnelles.
- Principe du moindre privil\u00e8ge : N’accordez aux agents que les outils strictement n\u00e9cessaires.Respectez les meilleures pratiques de s\u00e9curit\u00e9 EKB :## Gouvernance et conformit\u00e9
Exemple concret : Agent d’enrichissement de leads commerciaux
R\u00e8gles d’or pour les prompts de personnalit\u00e9
| \u2705 \u00c0 FAIRE | \u274c \u00c0 \u00c9VITER |
|---|---|
| Soyez explicite sur ce que l’agent PEUT et NE PEUT PAS faire | Supposez que l’agent \u00ab comprendra tout seul \u00bb |
| Incluez 2-3 exemples concrets de comportement souhait\u00e9 | Utilisez des instructions vagues comme \u00ab soyez utile \u00bb |
| Sp\u00e9cifiez les mod\u00e8les d’utilisation exacts des outils | Comptez sur l’agent pour savoir quand utiliser les outils |
| D\u00e9finissez le format de r\u00e9ponse avec des sections num\u00e9rot\u00e9es | Laissez l’agent choisir sa propre structure de sortie |
| Fixez des limites de longueur | Acceptez des r\u00e9ponses verbeuses ou incoh\u00e9rentes |
| Utilisez des titres et une structure dans le prompt lui-m\u00eame | \u00c9crivez un long paragraphe sans organisation |
| Testez avec des cas limites avant le d\u00e9ploiement | D\u00e9ployez et croisez les doigts |
| Versionnez via l’onglet Historique et it\u00e9rez mensuellement | Configurez une fois et ne mettez jamais \u00e0 jour |
- Utilisation des outils : Minimisez les appels inutiles, exploitez l’ex\u00e9cution parall\u00e8le quand c’est possible.- Gestion du contexte et des tokens : \u00c9quilibrez la qualit\u00e9 des r\u00e9ponses avec le co\u00fbt en g\u00e9rant l’utilisation de la fen\u00eatre de contexte.- Optimisation de la base de connaissances : Auditez r\u00e9guli\u00e8rement les documents, optimisez les tailles de fichiers et les conventions de nommage.- Ing\u00e9nierie de prompt syst\u00e8me : Affinez continuellement les prompts de personnalit\u00e9 bas\u00e9s sur les journaux d’interaction.Strat\u00e9gies d’am\u00e9lioration continue pour maintenir l’efficacit\u00e9 des agents :# 6. Optimisation des performances- \u2705 Documentation : Guides utilisateur \u00e9tapes de d\u00e9pannage pr\u00e9par\u00e9s.- \u2705 V\u00e9rification de test : Chemin nominal, cas limites et d\u00e9clencheurs d’outils test\u00e9s dans le chat.- \u2705 V\u00e9rification de s\u00e9curit\u00e9 : Principe du moindre privil\u00e8ge appliqu\u00e9, workflows d’approbation configur\u00e9s.- \u2705 V\u00e9rification de la configuration : Prompts structur\u00e9s, bon mod\u00e8le s\u00e9lectionn\u00e9.Assurez-vous que votre agent est pr\u00eat pour le d\u00e9ploiement avec le cadre de v\u00e9rification EKB.## Liste de v\u00e9rification de pr\u00e9paration \u00e0 la production| \u00c9chec d’authentification d’outil | Erreur non autoris\u00e9 | V\u00e9rifiez les identifiants dans les param\u00e8tres d’int\u00e9grations, contr\u00f4lez l’expiration des tokens. || R\u00e9ponses lentes | Requ\u00eates > 10 secondes | V\u00e9rifiez la taille de la fen\u00eatre de contexte, optimisez la base de connaissances, utilisez l’ex\u00e9cution parall\u00e8le. || Hallucination de donn\u00e9es | Invente des informations | Instructez l’agent de dire \u00ab Je ne sais pas \u00bb lorsque les informations manquent. || L’agent n’utilise pas les outils | R\u00e9pond \u00ab Je n’ai pas acc\u00e8s \u00bb | V\u00e9rifiez que l’outil est activ\u00e9, que la description est claire et que le prompt encourage explicitement son utilisation. ||----------|----------|----------|| Probl\u00e8me | Sympt\u00f4me | Solution |### Probl\u00e8mes courants et solutions## Tests et d\u00e9pannage