Een agent importeren in een doelomgeving

Implementeer agents in sandbox- of testomgevingen voordat u ze in productie implementeert. Deze aanpak zorgt ervoor dat ze correct functioneren en helpt u potentiële onderbrekingen van uw bedrijfsactiviteiten te voorkomen.
Gebruik in Dynamics 365 Sales de alm-mogelijkheden (Application Lifecycle Management) van Power Platform om agentoplossingen in verschillende omgevingen te exporteren en te importeren. Exporteer de agentoplossing uit een bronomgeving, zoals een sandbox of testomgeving, en importeer deze vervolgens in de doelomgeving, meestal productie.

Gebruik deze procedure om een salesagentoplossing, zoals Sales Qualification Agent, Sales Opportunity Agent, Sales Close Agent, Recommended Actions Agent of Data Enrichment Agent, in een doelomgeving te importeren.

Aanbevolen procedures

• Maak één oplossing per agentprofiel om ervoor te zorgen dat elk profiel afzonderlijk kan worden verpakt en geïmplementeerd. Als u meerdere profielen in één oplossing opslaat, kan dit leiden tot het exporteren van onbedoelde of niet-geteste wijzigingen.

• Gebruik organisatieagnostische filters in selectiecriteria, zodat profielen na de migratie naar een andere omgeving blijven werken. Anders moet u de filters mogelijk handmatig bijwerken na het importeren.

De agent exporteren als een oplossing

Exporteer de agent uit de bronomgeving in de vorm van een oplossing. Tijdens het exportproces kunt u ervoor kiezen om alle onderdelen van de agent op te nemen of specifieke onderdelen te selecteren die u in de oplossing wilt opnemen. Nadat de export is voltooid, hebt u een oplossingsbestand om te importeren in de doelomgeving.

1. Ga in de bronomgeving naar de Power Apps maker portal.

2. Selecteer de omgeving met de agent die u wilt exporteren.

3. Selecteer in het linkernavigatiedeelvenster de optie Oplossingen.

4. Selecteer Nieuwe oplossing om een oplossing te maken en voer de benodigde gegevens in, zoals naam, uitgever en versie.

5. Vereiste onderdelen toevoegen.
   Selecteer Bestaande toevoegen>Meer>Andere en voeg vervolgens de volgende onderdelen toe:

   • SalesAgentProfile. Wanneer u de agent maakt, wordt automatisch een bijbehorend agentprofiel gemaakt. Selecteer in het deelvenster Bestaande SalesAgentProfile toevoegen het agentprofiel in de lijst met bestaande agentprofielen.
   • SalesAgentConfigurationV2. Wanneer u de agent maakt, worden bijbehorende agentconfiguraties automatisch gemaakt met dezelfde naam als het agentprofiel. Selecteer in het deelvenster Bestaande SalesAgentConfigurationV2 toevoegen de agentconfiguratie met dezelfde naam als het agentprofiel dat u hebt geselecteerd.
   • Reeks (alleen voor Agent voor verkoopkwalificatie). Wanneer u de Agent voor verkoopkwalificatie maakt, wordt automatisch een bijbehorende reeksrecord gemaakt in het reeksonderdeel. Selecteer in het deelvenster Bestaande reeks toevoegen de reeksrecord met de naam AgenticSequence.
   • msdyn_recommendedactionsourceagentconfig (alleen voor Agent voor aanbevolen acties). Dit onderdeel bevat de configuraties van de aanbevolen acties.

6. Voeg kennisbronnen toe.

   Opmerking

   Deze stap is niet van toepassing op de Agent voor gegevensverrijking.

   Selecteer Bestaande>agent> toevoegenen voeg vervolgens agents toe die kennisbronnen bevatten die relevant zijn voor de agent die u wilt exporteren. Als u bijvoorbeeld de verkoopkansagent exporteert - Accountonderzoek, worden kennisbronnen met betrekking tot accountonderzoek automatisch toegevoegd als onderdeel van het agentonderdeel. Elk agenttype vereist een specifieke set agents in de oplossing. Voor een lijst van agenten die voor elk type agent toegevoegd kunnen worden, zie Copilot Studio agents en Entra app-registraties voor sales agents.

   In de volgende afbeelding ziet u een voorbeeld van de toegevoegde onderdelen voor verkoopkwalificatieagent.
   

7. Sla de aanpassingen op en publiceer deze.

