Importer un agent dans un environnement cible

Déployez des agents dans des environnements de bac à sable ou de test avant de les déployer en production. Cette approche garantit qu’elles fonctionnent correctement et vous aident à éviter les interruptions potentielles de vos opérations commerciales.
Dans Dynamics 365 Sales, utilisez les fonctionnalités alm (Application Lifecycle Management) de Power Platform pour exporter et importer des solutions d’agent dans les environnements. Exportez la solution d’agent à partir d’un environnement source, comme un bac à sable ou un environnement de test, puis importez-la dans l’environnement cible, généralement en production.

Utilisez cette procédure pour importer une solution d’agent commercial telle que l’agent de qualification des ventes, l’agent d’opportunité des ventes, l’agent de fermeture de ventes ou l’agent d’enrichissement des données dans un environnement cible.

Meilleures pratiques

• Créez une solution par profil d’agent pour vous assurer que chaque profil peut être empaqueté et déployé indépendamment. L’inclusion de plusieurs profils dans une seule solution peut entraîner l’exportation de modifications inattendues ou non testées.

• Utilisez des filtres indépendants de l’organisation dans les critères de sélection afin que les profils continuent de fonctionner après la migration vers un autre environnement. Sinon, vous devrez peut-être mettre à jour manuellement les filtres après l’importation.

Exporter l’agent en tant que solution

Exportez l’agent à partir de l’environnement source en tant que solution. Pendant le processus d’exportation, vous pouvez choisir d’inclure tous les composants de l’agent ou de sélectionner des composants spécifiques à inclure dans la solution. Une fois l’exportation terminée, vous disposez d’un fichier solution à importer dans l’environnement cible.

1. Dans l’environnement source, accédez au portail Power Apps maker.

2. Sélectionnez l’environnement qui contient l’agent que vous souhaitez exporter.

3. Dans le volet de navigation de gauche, sélectionnez Solutions.

4. Sélectionnez Nouvelle solution pour créer une solution et entrez les détails nécessaires, tels que le nom, l’éditeur et la version.

5. Ajoutez les composants requis.
   Sélectionnez Ajouter d’autres> éléments existants>, puis ajoutez les composants suivants :

   • SalesAgentProfile. Lorsque vous créez l’agent, un profil d’agent correspondant est automatiquement créé. Dans le volet Ajouter un salesAgentProfile existant , sélectionnez le profil de l’agent dans la liste des profils d’agent existants.
   • SalesAgentConfigurationV2. Lorsque vous créez l’agent, les configurations d’agent correspondantes sont automatiquement créées avec le même nom que le profil de l’agent. Dans le volet Ajouter salesAgentConfigurationV2 existant , sélectionnez la configuration de l’agent portant le même nom que le profil de l’agent que vous avez sélectionné.
   • Séquence (uniquement pour Agent de qualification des ventes). Lorsque vous créez l’Agent de qualification des ventes, un enregistrement de séquence correspondant est automatiquement créé dans le composant séquence. Dans le volet Ajouter une séquence existante , sélectionnez l’enregistrement de séquence avec le nom AgenticSequence.

6. Ajoutez des sources de connaissances.

   Note

   Cette étape n’est pas applicable à l’agent d’enrichissement des données.

   Sélectionnez Ajouter un agent existant>Agent>Agent, puis ajoutez des agents qui contiennent des sources de connaissances pertinentes pour l’agent que vous souhaitez exporter. Par exemple, si vous exportez l’agent d’opportunité commerciale - Recherche de compte, les sources de connaissances liées à la recherche de compte sont automatiquement ajoutées dans le cadre du composant agent. Chaque type d’agent nécessite un ensemble spécifique d’agents dans la solution. Le tableau suivant montre les agents que vous devez ajouter pour chaque solution d’agent.

   Type de solution de l’agent commercial	Agents à ajouter
   Agent de qualification des ventes	Agent commercial D365 - Recherche Agent commercial D365 - Concurrent direct Agent commercial D365 - Recherche personnalisée Agent commercial D365 - Préparation Agent commercial D365 - Validation par e-mail Agent commercial D365 - Sensibilisation Agent de vente D365 - Engagement Autonome Agent commercial D365 - Agent de préremplissage TCP Agent commercial D365 - Recherche des parties prenantes Agent de vente D365 - Engagement Autonome Agent commercial D365 - Synthétiseur de résumé
   Agent d’opportunité de vente	Agent d’opportunité de vente Agent des opportunités commerciales - Recherche de comptes Agent des opportunités de vente - Recherche concurrentielle Agent d’opportunité de vente - Recherche personnalisée Agent en opportunités de vente - Partie prenante
   Agent de clôture des ventes	Agent de clôture des ventes

   L’image suivante montre un exemple des composants ajoutés pour Sales Qualification Agent.
   

