Installare Copilot Studio Kit

Copilot Studio Kit è un toolkit open source per il test e la valutazione degli agenti di Copilot Studio. Ad esempio, consente di definire test case, simulare query utente e convalidare le risposte dell'agente. Questo articolo fornisce istruzioni dettagliate per l'installazione del kit da MarketplaceorGitHub, insieme ai passaggi di post-distribuzione e alle opzioni di configurazione.

Installare il Kit Copilot Studio dal Marketplace

Se si preferisce installare Copilot Studio Kit da GitHub, passare a Installare Copilot Studio Kit da GitHub.

Distribuzione dal Marketplace

Per distribuire Copilot Studio Kit da Marketplace, seguire questa procedura:

1. Vai al Copilot Studio Kit nel Marketplace.
2. Selezionare Scarica adesso.
3. Effettua l'accesso, se necessario.
4. Nella visualizzazione Installare Copilot Studio Kit selezionare l'ambiente in cui si vuole distribuire Copilot Studio Kit.
5. Esaminare i termini e le dichiarazioni. Se si accetta, selezionare le caselle e selezionare Installa.

Viene avviata l'installazione di Copilot Studio Kit.

Passaggi post-implementazione (Marketplace)

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

1. Accedere a Power Apps.
2. Andare a Soluzioni.
3. Seleziona Soluzione predefinita.
4. Selezionare Riferimenti alla connessione.
5. Trova Copilot Studio Kit - Dataverse e aprilo per modificarlo.
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.

Installare il Copilot Studio Kit da GitHub

Seguire questa procedura per installare Copilot Studio Kit da GitHub. Se si preferisce eseguire l'installazione da Marketplace, passare a Installare Copilot Studio Kit da Marketplace.

Scaricare la versione GitHub più recente

Scaricare la versione latest della soluzione managed per Power CAT Copilot Studio Kit.

Installare il file ZIP gestito di CopilotStudioKit

Per installare la soluzione gestita Copilot Studio Kit:

1. Accedere a Power Apps.
2. Selezionare l'ambiente in cui si vuole installare Copilot Studio Kit.
3. Andare 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)

Se è stata installata una versione precedente del kit di Copilot Studio e si vuole eseguire l'aggiornamento alla versione più recente, seguire questa procedura:

1. Accedere a Power Apps.
2. Selezionare l'ambiente in cui si vuole aggiornare Copilot Studio Kit.
3. Andare 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 se è stato installato Copilot Studio Kit da Marketplace o GitHub.

Configurare la sincronizzazione SharePoint

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

Indirizzare la connessione verso il sito di SharePoint di origine. Imposta 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 SharePoint:

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

Informazioni aggiuntive: Informazioni su configurazione degli agenti in Copilot Studio Kit, inclusa la procedura di 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 Studio Kit - Power Platform for Admins recupera l'elenco di ambienti nel tenant. Richiede autorizzazioni a livello di amministratore di Power Platform.
• Copilot Studio 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. Installare Copilot Studio Kit, descritto in precedenza in questo articolo.
2. Accedere a Power Apps.
3. Andare a Soluzioni.
4. Seleziona Soluzione predefinita.
5. Selezionare Riferimenti alla connessione.
6. Individuare il riferimento alla connessione Copilot Studio Kit - Power Platform for Admins e aprirlo per la modifica.
7. Verificare che tutti i campi obbligatori siano compilati e che la connessione selezionata sia valida.
8. Seleziona Salva.
9. Individuare il riferimento alla connessione Copilot Studio Kit - Dataverse e aprirlo per la modifica.
10. Verificare che tutti i campi obbligatori siano compilati e che la connessione selezionata sia valida.
11. Seleziona Salva.

Abilitare le metriche di utilizzo

Per abilitare le metriche di utilizzo facoltative nell'inventario agenti, completare la procedura seguente:

1. Assicurarsi che il connettore HTTP con Microsoft Entra ID (pre-autorizzato) sia consentito nell'ambiente in uso.
2. Importare il file _AgentInventoryUsage*managed.zip dal repository GitHub di Power CAT Copilot Studio Kit.
3. Durante il processo di importazione creare una connessione usando l'URL host di licenza: https://licensing.powerplatform.microsoft.com/

Abilitare i flussi

Per abilitare i flussi cloud inclusi nel Copilot Studio Kit, è possibile seguire la seguente procedura oppure utilizzare la procedura guidata Setup Wizard.

1. Installare Copilot Studio Kit, descritto in precedenza in questo articolo.
2. Accedere a Power Automate.
3. Assicurarsi di selezionare l'ambiente con il Copilot Studio Kit.
4. Selezionare Soluzioni.
5. Selezionare Copilot Studio Kit.
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 Compliance Hub, seguire i passaggi descritti in Impostare e configurare Copilot Studio Kit Compliance Hub. Compliance Hub richiede l'Inventario degli Agenti.

Configurare il dashboard KPI di conversazione incorporato

Questi passaggi sono necessari 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

Pubblicare il report

Per pubblicare il report KPI della conversazione:

1. Installare Copilot Studio Kit, descritto in precedenza in questo articolo.

2. Scaricare Conversation.KPIs.zip dal repository Power CAT Copilot Studio 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. Accedere a Power Apps e selezionare l'ambiente in cui è stato installato Copilot Studio 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.

Informazioni aggiuntive: Informazioni su configurazione degli agenti in Copilot Studio Kit, inclusa la procedura di configurare un nuovo agente per gli indicatori KPI di conversazione.

Accedere all'app kit di Copilot Studio

Per accedere all'app kit di Copilot Studio:

1. Accedere a Power Apps e selezionare l'ambiente in cui è stato installato Copilot Studio Kit.
2. Vai ad App.
3. Trovare e selezionare Power CAT Copilot Studio Kit.
4. Seleziona Gioca.
5. (Facoltativo) Aggiungere l'app ai segnalibri.

Passo successivo