Ajouter un assistant enfant

Un assistant enfant est un assistant léger qui existe dans le contexte de votre assistant principal. Les assistants enfants vous permettent de regrouper logiquement des outils, des instructions et des connaissances en sous-éléments clairement définis au sein d’un assistant plus grand. Ils sont parfaits pour les cas d’usage uniques qui répondent à une seule intention ou effectuent une seule tâche. Cet article explique comment créer et gérer un assistant enfant.

Créer un assistant enfant

1. Accédez à la page Agents de votre agent principal, puis sélectionnez Ajouter un agent.

2. Sélectionnez Nouvel assistant enfant.

3. Entrez un nom distinctif pour votre nouvel assistant enfant.

4. Déterminez quand votre assistant doit être utilisé. Par défaut, les assistants répondent aux utilisateurs ou aux déclencheurs en fonction de leur description.

   • Si vous souhaitez utiliser le comportement par défaut (l’assistant choisit - En fonction de la description), entrez une brève description de l’objectif de votre assistant.
   • Sinon, développez la liste sous Quand cela sera-t-il utilisé ? et sélectionnez le comportement souhaité. Pour plus d’informations sur les comportements pris en charge, consultez Déterminer quand utiliser votre assistant.

5. Entrez des instructions claires que vous souhaitez que votre agent suive lorsqu'il est invoqué. Pour référencer des outils, des variables ou ajouter des formules Power Fx dans vos instructions, entrez une barre oblique (/) et sélectionnez l’option souhaitée dans le menu qui s’affiche.

   Important

   Lorsque vous référez des outils existants dans vos instructions de sous-agent, décidez si l’outil doit être accessible directement par votre agent principal ou seulement lorsqu’il est explicitement appelé dans les instructions de sous-agent. Limiter l’utilisation d’un outil à des références d’instructions explicites aide à éviter la confusion des orchestrateurs lorsque des outils ou agents similaires existent. Par exemple, si vous avez un agent « Vérifier le solde de compte » et un outil similaire « Obtenir le solde de compte », limitez l'utilisation de l'outil à l’agent uniquement pour éviter le chevauchement. Pour limiter la disponibilité d’un outil uniquement lorsqu’il est référencé à partir d’un autre agent, désactivez l’agent Autoriser à décider dynamiquement quand utiliser cette propriété d’outil dans la section Détails supplémentaires de la page de détails de l’outil.

6. En option, ajoutez des connaissances et des outils que seul cet agent enfant peut utiliser :

   • Dans la section Connaissances , sélectionnez Ajouter et continuer de la même façon que lorsque vous ajoutez des connaissances à votre agent principal.
   • Dans la section Outils , sélectionnez Ajouter et continuer de la même façon que lorsque vous ajoutez des outils à votre agent principal.

7. Si vous ne souhaitez pas encore que cet agent soit actif, désactivez Activé. Vous pouvez activer l'agent pour enfants ultérieurement.

8. Cliquez sur Enregistrer.

Gérer les entrées et les sorties

Par défaut, un assistant enfant reçoit une tâche en langage naturel à accomplir à partir de l’assistant principal lorsque l’assistant l’appelle. Lorsqu’il termine sa tâche, il renvoie un résumé en langage naturel de ce qui s’est passé lors de son exécution. Dans certains cas, vous pouvez spécifier des valeurs d’entrée et de sortie plus explicites pour l’assistant.

Configurer les entrées et la collecte des entrées

1. Depuis la page Agents de votre agent parent, sélectionnez votre agent enfant.

2. Faites défiler jusqu’à la section Entrées .

3. Sélectionnez le bouton Ajouter une entrée pour ajouter une entrée. Définissez un Nom complet et Description, qui aident l’assistant à comprendre l’objectif de l’entrée de telle sorte qu’il peut compléter l’entrée avec une valeur pertinente lors de l’appel de cet assistant.

4. Sélectionnez un Type de données.

