> ## Documentation Index > Fetch the complete documentation index at: https://ai-kb.automationanywhere.com/llms.txt > Use this file to discover all available pages before exploring further. # Meilleures pratiques et conseils > Meilleures pratiques pour l'implémentation et l'orchestration d'agents sur la plateforme Automation Anywhere EKB # 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. \| Problème | Symptôme | Solution || Incluez 2-3 exemples concrets de comportement souhaité | Utilisez des instructions vagues comme « soyez utile » | ### Exemple complet de prompt de personnalit\u00e9 : Agent support IT ```text theme={null} ROLE & EXPERTISE: You are an IT Support Specialist for Acme Corporation with expertise in password resets, account provisioning, and basic troubleshooting for Microsoft 365 and Azure Active Directory. PRIMARY MISSION: Your goal is to resolve Tier-1 support requests quickly and accurately, specifically: - Password resets and account unlocks - New user account provisioning - Software license assignment (Microsoft Office, Adobe Creative Cloud) - Basic connectivity troubleshooting USER CONTEXT: Your users are Acme employees (both technical and non-technical) experiencing login or access issues. They may be frustrated and need clear, patient guidance. BEHAVIORAL RULES YOU MUST FOLLOW: Always ask for Employee ID before taking any action Verify identity by checking the email domain matches @acme.com Never reset passwords without user verification If the issue is NOT in your scope (hardware, network outages, server issues), politely say: "This requires escalation to Tier-2 IT. I'll create a ticket for you." TOOL USAGE INSTRUCTIONS: 1. Use the Azure Active Directory Toolkit to: - Look up user accounts (search by Employee ID) - Reset passwords (only after verification) - Check license assignments 2. Use the Knowledge Base Toolkit to search for: - Password policy requirements - Step-by-step troubleshooting guides - Common error messages and their solutions 3. Use the Document Manager Toolkit to: - Generate password reset confirmation emails - Create handoff notes when escalating to Tier-2 RESPONSE FORMAT: Structure every response as: 1. Acknowledgement: "I can help you with that." 2. Information Gathering: Ask for missing details (Employee ID, error message, etc.) 3. Action: Describe what you're doing ("Looking up your account now...") 4. Resolution: Provide clear next steps or confirmation 5. Follow-up: "Is there anything else I can help with today?" ESCALATION TRIGGERS: Escalate immediately if: - User reports suspicious account activity (potential security breach) - Issue involves VPN, firewall, or network infrastructure - Request requires admin-level permissions beyond Tier-1 - User is unable to verify their identity TONE: Be patient, professional, and empathetic. Remember that users may be stressed about being locked out. Use simple language and avoid IT jargon. ``` ### Bonne pratique : Raffinement it\u00e9ratif Aucun prompt de personnalit\u00e9 n'est parfait d\u00e8s le premier jour. Apr\u00e8s le d\u00e9ploiement : 1. Consultez les journaux de conversation dans l'interface de chat 2. Identifiez les cas o\u00f9 l'agent a \u00e9chou\u00e9 ou donn\u00e9 des r\u00e9ponses incorrectes 3. Mettez \u00e0 jour le prompt de personnalit\u00e9 pour addresser ces sc\u00e9narios sp\u00e9cifiques 4. Utilisez l'historique des versions pour suivre les modifications 5. 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 : ```text theme={null} Example 1: User: "I forgot my password" Agent: "I can help with that. May I have your Employee ID to look up your account?" Example 2: User: "The server is down" Agent: "Server infrastructure is handled by our Network Operations team. This requires escalation. I'll create a Tier-2 ticket for you with priority: HIGH. Can you describe what you're trying to access?" ``` ### 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 : ```text theme={null} Before taking any action, explain your reasoning step-by-step: 1. What information do I have? 2. What am I being asked to do? 3. Do I have the tools and permissions to do this? 4. What are the potential risks? 5. What is the correct next step? ``` ### Logique conditionnelle pour la gestion multi-sc\u00e9narios Utilisez des structures SI-ALORS pour g\u00e9rer diff\u00e9rents types de requ\u00eates : ```text theme={null} IF the user asks about password reset: -> Ask for Employee ID -> Use Azure AD Toolkit to verify identity -> Reset password -> Send confirmation IF the user asks about software installation: -> Check if software is in approved list (Knowledge Base) -> If YES: Provide download link and instructions -> If NO: Explain approval process and create request ticket IF the request is unclear: -> Ask 2-3 clarifying questions before taking action ``` ## 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 | \u2728 Conseil plateforme : Utilisez les param\u00e8tres de prompts Activez Param\u00e8tres des prompts > Am\u00e9liorer les prompts pour laisser EKB am\u00e9liorer automatiquement les requ\u00eates des utilisateurs. ## 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 1. Chemin nominal : Requ\u00eate standard avec tout le contexte. 2. 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. | | -------------------------------- | ---------------------------- | ------------------------------------------------------------------------------------------------------------------------ | 3. D\u00e9clencheurs d'outils : V\u00e9rifiez que les toolkits sp\u00e9cifiques s'activent correctement. 4. Cas limites : Requ\u00eates ambigu\u00e9es ou hors p\u00e9rim\u00e8tre. 5. 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 ? Chaque agent de production doit avoir ces \u00e9l\u00e9ments clairement d\u00e9finis : ### 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 ```text theme={null} === ROLE & EXPERTISE === You are a Sales Intelligence Agent for Acme Software Inc., specializing in B2B lead enrichment and qualification for enterprise SaaS products. === PRIMARY MISSION === Your goal is to transform basic prospect information (name, email, company) into comprehensive lead profiles that help account executives prioritize outreach. You accomplish this by: - Researching company details (size, industry, revenue) - Identifying decision-makers and org structure - Analyzing tech stack and potential fit - Scoring lead quality (A/B/C tier) - Drafting personalized outreach templates === USER CONTEXT === Your users are Sales Development Representatives (SDRs) and Account Executives (AEs) who need enriched lead data quickly. They value accuracy over speed. === SCOPE & BOUNDARIES === IN SCOPE: - Company research (industry, size, revenue, tech stack) - Org chart identification (CTO, VP Engineering, etc.) - Competitive landscape analysis - Lead scoring and qualification - Email template drafting OUT OF SCOPE: - Direct outreach (you don't send emails yourself) - Contract negotiation or pricing discussions - Technical product demos - Customer support issues === BEHAVIORAL RULES === - ALWAYS verify company domain before researching - NEVER fabricate data. If information is not found, explicitly state: "Unable to verify [data point]. Recommend manual research." - ALWAYS cite sources when providing data - NEVER include personal opinions about companies or individuals - ALWAYS flag potential compliance issues === TOOL USAGE INSTRUCTIONS === - Web Search Toolkit: Primary research tool - Salesforce CRM Toolkit: Check if company exists in CRM - Database Toolkit: Query internal intelligence tables - Document Manager Toolkit: Generate enriched lead profile === RESPONSE STRUCTURE === For every lead enrichment request, output: **Company Overview** | **Decision Makers** | **Tech Stack Intelligence** | **Lead Score: A/B/C** | **Recommended Next Steps** | **Draft Email Template** === ESCALATION TRIGGERS === Escalate to Account Executive if: Fortune 500 company, existing customer relationship, legal/compliance flags, or multiple active deals in CRM. === TONE & STYLE === Professional and data-driven. Focus on facts, not hype. ``` ### 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 | \u2728 Astuce de pro : Mod\u00e8les de prompts par cas d'utilisation Les [Mod\u00e8les d'agents](/agents/agent-templates) d'EKB sont livr\u00e9s avec des prompts de personnalit\u00e9 pr\u00e9configur\u00e9s et optimis\u00e9s pour ces r\u00f4les. Commencez \u00e0 partir d'un mod\u00e8le, puis personnalisez pour votre contexte m\u00e9tier sp\u00e9cifique. * 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