Installa il Copilot Agent Kit

Copilot Agent Kit è un toolkit open-source per testare e valutare gli agenti di Copilot Studio. Ad esempio, consente di definire test case, simulare query utente e convalidare le risposte dell'agente. Questo articolo fornisce istruzioni passo dopo passo per installare il kit da Marketplace o GitHub, insieme ai passaggi post-distribuzione e alle opzioni di configurazione.

Installa il kit Copilot Agent dal Marketplace

Se preferisci installare Copilot Agent Kit da GitHub, salta a Installa Copilot Agent Kit da GitHub.

Distribuzione dal Marketplace

Per distribuire il Copilot Agent Kit da Marketplace, segui questi passaggi:

1. Vai al kit Copilot Agent nel mercato.
2. Selezionare Scarica adesso.
3. Accedere, se necessario.
4. Nella vista Installa il Kit Agente Copilot, seleziona l'ambiente in cui vuoi distribuire il Kit Agente Copilot.
5. Esaminare i termini e le dichiarazioni. Se si accetta, selezionare le caselle e selezionare Installa.

Inizia l'installazione del Copilot Agent Kit.

Passaggi post-implementazione (Marketplace)

Al termine dell'installazione, seguire questa procedura post-distribuzione:

1. Accedi a Power Apps.
2. Vai a Soluzioni.
3. Seleziona Soluzione predefinita.
4. Selezionare Riferimenti alla connessione.
5. Localizza il Copilot Agent Kit - Dataverse e aprilo per la modifica.
6. Assicurarsi che tutti i campi obbligatori siano compilati e che la connessione selezionata sia valida. Creare una nuova connessione a Dataverse in base alle esigenze.
7. Seleziona Salva.
8. Seguire ulteriori passaggi di configurazione e passaggi facoltativi.

Installa il Copilot Agent Kit da GitHub

Segui questi passaggi per installare Copilot Agent Kit da GitHub. Se preferisci installare dal Marketplace, vai su Installa il kit agente Copilot dal Marketplace.

Scaricare la versione più recente di GitHub

Scarica l'ultima versione della soluzione gestita per il Power CAT Copilot Agent Kit.

Installa il file zip gestito del Copilot Agent Kit

Per installare la soluzione gestita del Copilot Agent Kit:

1. Accedi a Power Apps.
2. Seleziona l'ambiente dove vuoi installare Copilot Agent Kit.
3. Vai a Soluzioni.
4. Selezionare Import Solution.
5. Seleziona Sfoglia.
6. Selezionare il file CopilotStudioKit*_managed.zip.
7. Seleziona Avanti.
8. Dopo aver esaminato le informazioni sulla soluzione, selezionare Avanti.
9. Se richiesto, creare le connessioni necessarie e selezionare Importa.
10. Lasciare i valori del Report KPI della conversazione così com'è per il momento. È possibile aggiornare questi valori in un secondo momento.
11. Attendere il completamento dell'operazione di importazione.

Aggiornare la soluzione esistente (GitHub)

Per aggiornare all'ultima versione del Copilot Agent Kit, segui questi passaggi:

1. Accedi a Power Apps.
2. Seleziona l'ambiente in cui vuoi aggiornare il Copilot Agent Kit.
3. Vai a Soluzioni.
4. Selezionare Import Solution.
5. Seleziona Sfoglia.
6. Selezionare CopilotStudioKit*_managed.zip.
7. Seleziona Avanti. Power Apps riconosce che questo aggiornamento è una soluzione gestita esistente.
8. Verificare di voler aggiornare la soluzione esistente selezionando Avanti.
9. Lasciare i valori del Report KPI della conversazione così com'è per il momento. È possibile aggiornare questi valori in un secondo momento.
10. Seleziona Importa

Passaggi di configurazione aggiuntivi e facoltativi

Questi passaggi di configurazione si applicano sia che tu abbia installato il Copilot Agent Kit dal Marketplace o da GitHub.

Configurare la sincronizzazione di SharePoint

