Écrire des instructions efficaces pour les agents déclaratifs

Les agents déclaratifs sont des versions personnalisées de Microsoft 365 Copilot qui vous aident à créer des expériences personnalisées en déclarant des instructions, des actions et des connaissances spécifiques. Pour écrire des instructions efficaces pour votre agent déclaratif, posez-vous les questions suivantes :

• Quel est l’objectif que votre agent doit atteindre ?
• Quels flux de travail envisagez-vous pour vos utilisateurs finaux ?
  • Y a-t-il une logique métier que vous souhaitez incorporer ?
  • Y a-t-il une expérience utilisateur souhaitée que vous souhaitez incorporer ?
• Pour chaque workflow, pouvez-vous fournir des instructions pas à pas pour l’agent ?

Si votre agent déclaratif a également des plug-ins d’API en tant qu’actions, le document OpenAPI de votre plug-in aide l’agent à comprendre toutes les instructions faisant référence à l’API. Pour plus d’informations, consultez Comment rendre un document OpenAPI efficace dans l’extension de Copilot.

Ce guide s’applique aux développeurs et aux créateurs qui utilisent microsoft 365 Agents Toolkit ou Copilot Studio pour créer des agents déclaratifs.

Composants d’instruction

Un ensemble bien structuré d’instructions garantit que l’agent comprend son rôle, les tâches qu’il doit effectuer et comment interagir avec les utilisateurs. Voici les principaux composants des instructions de l’agent déclaratif :

• Objectif
• Instructions générales, y compris les instructions générales, le ton et les restrictions
• Skills

En outre, le cas échéant, les instructions sont les suivantes :

• Instructions détaillées
• Gestion des erreurs et limitations
• Commentaires et itération
• Exemples d’interaction
• Termes non standard
• Suivi et fermeture

Le diagramme suivant montre les principaux composants des instructions de l’agent déclaratif.

Meilleures pratiques pour les instructions de l’agent

Utiliser un langage actionnable clair

• Concentrez-vous sur ce que Copilot doit faire, et non sur ce qu’il faut éviter.
• Utilisez des verbes précis et spécifiques, tels que « demander », « rechercher », « envoyer », « case activée » ou « utiliser ».
• Complétez avec des exemples pour réduire l’ambiguïté.
• Définissez tous les termes non standard ou propres au organization dans les instructions.

Créer des workflows pas à pas avec des transitions

Divisez les flux de travail en étapes modulaires, non ambiguës et sans ambiguïté. Chaque étape doit inclure :

• Objectif : objectif de l’étape.
• Action : ce que l’agent doit faire et les outils à utiliser.
• Transition : effacez les critères pour passer à l’étape suivante ou mettre fin au workflow.

Instructions de structure dans Markdown

Pour mettre l’accent et clarifier l’ordre des étapes, utilisez Markdown.