8. Selecteer Exporteren om de oplossing te exporteren en op te slaan op een locatie op uw computer.
   Kies tijdens het exportproces de oplossing als beheerde oplossing. Een beheerde oplossing wordt doorgaans gebruikt voor productieomgevingen. Zie Oplossingen exporteren voor meer informatie over het exporteren van oplossingen.

De agentoplossing importeren in de doelomgeving

Importeer het geëxporteerde oplossingsbestand in de doelomgeving. Tijdens het importproces kunt u ervoor kiezen om bestaande onderdelen in de doelomgeving te overschrijven die dezelfde naam hebben als die in de oplossing. Nadat het importeren is voltooid, is de agent beschikbaar in de doelomgeving.

De oplossing importeren

1. Ga naar de Power Apps-makerportal in de doelomgeving.
2. Selecteer de doelomgeving waar u de agentoplossing wilt importeren.
3. Selecteer in het linkernavigatiedeelvenster de optie Oplossingen. Zie Import-oplossingen voor meer informatie.
4. Volg de aanwijzingen om het importproces te voltooien. Kies er tijdens het importeren voor dat u bestaande onderdelen in de doelomgeving wilt overschrijven die dezelfde naam hebben als die in de oplossing. Deze optie zorgt ervoor dat de agentonderdelen worden bijgewerkt met de onderdelen uit de bronomgeving. De oplossing wordt geïmporteerd in de doelomgeving en wordt vermeld op de pagina AI-agents in uw omgeving.

De agent configureren en starten

Nadat u de oplossing hebt geïmporteerd, wordt de agent geïmporteerd in de conceptstatus. Open de agent en configureer omgevingsspecifieke instellingen voordat u de agent start. Het configureren en starten van de agent verschilt voor verkoopkwalificatieagent, verkoopkansagent, verkoopkansagent, agent voor gegevensverrijking en aanbevolen actiesagent. Volg de bijbehorende stappen op basis van het type agent dat u hebt geïmporteerd.

Voor Agent voor verkoopkwalificatie, Verkoopkansagent en Agent voor verkoopafsluiting

1. Maak de volgende onderdelen handmatig in de doelomgeving, omdat ze omgevingsspecifiek zijn en niet zijn opgenomen in de geëxporteerde oplossing:

   • Dataverse-toepassingsgebruiker
   • Vereiste toepassingsregistraties

2. Installeer de vereiste instellingen. De geëxporteerde oplossing bevat geen vereisten omdat ze vaak omgevingsspecifieke waarden bevatten die mogelijk verschillen tussen bron- en doelomgevingen.

   • Zie voor Agent voor verkoopkwalificatie Vereisten voor Agent voor verkoopkwalificatie configureren.
   • Zie voor Verkoopkansagent Vereisten voor Verkoopkansagent configureren.
   • Voor de Verkoopsluitingsagent, zie Vereisten configureren voor Verkoopsluitingsagent.

3. Selecteer de toepassingsgebruiker. Toepassingsgebruikers verschillen tussen bron- en doelomgevingen.

   1. Ga naar de configuratiepagina van de geïmporteerde agent.
   2. Selecteer op de pagina agentprofielinstellingen de Dataverse-toepassingsgebruiker die voor deze agent is gemaakt.

4. Toewijzingsregels of selectiecriteria controleren. Sommige toewijzingsgerelateerde waarden die in de bronomgeving zijn geconfigureerd, worden mogelijk niet correct omgezet in de doelomgeving. Als de toewijzingsregel bijvoorbeeld is gebaseerd op een team of gebruiker die niet bestaat in de doelomgeving, werkt u de regel bij om ervoor te zorgen dat deze correct functioneert.

   1. Open de pagina Instellingen voor toewijzingsregels .
   2. Werk onopgeloste of onjuiste waarden en tekst bij om ervoor te zorgen dat de toewijzingsregels werken zoals verwacht in de doelomgeving.

5. Verifieer kennisbronnen. Kennisbronnen worden automatisch weergegeven na het importeren van oplossingen als ze zijn toegevoegd aan de bijbehorende bots in de bronomgeving. De inhoud in deze kennisbronnen kan echter verschillen tussen omgevingen. Als bijvoorbeeld een SharePoint documentbibliotheek is gebruikt als kennisbron in de bronomgeving, is dezelfde documentbibliotheek mogelijk niet beschikbaar in de doelomgeving. Werk de kennisbronnen bij om naar de juiste inhoud in de doelomgeving te verwijzen.

   1. Open de pagina Instellingen voor kennisbronnen .
   2. Controleer of alle geconfigureerde kennisbronnen beschikbaar zijn. Als er een kennisbron ontbreekt of niet juist is geconfigureerd, werkt u deze bij om ervoor te zorgen dat de agent toegang heeft tot de benodigde informatie.