I passaggi seguenti sono facoltativi e obbligatori solo se si prevede di utilizzare la funzionalità di sincronizzazione di SharePoint . È possibile impostare questi valori in qualsiasi momento prima di usare la funzionalità.

Indirizzare la connessione verso il sito di SharePoint di origine. Impostare l'URL di Dataverse all'istanza di Dataverse per gli agenti personalizzati di destinazione dove il contenuto viene sincronizzato.

È possibile seguire questa procedura o usare Setup Wizard per configurare il riferimento alla connessione SharePoint.

Per usare la funzionalità di sincronizzazione di SharePoint:

1. Installa il Copilot Agent Kit, descritto in precedenza in questo articolo.
2. Accedi a Power Apps.
3. Vai a Soluzioni.
4. Seleziona Soluzione predefinita.
5. Selezionare Riferimenti alla connessione.
6. Trova il riferimento alla connessione Copilot Agent Kit - SharePoint e aprilo per la modifica.
7. Verificare che tutti i campi obbligatori siano compilati e che la connessione selezionata sia valida. Creare una nuova connessione a SharePoint in base alle esigenze.
8. Seleziona Salva.

Maggiori informazioni: Scopri come configurare gli agenti in Copilot Agent Kit, incluso come configurare un nuovo agente per la sincronizzazione dei file.

Configurare l'inventario degli agenti

I passaggi seguenti sono facoltativi e obbligatori solo se si prevede di usare la funzionalità Inventario agenti . È possibile impostare questi valori in qualsiasi momento prima di usare la funzionalità.

I riferimenti alla connessione nella soluzione controllano la visibilità degli agenti. Anche se è possibile usare altri account, usare queste autorizzazioni per ottenere visibilità completa.

• Copilot Agent Kit - Power Platform for Admins recupera l'elenco degli ambienti nel tenant. Richiede autorizzazioni a livello di amministratore di Power Platform.
• Copilot Agent Kit - Dataverse raccoglie le informazioni dell'agente dagli ambienti. Richiede autorizzazioni a livello di amministratore di sistema per tutti gli ambienti.

Puoi seguire questi passaggi o usare la Assistente di Configurazione per configurare i riferimenti di connessione dell'Agente Inventario.

Per usare la funzionalità Inventario agenti:

1. Installa il Copilot Agent Kit, descritto in precedenza in questo articolo.
2. Accedi a Power Apps.
3. Vai a Soluzioni.
4. Seleziona Soluzione predefinita.
5. Selezionare Riferimenti alla connessione.
6. Trova il riferimento alla connessione Copilot Agent Kit - Power Platform for Admins e aprilo per la modifica.
7. Verificare che tutti i campi obbligatori siano compilati e che la connessione selezionata sia valida.
8. Seleziona Salva.
9. Trova il riferimento alla connessione Copilot Agent Kit - Dataverse e aprilo per la modifica.
10. Verificare che tutti i campi obbligatori siano compilati e che la connessione selezionata sia valida.
11. Seleziona Salva.

Abilitare i flussi

Per abilitare i flussi cloud inclusi nel Copilot Agent Kit, segui questi passaggi oppure usa il Setup Wizard.

1. Installa il Copilot Agent Kit, descritto in precedenza in questo articolo.
2. Accedi a Power Automate.
3. Assicurati che l'ambiente con il kit Copilot Agent sia selezionato.
4. Selezionare Soluzioni.
5. Seleziona il kit Copilot Agent.
6. Seleziona Flussi cloud.
7. Assicurarsi che tutti i flussi siano abilitati (Stato = Attivato).
8. Abilitare tutti i flussi non abilitati, nell'ordine seguente:
   1. Flussi che terminano con Grandchild.
   2. Flussi che terminano con Child.
   3. Il resto dei flussi, come richiesto, in qualsiasi ordine.

Istituire un Compliance Hub

Per configurare il Compliance Hub, segui i passaggi in Configura e configura il Copilot Agent Kit Compliance Hub. Compliance Hub richiede l'Inventario degli Agenti.

