Importare un agente in un ambiente di destinazione

Distribuire gli agenti in ambienti sandbox o di test prima di distribuirli nell'ambiente di produzione. Questo approccio garantisce il corretto funzionamento e consente di evitare potenziali interruzioni delle operazioni aziendali.
In Dynamics 365 Remote Assist usare le funzionalità di Gestione del ciclo di vita delle applicazioni di Power Platform per esportare e importare soluzioni agente in ambienti diversi. Esportare la soluzione agente da un ambiente di origine, ad esempio un ambiente sandbox o di test, e quindi importarla nell'ambiente di destinazione, in genere produzione.

Utilizzare questa procedura per importare una soluzione per agenti di vendita, come agente di qualificazione delle vendite, agente di opportunità di vendita, agente di chiusura delle vendite o agente di arricchimento dei dati, in un ambiente di destinazione.

Procedure consigliate

• Creare una soluzione per profilo agente per assicurarsi che ogni profilo possa essere creato e distribuito in modo indipendente. L'inclusione di più profili in una singola soluzione può comportare l'esportazione di modifiche impreviste o non con test.

• Usare filtri indipendenti dall'organizzazione nei criteri di selezione in modo che i profili continuino a funzionare dopo la migrazione a un altro ambiente. In caso contrario, potrebbe essere necessario aggiornare manualmente i filtri dopo l'importazione.

Esportare l'agente come soluzione

Esportare l'agente dall'ambiente di origine come soluzione. Durante il processo di esportazione, è possibile scegliere di includere tutti i componenti dell'agente o selezionare componenti specifici da includere nella soluzione. Al termine dell'esportazione, si dispone di un file di soluzione da importare nell'ambiente di destinazione.

1. Nell'ambiente di origine passare al portale Power Apps maker.

2. Selezionare l'ambiente che contiene l'agente da esportare.

3. Nel riquadro di spostamento a sinistra selezionare Soluzioni.

4. Selezionare Nuova soluzione per creare una soluzione e immettere i dettagli necessari, ad esempio nome, editore e versione.

5. Aggiungere i componenti necessari.
   Selezionare Aggiungi esistente>Più>Altro e quindi aggiungere i componenti seguenti:

   • SalesAgentProfile. Quando si crea l'agente, viene creato automaticamente un profilo agente corrispondente. Nel riquadro Aggiungi salesAgentProfile esistente selezionare il profilo agente dall'elenco dei profili agente esistenti.
   • SalesAgentConfigurationV2. Quando si crea l'agente, le configurazioni dell'agente corrispondenti vengono create automaticamente con lo stesso nome del profilo dell'agente. Nel riquadro Aggiungi SalesAgentConfigurationV2 esistente, selezionare la configurazione dell'agente con lo stesso nome del profilo dell'agente selezionato.
   • Sequenza (solo per Agente di Qualifica Commerciale). Quando si crea l'agente di qualificazione vendite, viene creato automaticamente un record di sequenza corrispondente nel componente sequenza. Nel riquadro Aggiungi sequenza esistente selezionare il record di sequenza con il nome AgenticSequence.

6. Aggiungere le origini delle conoscenze.

   Note

   Questo passaggio non è applicabile per l'agente di arricchimento dati.

   Selezionare Aggiungi>agente esistente> e quindi aggiungere agenti che contengono origini di informazioni rilevanti per l'agente da esportare. Ad esempio, se si esporta l'agente delle opportunità di vendita - Ricerca account, le fonti di conoscenza correlate alla ricerca account vengono aggiunte automaticamente come parte del componente dell'agente. Ogni tipo di agente richiede un set specifico di agenti nella soluzione. La tabella seguente illustra gli agenti da aggiungere per ogni soluzione agente.

   Tipo di soluzione agente di vendita	Agenti da aggiungere
   Agente di qualificazione vendite	D365 Sales Agent - Ricerca D365 Agenti di Vendita - Concorrente D365 Sales Agent - Ricerca personalizzata D365 Sales Agent - Readiness D365 Sales Agent - Convalida della posta elettronica D365 Sales Agent - Sensibilizzazione Agente di Vendita D365 - Impegno Autonomo D365 Sales Agent - Agente di Pre-inserimento TCP D365 Sales Agent - Ricerca sui portatori di interesse Agente di Vendita D365 - Impegno Autonomo D365 Sales Agent - Sintetizzatore di riepilogo
   Agente di Opportunità di Vendita	Agente di Opportunità di Vendita Agente delle opportunità di vendita - Ricerca account Agente di Opportunità di Vendita - Ricerca di Concorrenza Agente per le Opportunità di Vendita - Ricerca personalizzata Agente opportunità di vendita - Portatore di interessi
   Agente di Chiusura Vendite	Agente di Chiusura Vendite

   L'immagine seguente mostra un esempio dei componenti aggiunti per Sales Qualification Agent.
   

