​

1. Meilleures pratiques pour l’impl\u00e9mentation et l’orchestration

​

Planification strat\u00e9gique

​

Identifier les cas d’utilisation \u00e0 forte valeur

• 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

​

Mod\u00e8les de conception d’agents

​

Strat\u00e9gie de base de connaissances

• 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

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

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)

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)

• \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)

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

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

​

Orchestration des outils et toolkits

• 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

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

• 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.

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 ?

​

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

=== 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

• 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