Importera en agent till en målmiljö

Distribuera agenter i sandbox- eller testmiljöer innan du distribuerar dem i produktion. Den här metoden säkerställer att de fungerar korrekt och hjälper dig att undvika potentiella störningar i din verksamhet.
I Dynamics 365 Sales använder du FUNKTIONERNA för programlivscykelhantering (ALM) i Power Platform för att exportera och importera agentlösningar mellan miljöer. Exportera agentlösningen från en källmiljö, till exempel en sandbox-miljö eller testmiljö, och importera den sedan till målmiljön, vanligtvis produktion.

Använd den här proceduren om du vill importera en försäljningsagentlösning som Sales Qualification Agent, Sales Opportunity Agent, Sales Close Agent, Recommended Actions Agent eller Data Enrichment Agent till en målmiljö.

Regelverk

• Skapa en lösning per agentprofil för att säkerställa att varje profil kan paketeras och distribueras separat. Om du inkluderar flera profiler i en enda lösning kan det leda till att oavsiktliga eller otestade ändringar exporteras.

• Använd organisationsagnostiska filter i urvalskriterier så att profiler fortsätter att fungera efter migreringen till en annan miljö. Annars kan du behöva uppdatera filtren manuellt efter importen.

Exportera agenten som en lösning

Exportera agenten från källmiljön som en lösning. Under exportprocessen kan du välja att inkludera alla komponenter i agenten eller välja specifika komponenter som ska ingå i lösningen. När exporten är klar har du en lösningsfil som du kan importera till målmiljön.

1. I källmiljön går du till Power Apps maker-portalen.

2. Välj den miljö som innehåller den agent som du vill exportera.

3. I den vänstra navigeringsrutan väljer du Lösningar.

4. Välj Ny lösning för att skapa en lösning och ange nödvändig information, till exempel namn, utgivare och version.

5. Lägg till nödvändiga komponenter.
   Välj Lägg till>> och lägg sedan till följande komponenter:

   • SalesAgentProfile. När du skapar agenten skapas automatiskt en motsvarande agentprofil. I fönstret Lägg till befintlig SalesAgentProfile väljer du agentprofilen i listan över befintliga agentprofiler.
   • SalesAgentConfigurationV2. När du skapar agenten skapas motsvarande agentkonfigurationer automatiskt med samma namn som agentprofilen. I fönstret Lägg till befintlig SalesAgentConfigurationV2 väljer du den agentkonfiguration som har samma namn som den agentprofil som du valde.
   • Sekvens (endast för Säljkvalificeringsagent). När du skapar agent för försäljningskvalificering skapas automatiskt en motsvarande sekvenspost i sekvenskomponenten. I fönstret Lägg till befintlig sekvens väljer du sekvensposten med namnet AgenticSequence.
   • msdyn_recommendedactionsourceagentconfig (endast för agenten för rekommenderade åtgärder). Den här komponenten innehåller konfigurationerna för de rekommenderade åtgärderna.

6. Lägg till kunskapskällor.

   Note

   Det här steget gäller inte för Data Enrichment Agent.

   Välj Lägg till befintlig>agentagent> och lägg sedan till agenter som innehåller kunskapskällor som är relevanta för den agent som du vill exportera. Om du till exempel exporterar försäljningsmöjlighetsagenten – Kontoforskning läggs kunskapskällor relaterade till kontoforskning automatiskt till som en del av agentkomponenten. Varje agenttyp kräver en specifik uppsättning agenter i lösningen. För en lista över agenter att lägga till för varje agenttyp, se Copilot Studio-agenter och Entra-appregistreringar för försäljningsagenter.

   Följande bild visar ett exempel på de komponenter som lagts till för Sales Qualification Agent.
   

7. Spara och publicera anpassningarna.

8. Välj Exportera för att exportera lösningen och spara den på en plats på datorn.
   Under exportprocessen väljer du lösningen som hanterad lösning. En hanterad lösning används vanligtvis för produktionsmiljöer. Mer information om hur du exporterar lösningar finns i Exportera lösningar.

Importera agentlösningen till målmiljön

Importera den exporterade lösningsfilen till målmiljön. Under importprocessen kan du välja att skriva över alla befintliga komponenter i målmiljön som har samma namn som de i lösningen. När importen är klar är agenten tillgänglig i målmiljön.

Importera lösningen

1. Gå till Power Apps maker-portalen i målmiljön.
2. Välj den målmiljö där du vill importera agentlösningen.
3. I den vänstra navigeringsrutan väljer du Lösningar. Mer information finns i Importera lösningar.
4. Följ anvisningarna för att slutföra importprocessen. Under importen väljer du att skriva över alla befintliga komponenter i målmiljön som har samma namn som de i lösningen. Det här alternativet säkerställer att agentkomponenterna uppdateras med dem från källmiljön. Lösningen importeras till målmiljön och visas på sidan AI-agenter i din miljö.

Konfigurera och starta agenten

Efter att du importerat lösningen importeras agenten som utkast. Öppna agenten och konfigurera miljöspecifika inställningar innan du startar agenten. Att konfigurera och starta agenten skiljer sig åt för Sales Qualification Agent, Sales Opportunity Agent, Sales Close Agent, Data Enrichment Agent och Recommended Actions Agent. Följ motsvarande steg baserat på vilken typ av agent du importerade.

För Agent för försäljningskvalificering, Agent för försäljningsmöjlighet och Agent för försäljningsavslut

1. Skapa följande komponenter manuellt i målmiljön eftersom de är miljöspecifika och inte ingår i den exporterade lösningen:

   • Dataverse-programanvändare
   • Nödvändiga programregistreringar