7. Salvare e pubblicare le personalizzazioni.

8. Selezionare Esporta per esportare la soluzione e salvarla in una posizione sul tuo computer.
   Durante il processo di esportazione scegliere la soluzione come soluzione gestita. Una soluzione gestita viene in genere usata per gli ambienti di produzione. Per altre informazioni sull'esportazione di soluzioni, vedere Esportare soluzioni.

Importare la soluzione agente nell'ambiente di destinazione

Importare il file di soluzione esportato nell'ambiente di destinazione. Durante il processo di importazione, è possibile scegliere di sovrascrivere tutti i componenti esistenti nell'ambiente di destinazione con lo stesso nome di quelli nella soluzione. Al termine dell'importazione, l'agente è disponibile nell'ambiente di destinazione.

Importazione di una soluzione

1. Vai al portale di Power Apps maker nell'ambiente di destinazione.
2. Selezionare l'ambiente di destinazione in cui si vuole importare la soluzione agente.
3. Nel riquadro di spostamento a sinistra selezionare Soluzioni.
4. Selezionare Importa soluzione e caricare il file della soluzione esportato dall'ambiente di origine.
   Per altre informazioni, consultare Importare soluzioni.
5. Seguire le istruzioni per completare il processo di importazione. Durante l'importazione, scegliere di sovrascrivere tutti i componenti esistenti nell'ambiente di destinazione con lo stesso nome di quelli nella soluzione. Questa opzione garantisce che i componenti dell'agente vengano aggiornati con quelli dell'ambiente di origine. La soluzione viene importata nell'ambiente di destinazione ed è elencata nella pagina Agenti di intelligenza artificiale nell'ambiente in uso.

Configurare e avviare l'agente

Dopo aver importato la soluzione, l'agente viene importato in stato di bozza. Aprire l'agente e configurare le impostazioni specifiche dell'ambiente prima di avviare l'agente. La configurazione e l'avvio dell'agente sono diverse per l'agente di qualificazione vendite, l'agente di vendita, l'agente di chiusura vendite e l'agente di arricchimento dati. Seguire i passaggi corrispondenti in base al tipo di agente importato:

Per agente di qualificazione vendite, agente opportunità di vendita e agente di chiusura vendite

1. Creare manualmente i componenti seguenti nell'ambiente di destinazione, perché sono specifici dell'ambiente e non sono inclusi nella soluzione esportata:

   • Utente dell'applicazione Dataverse
   • Registrazioni dell'applicazione necessarie

2. Configurare i prerequisiti. La soluzione esportata non include prerequisiti perché spesso contengono valori specifici dell'ambiente che potrebbero differire tra gli ambienti di origine e di destinazione.

   • Per l'agente di qualificazione vendite, vedere Configurare i requisiti per l'agente di qualificazione vendite.
   • Per Sales Opportunity Agent, vedere Configurare i requisiti per l'agente delle opportunità di vendita.
   • Per Sales Close Agent, vedere Configurare i requisiti per Sales Close Agent.

3. Selezionare l'utente dell'applicazione. Gli utenti dell'applicazione differiscono tra gli ambienti di origine e di destinazione.

   1. Passare alla pagina di configurazione dell'agente importato.
   2. Nella pagina impostazioni del profilo agente selezionare l'utente dell'applicazione Dataverse creato per questo agente.