7. Enregistrez et publiez les personnalisations.

8. Sélectionnez Exporter pour exporter la solution et enregistrez-la dans un emplacement sur votre ordinateur.
   Pendant le processus d’exportation, choisissez la solution en tant que solution gérée. Une solution managée est généralement utilisée pour les environnements de production. Pour plus d’informations sur l’exportation de solutions, consultez Exporter des solutions.

Importer la solution de l’agent dans l’environnement cible

Importez le fichier de solution exporté dans l’environnement cible. Pendant le processus d’importation, vous pouvez choisir de remplacer tous les composants existants dans l’environnement cible qui ont le même nom que ceux de la solution. Une fois l’importation terminée, l’agent est disponible dans l’environnement cible.

Importer la solution

1. Accédez au portail Power Apps maker dans l’environnement cible.
2. Sélectionnez l’environnement cible dans lequel vous souhaitez importer la solution de l’agent.
3. Dans le volet de navigation de gauche, sélectionnez Solutions.
4. Sélectionnez Importer la solution et chargez le fichier de solution que vous avez exporté à partir de l’environnement source.
   Pour plus d’informations, consultez Importer des solutions.
5. Suivez les instructions pour terminer le processus d’importation. Pendant l’importation, choisissez de remplacer les composants existants dans l’environnement cible qui ont le même nom que ceux de la solution. Cette option garantit que les composants de l’agent sont mis à jour avec ceux de l’environnement source. La solution est importée dans l’environnement cible et est répertoriée dans la page des agents IA de votre environnement.

Configurer et démarrer l’agent

Après avoir importé la solution, l’agent est importé dans un état de brouillon. Ouvrez l’agent et configurez les paramètres spécifiques à l’environnement avant de démarrer l’agent. La configuration et le démarrage de l’agent sont différents pour sales Qualification Agent, Sales Opportunity Agent, Sales Close Agent et Data Enrich Agent. Suivez les étapes correspondantes en fonction du type d’agent que vous avez importé :

Pour l'agent de qualification des ventes, l'agent des opportunités de ventes et l'agent de clôture des ventes

1. Créez manuellement les composants suivants dans l’environnement cible, car ils sont spécifiques à l’environnement et ne sont pas inclus dans la solution exportée :

   • Utilisateur de l’application Dataverse
   • Inscriptions d’applications requises

2. Configurez les prérequis. La solution exportée n’inclut pas les prérequis, car ils contiennent souvent des valeurs spécifiques à l’environnement qui peuvent différer entre les environnements source et cible.

   • Pour l’Agent de qualification des ventes, consultez Configurer les conditions requises pour l’agent de qualification des ventes.
   • Pour l’agent d’opportunité commerciale, consultez Configurer les conditions requises pour l’agent d’opportunité commerciale.
   • Pour Sales Close Agent, consultez Configuration requise pour Sales Close Agent.

3. Sélectionnez l’utilisateur de l’application. Les utilisateurs d’application diffèrent entre les environnements source et cible.

   1. Accédez à la page de configuration de l’agent importé.
   2. Dans la page paramètres du profil de l’agent, sélectionnez l’utilisateur de l’application Dataverse créé pour cet agent.