5. Si vous le souhaitez, sélectionnez Rendre cette entrée nécessaire pour exiger que l’entrée ait une valeur avant que l’assistant puisse être appelé.

6. Cliquez sur Enregistrer.

Configurations d’entrée avancées

Sélectionnez Avancé pour agrandir la section et voyez les autres réglages que vous pouvez configurer pour l’entrée.

Les paramètres avancés incluent les paramètres suivants liés à la manière dont l’agent remplit la valeur d’entrée lors de l’appel de l’agent enfant :

• Demande à l’utilisateur : Si ce paramètre est activé, l’agent demande explicitement à l’utilisateur final une valeur pour l’entrée si l’agent ne trouve pas la valeur dans le contexte disponible. C’est utile lorsque vous voulez vous assurer que l’agent obtient une valeur pour cette entrée, même si l’agent appelant n’en fournit pas ou n’a pas le contexte pertinent pour la remplir. Lorsque ce paramètre est activé, l’agent enfant génère une invite demandant à l’utilisateur les informations requises, ce qui peut aider à améliorer la précision de la réponse de l’agent.
• Invite - Personnaliser : Sélectionnez pour personnaliser une formulation spécifique de l'invite pour la collecte afin d'obtenir un contrôle accru et déterministe.
• Combien de re-demandes : Spécifiez combien de fois l’agent doit redemander à l’utilisateur une valeur pour cette entrée si la valeur fournie n’est pas valide. Cela est utile pour s’assurer que l’agent obtient une valeur valide pour cette entrée. Vous pouvez sélectionner jusqu’à deux relances.
• Invite de réessai - Personnaliser : Sélectionnez de personnaliser une formulation spécifique de l’invite pour les reprompts lorsque la valeur fournie ne satisfait pas les conditions spécifiées, pour un contrôle plus déterministe.
• Condition : Spécifier les conditions que l’entrée fournie doit satisfaire pour être considérée comme valide.
• Demande de condition non remplie : Personnalisez une formulation spécifique de l’invite pour demander à l’utilisateur une valeur différente lorsque la valeur fournie ne satisfait pas les conditions spécifiées.
• Action si aucune entité n’est trouvée : Spécifiez l’action que l’agent doit effectuer si celui-ci ne trouve pas de valeur pour cette entrée depuis le contexte disponible ou via les invitations. Choisissez d’escalader, de définir la variable à une valeur spécifique, ou de laisser la valeur vide.
• Message Aucune entité trouvée : Si vous choisissez de faire escalader l’agent lorsqu’aucune valeur n’est trouvée pour cette entrée, personnalisez le message que l’agent envoie à l’utilisateur.

Configurer les sorties des agents enfants et le comportement de complétion

Dans Sorties, vous pouvez configurer les valeurs de sortie que votre agent enfant renvoie à l’agent parent une fois terminé. Vous pouvez aussi configurer le comportement de l’agent parent une fois l’agent enfant terminé.

Configurer le comportement de l’agent parent après la fin de l’agent enfant

Vous pouvez spécifier le comportement de l’agent parent après que l’agent enfant ait terminé son exécution sous Après l’exécution dans la section Sorties :

• Ne répondez pas : Par défaut, l’agent parent poursuit l’étape suivante de son plan d’orchestration après que l’agent enfant a terminé et renvoyé toutes les sorties à l’agent parent. Vous pouvez également choisir que l’agent parent envoie un message à l’utilisateur immédiatement après la fin de l’agent enfant, avant de poursuivre l’étape suivante de son plan d’orchestration en sélectionnant l’une des autres options.
• Écrire la réponse avec l’IA générative : L’agent parent envoie un message à l’utilisateur avec une réponse IA générative immédiatement après la fin de l’agent enfant, en utilisant les sorties de l’agent enfant comme contexte pour la réponse.
• Envoyer une réponse spécifique : L’agent parent envoie un message spécifique à l’utilisateur immédiatement après la fin de l’agent enfant, indépendamment des sorties de l’agent enfant. Lorsque vous sélectionnez cette option, vous pouvez personnaliser le contenu du message.
• Envoyer une carte adaptative : L’agent parent envoie immédiatement une carte adaptative à l’utilisateur après la fin de l’agent enfant. Lorsque vous sélectionnez cette option, vous pouvez personnaliser le contenu adaptatif de la carte.