4. Esaminare le regole di assegnazione o i criteri di selezione. Alcuni valori correlati all'assegnazione configurati nell'ambiente di origine potrebbero non essere risolti correttamente nell'ambiente di destinazione. Ad esempio, se la regola di assegnazione si basa su un team o un utente che non esiste nell'ambiente di destinazione, aggiornare la regola per assicurarsi che funzioni correttamente.

   1. Apri la pagina Impostazioni regole di assegnazione.
   2. Aggiornare eventuali valori non risolti o non corretti e testo per assicurarsi che le regole di assegnazione funzionino come previsto nell'ambiente di destinazione.

5. Verificare le origini delle informazioni. Le origini delle informazioni vengono visualizzate automaticamente dopo l'importazione della soluzione se sono state aggiunte ai bot corrispondenti nell'ambiente di origine. Tuttavia, il contenuto all'interno di tali fonti di conoscenza potrebbe variare tra gli ambienti. Ad esempio, se una raccolta documenti SharePoint è stata usata come origine delle informazioni nell'ambiente di origine, la stessa raccolta documenti potrebbe non essere disponibile nell'ambiente di destinazione. Aggiornare le origini delle informazioni in modo che puntino al contenuto corretto nell'ambiente di destinazione.

   1. Apri la pagina delle impostazioni delle fonti di conoscenza.
   2. Verificare che tutte le fonti di conoscenza configurate siano disponibili. Se un'origine di conoscenza è assente o non è configurata correttamente, aggiornala per assicurarti che l'agente abbia accesso alle informazioni necessarie.

6. Attivare l'agente. Dopo aver aggiornato le impostazioni specifiche dell'ambiente, salvare e avviare l'agente.

Per l'agente di arricchimento dei dati

1. Configurare i prerequisiti. La soluzione esportata non include prerequisiti perché spesso contengono valori specifici dell'ambiente che potrebbero differire tra gli ambienti di origine e di destinazione. Per altre informazioni, vedere Configurare i prerequisiti .

2. Esaminare le regole di selezione dei record. Alcuni valori nelle regole di selezione dei record potrebbero non essere risolti correttamente nell'ambiente di destinazione. Ad esempio, se la regola si basa su un team o un utente che non esiste nell'ambiente di destinazione, aggiornare la regola per assicurarsi che funzioni correttamente.

   1. Nella pagina di configurazione, vai alle Impostazioni di selezione record.
   2. Aggiornare eventuali valori non risolti o non corretti per assicurarsi che le regole di selezione dei record funzionino come previsto nell'ambiente di destinazione.
      Per altre informazioni sulla selezione dei record, vedere Selezionare i record per l'arricchimento.

3. Verificare l'accesso utente. L'accesso utente all'agente può variare tra gli ambienti di origine e di destinazione. Assicurarsi che gli utenti nell'ambiente di destinazione dispongano delle autorizzazioni necessarie per accedere e usare l'agente.

   1. Nella pagina di configurazione passare alla pagina Impostazioni di accesso utente .
   2. Verificare che tutti gli utenti che devono accedere all'agente dispongano delle autorizzazioni appropriate.
      Per altre informazioni sull'accesso utente, vedere Configurare l'accesso utente.

4. Verificare l'ambito del campo. I campi selezionati per l'arricchimento nell'ambiente di origine potrebbero non corrispondere a quelli nell'ambiente di destinazione. Esaminare i campi selezionati per assicurarsi che siano allineati ai requisiti nell'ambiente di destinazione.

   1. Nella pagina di configurazione passare alla pagina Impostazioni comportamento agente .
   2. Nella sezione Ambito campo esaminare i campi selezionati e aggiornarli, se necessario, per assicurarsi che l'agente arricchisca i dati corretti nell'ambiente di destinazione.
      Per altre informazioni sull'ambito del campo, vedere Configurare il comportamento dell'agente.

5. Attivare l'agente. Dopo aver aggiornato le impostazioni specifiche dell'ambiente, salvare e avviare l'agente.

Informazioni correlate

agenti AI in Dynamics 365 Remote Assist