2. Konfigurera förutsättningarna. Den exporterade lösningen innehåller inte förutsättningar eftersom de ofta innehåller miljöspecifika värden som kan skilja sig mellan käll- och målmiljöer.

   • Information om Sales Qualification Agent finns i Konfigurera krav för Försäljningskvalificeringsagent.
   • Information om Försäljningsmöjlighetsagent finns i Konfigurera krav för Försäljningsmöjlighetsagent.
   • För Agent för försäljningsavslut, se Konfigurera krav för Agent för försäljningsavslut.

3. Välj programanvändaren. Programanvändare skiljer sig åt mellan käll- och målmiljöer.

   1. Gå till konfigurationssidan för den importerade agenten.
   2. På sidan inställningar för agentprofil väljer du den Dataverse-programanvändare som skapats för den här agenten.

4. Granska tilldelningsregler eller urvalsvillkor. Vissa tilldelningsrelaterade värden som konfigurerats i källmiljön kanske inte upplösas korrekt i målmiljön. Om tilldelningsregeln till exempel baseras på ett team eller en användare som inte finns i målmiljön uppdaterar du regeln så att den fungerar korrekt.

   1. Öppna sidan Inställningar för tilldelningsregler .
   2. Uppdatera eventuella olösta eller felaktiga värden och text för att säkerställa att tilldelningsreglerna fungerar som förväntat i målmiljön.

5. Verifiera kunskapskällor. Kunskapskällor visas automatiskt efter lösningsimport om de har lagts till i motsvarande robotar i källmiljön. Innehållet i dessa kunskapskällor kan dock skilja sig åt mellan miljöer. Om ett SharePoint dokumentbibliotek till exempel användes som kunskapskälla i källmiljön kanske samma dokumentbibliotek inte är tillgängligt i målmiljön. Uppdatera kunskapskällorna så att de pekar på rätt innehåll i målmiljön.

   1. Öppna sidan Inställningar för kunskapskällor .
   2. Kontrollera att alla konfigurerade kunskapskällor är tillgängliga. Om någon kunskapskälla saknas eller inte är korrekt konfigurerad uppdaterar du den för att säkerställa att agenten har åtkomst till nödvändig information.

6. Spara och aktivera agenten. När du har uppdaterat de miljöspecifika inställningarna sparar du och startar agenten.

För agent för databerikande

1. Konfigurera förutsättningarna. Den exporterade lösningen innehåller inte förutsättningar eftersom de ofta innehåller miljöspecifika värden som kan skilja sig mellan käll- och målmiljöer. Mer information finns i Konfigurera förutsättningar .

2. Granska reglerna för val av post. Vissa värden i reglerna för val av poster kanske inte löses korrekt i målmiljön. Om regeln till exempel baseras på ett team eller en användare som inte finns i målmiljön uppdaterar du regeln så att den fungerar korrekt.

   1. Gå till sidan Inställningar för postval på konfigurationssidan.
   2. Uppdatera eventuella olösta eller felaktiga värden för att säkerställa att reglerna för posturval fungerar som förväntat i den målsatta miljön.
      För att lära dig mer om hur man väljer poster, se Välj poster för berikning.

3. Verifiera användaråtkomst. Användaråtkomsten till agenten kan skilja sig mellan käll- och målmiljöer. Se till att användare i målmiljön har de behörigheter som krävs för att komma åt och använda agenten.

   1. På konfigurationssidan går du till sidan Inställningar för användaråtkomst .
   2. Kontrollera att alla användare som behöver åtkomst till agenten har rätt behörigheter.
      Mer information om användaråtkomst finns i Konfigurera användaråtkomst.

4. Verifiera fältomfånget. Fälten som valts för berikning i källmiljön kanske inte är samma som de i målmiljön. Granska de markerade fälten för att säkerställa att de överensstämmer med kraven i målmiljön.

   1. På konfigurationssidan går du till sidan Inställningar för agentbeteende .
   2. I avsnittet Fältomfång granskar du de markerade fälten och uppdaterar dem om det behövs för att säkerställa att agenten berikar rätt data i målmiljön.
      Mer information om fältomfång finns i Konfigurera agentbeteende.

5. Spara och aktivera agenten. När du har uppdaterat de miljöspecifika inställningarna sparar du och startar agenten.

Agent för rekommenderade åtgärder

1. Välj programanvändaren. Programanvändare skiljer sig åt mellan käll- och målmiljöer.

   1. Gå till konfigurationssidan för den importerade agenten.
   2. På sidan inställningar för agentprofil väljer du den Dataverse-programanvändare som skapats för den här agenten.

2. Beroende på de källor som du har konfigurerat för agenten för rekommenderade åtgärder i källmiljön kan du behöva utföra ytterligare steg för att säkerställa att dessa källor är korrekt konfigurerade i målmiljön. Konfigurera källorna baserat på vilken typ av agenter du har konfigurerat som källor i källmiljön.

   • Om du har konfigurerat Sales Opportunity Agent eller Data Enrichment Agent krävs ingen åtgärd. Dessa agenter är en del av lösningen och importeras tillsammans med agenten för rekommenderade åtgärder och konfigureras automatiskt som källor.
   • Om du använder anpassade agenter som källor för Recommended Actions Agent, se till att du också importerar och konfigurerar dessa anpassade agenter i målmiljön. msdyn_PushActionDataToRecommendedActionAgent API skickar handlingsbara insikter från anpassade agenter till Recommended Actions Agent. Du måste ställa in de anpassade agenterna korrekt för att deras insikter ska synas i den rekommenderade åtgärdsupplevelsen.

3. Spara och aktivera agenten. När du har uppdaterat de miljöspecifika inställningarna sparar du och startar agenten.

Relaterad information

AI-agenter i Dynamics 365 Sales