6. Sla de agent op en activeer hem. Nadat u de omgevingsspecifieke instellingen hebt bijgewerkt, slaat u de agent op en start u deze.

Voor gegevensverrijkingsagent

1. Installeer de vereiste instellingen. De geëxporteerde oplossing bevat geen vereisten omdat ze vaak omgevingsspecifieke waarden bevatten die mogelijk verschillen tussen bron- en doelomgevingen. Zie Vereisten configureren voor meer informatie.

2. Regels voor recordselectie beoordelen. Sommige waarden in de recordselectieregels worden mogelijk niet correct opgelost in de doelomgeving. Als de regel bijvoorbeeld is gebaseerd op een team of gebruiker die niet in de doelomgeving bestaat, werkt u de regel bij om ervoor te zorgen dat deze correct functioneert.

   1. Ga op de configuratiepagina naar de pagina Instellingen voor recordselectie .
   2. Werk eventuele onopgeloste of onjuiste waarden bij om ervoor te zorgen dat de recordselectieregels werken zoals verwacht in de doelomgeving.
      Zie Records selecteren voor verrijking voor meer informatie over recordselectie.

3. Controleer de gebruikerstoegang. Gebruikerstoegang tot de agent kan verschillen tussen bron- en doelomgevingen. Zorg ervoor dat gebruikers in de doelomgeving over de benodigde machtigingen beschikken om de agent te openen en te gebruiken.

   1. Ga op de configuratiepagina naar de pagina Instellingen voor gebruikerstoegang .
   2. Controleer of alle gebruikers die toegang nodig hebben tot de agent over de juiste machtigingen beschikken.
      Zie Gebruikerstoegang configureren voor meer informatie over gebruikerstoegang.

4. Veldbereik verifiëren. De velden die zijn geselecteerd voor verrijking in de bronomgeving, zijn mogelijk niet hetzelfde als die in de doelomgeving. Controleer de geselecteerde velden om ervoor te zorgen dat deze overeenkomen met de vereisten in de doelomgeving.

   1. Ga op de configuratiepagina naar de pagina Met instellingen voor agentgedrag .
   2. Controleer in de sectie Veldbereik de geselecteerde velden en werk deze indien nodig bij om ervoor te zorgen dat de agent de juiste gegevens in de doelomgeving verrijkt.
      Zie Agentgedrag configureren voor meer informatie over veldbereik.

5. Sla de agent op en activeer hem. Nadat u de omgevingsspecifieke instellingen hebt bijgewerkt, slaat u de agent op en start u deze.

Voor agent voor aanbevolen acties

1. Selecteer de toepassingsgebruiker. Toepassingsgebruikers verschillen tussen bron- en doelomgevingen.

   1. Ga naar de configuratiepagina van de geïmporteerde agent.
   2. Selecteer op de pagina agentprofielinstellingen de Dataverse-toepassingsgebruiker die voor deze agent is gemaakt.

2. Afhankelijk van de bronnen die u hebt geconfigureerd voor de Agent aanbevolen acties in de bronomgeving, moet u mogelijk extra stappen uitvoeren om ervoor te zorgen dat deze bronnen correct zijn ingesteld in de doelomgeving. Configureer de bronnen op basis van het type agents dat u hebt ingesteld als bronnen in de bronomgeving.

   • Als u verkoopkansagent of gegevensverrijkingsagent hebt geconfigureerd, is er geen actie vereist. Deze agents maken deel uit van de oplossing en worden samen met de agent Aanbevolen acties geïmporteerd en automatisch ingesteld als bronnen.
   • Als je aangepaste agenten gebruikt als bronnen voor de Aanbevolen Acties-agent, zorg er dan voor dat je die aangepaste agenten ook importeert en configureert in de doelomgeving. De msdyn_PushActionDataToRecommendedActionAgent API stuurt bruikbare inzichten van custom agents naar de Recommended Actions Agent. Je moet de aangepaste agenten juist configureren zodat hun inzichten in de omgeving voor aanbevolen acties worden weergegeven.

3. Sla de agent op en activeer hem. Nadat u de omgevingsspecifieke instellingen hebt bijgewerkt, slaat u de agent op en start u deze.

Verwante gegevens

AI-agenten in Dynamics 365 Sales