Configurer les sorties

1. Accédez aux détails de l’agent enfant.

2. Faites défiler jusqu’à la section Sorties .

3. Pour afficher la liste actuelle des sorties, développez la section Avancé dans la section Sorties.

4. Pour ajouter une sortie, sélectionnez Ajouter une sortie. Définissez un Nom d'affichage et une Description, qui aident l'assistant à comprendre l'objectif de la sortie, afin qu'il puisse la renseigner avec une valeur pertinente lors du renvoi des valeurs à l'agent appelant.

5. Sélectionnez un Type de données.

6. Cliquez sur Enregistrer.

Dans la section Sorties, vous pouvez également choisir d’envoyer un message à l’utilisateur immédiatement une fois votre assistant enfant terminé. Pour envoyer le message, modifiez la sélection Après exécution.

Déterminer quand utiliser votre assistant

Par défaut, les assistants enfants répondent à une requête utilisateur en fonction de leur description. Vous pouvez également configurer des assistants enfants pour intercepter d’autres événements et y répondre sous Quand cela sera-t-il utilisé ?.

Autres détails

Selon votre sélection pour Quand cela sera-t-il utilisé ?, d’autres propriétés peuvent être disponibles. Les propriétés suivantes sont toujours disponibles.

Condition

Spécifiez les conditions qui doivent être remplies pour que l’assistant soit appelé. Par exemple, vous souhaiterez peut-être que l’agent soit appelé uniquement si le canal utilisé par un employé est Microsoft Teams.

Si vous avez besoin de conditions plus complexes, vous pouvez passer à l’éditeur de formules Power Fx : sélectionnez Générateur, puis sélectionnez Formule.

Priorité

Plusieurs assistants peuvent s’exécuter pour une seule activité entrante telle qu’un message. Par défaut, l’option que vous sélectionnez pour Quand cela sera-t-il utilisé ? détermine l’ordre dans lequel les agents sont déclenchés.

Les assistants enfants et les rubriques partagent le même ensemble de déclencheurs ou d’événements auxquels ils peuvent répondre. Si un assistant et une rubrique sont configurés pour répondre au même événement, tel que l’inactivité de l’utilisateur, utilisez la propriété de priorité pour déterminer celle qui va en premier.

Ordre d’exécution :

1. Une activité survient
2. Un message est reçu / Un événement client personnalisé survient / La conversation change / Il est invoqué
3. L’assistant choisit

Si plusieurs agents ou rubriques doivent être appelés en fonction du même type d’événement, ils sont appelés dans l’ordre de création (le plus ancien en premier).

Vous pouvez définir explicitement la propriété Priority . Un nombre plus élevé indique une priorité plus faible.

Utilisation des agents et outils enfants

Les agents de Copilot Studio utilisant l’orchestration générative ont des limitations en nombre maximal et recommandé d’outils qu’ils peuvent utiliser. Pour plus d’informations, voir Limitations des outils dans les agents.

Lorsqu’un agent enfant est appelé, il utilise ses propres outils et connaissances pour répondre à l’utilisateur ou à l’événement. Parce que les agents enfants ont leur propre orchestration, ils ont leurs propres limites pour le nombre d’outils, distinctes des limites de l’agent parent.

La limite de séparation est l’un des avantages de l’utilisation d’agents enfants : vous pouvez logiquement regrouper outils et connaissances en agents plus petits qui se concentrent sur des tâches spécifiques, sans impacter les limites globales de l’agent principal. Il y a cependant un compromis dans la latence ajoutée par la couche supplémentaire d’orchestration.