Configurare il dashboard KPI di conversazione incorporato

Seguire questi passaggi solo se si prevede di usare il dashboard degli indicatori KPI di conversazione incorporati.

Durante i passaggi, prendere nota dei valori seguenti:

• Nome dell'area di lavoro
• GUID dell'area di lavoro
• Nome del report
• Rapporto GUID

Pubblicazione del report

Per pubblicare il report KPI della conversazione:

1. Installa il Copilot Agent Kit, descritto in precedenza in questo articolo.

2. Scarica Conversation.KPIs.zip dal repository Power CAT Copilot Agent Kit GitHub.

3. Estrai i contenuti del file .zip.

4. Aprire il file Conversation KPIs.pbit nell'applicazione desktop Power BI.

5. Immettere l'URL dataverse come URL dell'ambiente nella finestra di dialogo visualizzata e selezionare Carica (ad esempio, org3c23948.crm.dynamics.com, senza il https:// prefisso).

   Se la finestra di dialogo non viene visualizzata, immettere l'URL dell'ambiente in Home>Modifica dati>Modifica parametri.

6. Aggiornare i dati e accedere in base alle esigenze.

7. Salvare e pubblicare in un'area di lavoro.

8. Prendere nota del nome del report e del nome dell'area di lavoro.

9. Accedere a Power BI.

10. Aprire il report pubblicato e prendere nota del GUID dell'area di lavoro e del GUID del report nell'URL.

    Se si pubblica in "Area di lavoro personale", il GUID dell'area di lavoro è 00000000-0000-0000-0000-000000000000.

11. Seleziona i tre punti (...) e poi Visualizza modello semantico.

12. Apri File>Impostazioni.

13. Verificare che le credenziali dell'origine dati non abbiano problemi. Accedere per risolvere eventuali problemi.

14. Passare a Aggiorna e impostare la pianificazione dell'aggiornamento.

Aggiornare la variabile di ambiente del report

Per configurare il dashboard degli indicatori KPI di conversazione incorporati, aggiornare la variabile di ambiente correlata con gli identificatori corretti. Puoi seguire questi passaggi oppure usare la Assistente di Configurazione.

1. Accedi a Power Apps e seleziona l'ambiente dove hai installato Copilot Agent Kit.
2. Seleziona Soluzioni>Soluzione predefinita.
3. Seleziona Variabili di ambiente.
4. Trova e seleziona Report KPI di conversazione.
5. Sostituire i segnaposto nel valore predefinito con il nome dell'area di lavoro, il GUID dell'area di lavoro, il nome del report e i valori GUID del report annotati durante il processo di pubblicazione.
6. Seleziona Salva.

Scopri come configurare gli agenti in Copilot Agent Kit, incluso come configurare un nuovo agente per i KPI della conversazione.

Accedi all'app Copilot Agent Kit

Per accedere all'app Copilot Agent Kit:

1. Accedi a Power Apps e seleziona l'ambiente dove hai installato Copilot Agent Kit.
2. Vai a App.
3. Trova e seleziona il Power CAT Copilot Agent Kit.
4. Selezionare Riproduci.
5. (Facoltativo) Aggiungere l'app ai segnalibri.

Condividi l'app Copilot Agent Kit

Dopo aver verificato che l'app si avvii con successo, il proprietario (o l'amministratore di sistema che ha installato il kit) deve condividere l'app Copilot Agent Kit con il team.

1. Accedi a Power Apps.
2. Selezionare App.
3. Cerca "Copilot Agent Kit" e trova quello con il tipo Code (non l'app guidata dal modello).
4. Selezionare i tre puntini (...) e quindi selezionare Condividi accanto al nome dell'app.
5. Cercare e aggiungere gli utenti o i gruppi di sicurezza che necessitano dell'accesso.
6. Selezionare Condividi per confermare.

Per altre informazioni, vedere Condividere un'app canvas con l'organizzazione.

Passo successivo