• Utilisez #, ##et ### pour les en-têtes de section.
• Utilisez - pour les listes non triées et 1. pour les listes numérotées. Utilisez des listes non triées, sauf si l’ordre des étapes est important, auquel cas utilisez des listes numérotées.
• Mettez en surbrillance les noms des outils ou des systèmes (par exemple, Jira, ServiceNow, Teams) à l’aide de backticks (''''').
• Mettent les instructions critiques en gras avec **.

Référencer explicitement les fonctionnalités, les connaissances et les actions

Appelez clairement les noms des actions, des fonctionnalités ou des sources de connaissances impliquées à chaque étape.

• Actions : par exemple, « Utiliser Jira pour récupérer des tickets ».
• Connaissance du connecteur Copilot : par exemple, « Utiliser pour les ServiceNow KB articles d’aide ».
• Connaissances SharePoint : par exemple, « Référencer des documents internes SharePoint ou OneDrive ».
• Email messages : par exemple, « Vérifier les e-mails des utilisateurs pour obtenir des informations pertinentes ».
• Messages Teams : par exemple, « Rechercher dans l’historique des conversations Teams ».
• Interpréteur de code : par exemple, « Utiliser l’interpréteur de code pour générer des graphiques à barres ou en secteurs ».
• Personnes connaissances : par exemple, « Utiliser la connaissance des personnes pour récupérer les e-mails des utilisateurs ».

Fournir des exemples

Les exemples aident l’agent à comprendre les instructions.

• Pour les scénarios simples, vous n’avez pas besoin de donner d’exemples.
• Pour les scénarios complexes, les agents déclaratifs fonctionnent mieux avec des invites à quelques séquences. Autrement dit, donnez plusieurs exemples pour illustrer différents aspects ou cas de périphérie.

Éviter les échecs d’invite courants

Soyez conscient de ces pièges et de leurs solutions.

• Utilisation excessive des outils
  • Problème : le modèle appelle des outils sans entrées nécessaires.
  • Solution : ajoutez l’instruction « Appeler l’outil uniquement si des entrées nécessaires sont disponibles ; sinon, demandez à l’utilisateur. »
• Formulation répétitive
  • Problème : Le modèle réutilise l’exemple de formulation textuelle.
  • Solution : Encouragez les réponses variées et le langage naturel. Envisagez d’ajouter plusieurs exemples au lieu d’un seul (invite à quelques coups). Essayez de supprimer l’exemple pour économiser sur les jetons.
• Explications détaillées
  • Problème : le modèle sur-explique ou fournit une mise en forme excessive.
  • Solution : Pour limiter le détail ou la mise en forme, ajoutez des contraintes et des exemples concis.

Itérer sur vos instructions

Le développement d’instructions pour les agents déclaratifs est souvent itératif et se compose généralement des étapes suivantes.

1. Créez des instructions et des démarreurs de conversation pour votre agent en suivant la structure et le format décrits dans cet article.
2. Publiez votre agent. Les pratiques d’IA responsable (RAI) sont intégrées au processus de validation pour garantir que les agents respectent les normes éthiques. Pour plus d’informations, reportez-vous aux rubriques suivantes :
   • Validation RAI
   • Outils et pratiques RAI
   • Applications alimentées par l’intelligence artificielle
3. Testez votre agent.
   1. Pour vérifier que l’agent apporte une valeur ajoutée lors de la réponse, comparez les résultats à Microsoft 365 Copilot.
   2. Vérifiez que les démarreurs de conversation fonctionnent comme prévu avec les instructions pas à pas.
   3. Vérifiez que l’agent agit conformément aux instructions fournies.
   4. Vérifiez que les invites de l’utilisateur en dehors des démarrages de conversation sont gérées de manière appropriée.
4. Effectuez une itération sur les instructions pour déterminer si vous pouvez améliorer la sortie.
   • Modifiez les instructions pour modifier le comportement de l’agent.
   • Essayez d’ajouter des connaissances telles que la recherche web, OneDrive/SharePoint ou des connecteurs Microsoft 365 Copilot, si nécessaire à l’aide du Kit de ressources Agents ou de Copilot Studio.

Le diagramme suivant illustre le processus itératif de création et d’affinement des instructions de l’agent déclaratif.

Exemples d’instructions

Les exemples d’instructions suivants concernent un agent qui peut vous aider à résoudre les problèmes informatiques courants.

# OBJECTIVE
Guide users through issue resolution by gathering information, checking outages, narrowing down solutions, and creating tickets if needed. Ensure the interaction is focused, friendly, and efficient.

# RESPONSE RULES
- Ask one clarifying question at a time, only when needed.
- Present information as concise bullet points or tables.
- Avoid overwhelming users with details or options.
- Always confirm before moving to the next step or ending.
- Use tools only if data is sufficient; otherwise, ask for missing info.

# WORKFLOW

## Step 1: Gather Basic Details
- **Goal:** Identify the user's issue.
- **Action:**
  - Proceed if the description is clear.
  - If unclear, ask a single, focused clarifying question.
    - Example:
      User: "Issue accessing a portal."
      Assistant: "Which portal?"
- **Transition:** Once clear, proceed to Step 2.

## Step 2: Check for Ongoing Outages
- **Goal:** Rule out known outages.
- **Action:**
  - Query `ServiceNow` for current outages.
  - If an outage is found:
    - Share details and ETA.
    - Ask: "Is your issue unrelated? If yes, I can help further."
    - If yes, go to Step 3. If no/no response, end politely.
  - If none, inform the user and go to Step 3.

## Step 3: Narrow Down Resolution
- **Goal:** Find best-fit solutions from the knowledge base.
- **Action:**
  - Search `ServiceNow KB` for related articles.
  - **Iterative narrowing:** Don't list all results. Instead:
    - Ask clarifying questions based on article differences.
    - Eliminate irrelevant options with user responses.
    - Repeat until the best solution is found.
  - Provide step-by-step fix instructions.
  - Confirm: "Did this help? If not, I can go deeper or create a ticket."
    - If more info is provided, repeat this step.
    - If ticket needed, go to Step 4.
    - If resolved/no response, end politely.

## Step 4: Create Support Ticket
- **Goal:** Log unresolved issues.
- **Action:**
  1. Map **category** and **subcategory** from the `sys_choice` SharePoint file.
     - Use only valid pairs. Leave blank if not clear.
  2. Fetch user's UPN (email) with the people capability.
  3. Fill the ticket with:
     - Caller ID (email)
     - Category, Subcategory (if mapped)
     - Description, attempted steps, error codes, metadata
- **Transition:** Confirm ticket creation and next steps.

# OUTPUT FORMATTING RULES
- Use bullets for actions, lists, next steps.
- Use tables for structured data where UI allows.
- Avoid long paragraphs; keep responses skimmable.
- Always confirm before ending or submitting tickets.

# EXAMPLES

## Valid Example
**User:** "I can't connect to VPN."
**Assistant:**
- "Are you seeing a specific error?"
  (User: "DNS server not responding.")
- "Let me check for outages."
  (No outage.)
- "No outages. Searching knowledge base…"
  (Finds articles. Asks: "Are you on office Wi-Fi or home?")
  (User: "Home.")
- "Try resetting your DNS settings. Here's how…"
- "Did this help? If not, I can create a support ticket."

## Invalid Example
- "Here are 15 articles I found…" *(Overwhelms the user)*
- "I'm raising a ticket" *(without confirming details)*

Contenu connexe

• Pour obtenir un exemple de fichier manifeste pour un agent déclaratif créé avec Agents Toolkit, consultez Exemple de manifeste d’agent déclaratif.
• Pour plus d’informations sur l’utilisation de Copilot Studio pour créer des agents déclaratifs, consultez Étendre avec des agents.
• Pour plus d’informations sur les exigences de validation pour les agents déclaratifs, consultez Instructions de validation pour les agents.