4. Passez en revue les règles d’affectation ou les critères de sélection. Certaines valeurs liées à l’affectation configurées dans l’environnement source peuvent ne pas être résolues correctement dans l’environnement cible. Par exemple, si la règle d’affectation est basée sur une équipe ou un utilisateur qui n’existe pas dans l’environnement cible, mettez à jour la règle pour s’assurer qu’elle fonctionne correctement.

   1. Ouvrez la page paramètres des règles d’affectation .
   2. Mettez à jour les valeurs et le texte non résolus ou incorrects pour garantir que les règles d’affectation fonctionnent comme prévu dans l’environnement cible.

5. Vérifiez les sources de connaissances. Les sources de connaissances apparaissent automatiquement après l’importation de la solution si elles ont été ajoutées aux bots correspondants dans l’environnement source. Toutefois, le contenu de ces sources de connaissances peut différer entre les environnements. Par exemple, si une bibliothèque de documents SharePoint a été utilisée comme source de connaissances dans l’environnement source, la même bibliothèque de documents peut ne pas être disponible dans l’environnement cible. Mettez à jour les sources de connaissances pour pointer vers le contenu approprié dans l’environnement cible.

   1. Ouvrez la page des paramètres des sources de connaissances .
   2. Vérifiez que toutes les sources de connaissances configurées sont disponibles. Si une source de connaissances est manquante ou n’est pas correctement configurée, mettez-la à jour pour vous assurer que l’agent a accès aux informations nécessaires.

6. Activez l’agent. Après avoir mis à jour les paramètres spécifiques à l’environnement, enregistrez et démarrez l’agent.

Pour l’agent d’enrichissement des données

1. Configurez les prérequis. La solution exportée n’inclut pas les prérequis, car ils contiennent souvent des valeurs spécifiques à l’environnement qui peuvent différer entre les environnements source et cible. Pour plus d’informations, consultez Configurer les prérequis .

2. Passez en revue les règles de sélection d’enregistrement. Certaines valeurs des règles de sélection d’enregistrement peuvent ne pas être résolues correctement dans l’environnement cible. Par exemple, si la règle est basée sur une équipe ou un utilisateur qui n’existe pas dans l’environnement cible, mettez à jour la règle pour s’assurer qu’elle fonctionne correctement.

   1. Dans la page de configuration, accédez à la page Paramètres de sélection d’enregistrement .
   2. Mettez à jour les valeurs non résolues ou incorrectes pour garantir que les règles de sélection d’enregistrement fonctionnent comme prévu dans l’environnement cible.
      Pour en savoir plus sur la sélection d’enregistrements, consultez Sélectionner des enregistrements pour l’enrichissement.

3. Vérifiez l’accès utilisateur. L’accès utilisateur à l’agent peut différer entre les environnements source et cible. Assurez-vous que les utilisateurs de l’environnement cible disposent des autorisations nécessaires pour accéder à l’agent et l’utiliser.

   1. Dans la page de configuration, accédez à la page Paramètres d’accès utilisateur .
   2. Vérifiez que tous les utilisateurs qui ont besoin d’accéder à l’agent disposent des autorisations appropriées.
      Pour en savoir plus sur l’accès utilisateur, consultez Configurer l’accès utilisateur.

4. Vérifiez l’étendue du champ. Les champs sélectionnés pour l’enrichissement dans l’environnement source peuvent ne pas être identiques à ceux de l’environnement cible. Passez en revue les champs sélectionnés pour vous assurer qu’ils s’alignent sur les exigences de l’environnement cible.

   1. Dans la page de configuration, accédez à la page paramètres de comportement de l’agent .
   2. Dans la section Étendue de champ , passez en revue les champs sélectionnés et mettez-les à jour si nécessaire pour vous assurer que l’agent enrichit les données appropriées dans l’environnement cible.
      Pour en savoir plus sur l’étendue du champ, consultez Configurer le comportement de l’agent.

5. Activez l’agent. Après avoir mis à jour les paramètres spécifiques à l’environnement, enregistrez et démarrez l’agent.

Informations connexes

Agents IA dans Dynamics 365 Sales