Modelli di agente personalizzati nella libreria di agenti nel kit agente Copilot

I modelli di agente personalizzati sono agenti Copilot Studio predefiniti realizzati come soluzioni Power Platform. Offrono un punto di partenza completamente funzionale che puoi personalizzare con i tuoi argomenti, fonti di informazioni e componenti.

Prerequisiti

Prima di iniziare:

• Installa e configura il kit agente Copilot nel tuo ambiente Power Platform.
• L'utente connesso ha assegnato il ruolo di sicurezza CSK: autore nel kit agente Copilot per esplorare e installare i modelli.
• Nell'ambiente Power Platform è abilitato Copilot Studio.

Installare dal kit agente Copilot

L'installazione tramite il kit agente Copilot è il modo consigliato per installare un modello di agente personalizzato.

1. Nel kit agente Copilot vai a Libreria di agenti nel pannello a sinistra. Verrà visualizzata la pagina Libreria di agenti.

2. Seleziona la scheda Modelli.

3. Sfoglia o cerca il modello di agente personalizzato che vuoi installare.

4. Seleziona una scheda modello per agente personalizzato per aprire il pannello di dettagli del modello. Questo pannello include le sezioni seguenti:

   • Descrizione: una panoramica del modello e di cosa fa.
   • Ambiente: uno strumento di selezione che elenca tutti gli ambienti nel tuo tenant. Puoi eseguire l'installazione solo quando hai accesso com addetto alla personalizzazione del sistema o come amministratore di sistema nell'ambiente selezionato.
   • Collegati ai dati: elenca i riferimenti a una connessione richiesti dal modello (ad esempio Dataverse, OneDrive o Word Online). Ogni connessione mostra uno stato. Un segno di spunta verde indica che la connessione è pronta; un pulsante Crea indica che devi configurare la connessione prima di eseguire l'installazione.
   • Tecnologia utilizzata: tag che indicano le tecnologie incluse nel modello, come argomento, prompt o tabella personalizzata.

   

   I pulsanti di azione dipendono dallo stato dell'installazione del modello e dalle tue autorizzazioni:

   Scenario	Pulsanti mostrati	Risultato finale
   Hai i privilegi di installazione nell'ambiente selezionato.	Installa + Download	L'opzione Installa consente di importare la soluzione agente direttamente nel tuo ambiente.
   Non hai i privilegi di installazione nell'ambiente selezionato.	Solo Download	L'opzione Download salva un file .zip, così puoi importarlo manualmente. Altre informazioni in Importa un modello di agente personalizzato manualmente.

5. Assicurati che tutte le connessioni richieste in Collega ai dati mostrino un segno di spunta verde. Se una connessione mostra un pulsante Crea , selezionalo per configurare la connessione in Power Apps prima di procedere. Altre informazioni in Riferimenti alle connessioni.

6. Per iniziare l'installazione, seleziona Installa. Un indicatore di avanzamento appare mentre la soluzione viene importata.

7. Attendere il completamento dell'installazione. Appare una finestra di dialogo di conferma quando l'agente è pronto.

8. Seleziona Avvia Copilot Studio per aprire l'agente in Copilot Studio e iniziare a personalizzarlo.

   

Riferimenti a una connessione

Alcuni modelli di agente personalizzati richiedono riferimenti a una connessione a servizi esterni, come Dataverse, OneDrive o Word Online. La sezione Collegati ai dati nel pannello di dettagli del modello ti aiuta a gestire queste connessioni.

• Tutte le connessioni pronte: tutti i riferimenti a una connessione mostrano un segno di spunta verde. Il modello è pronto per l'installazione senza configurazioni aggiuntive.

  

• Riferimenti a una connessione da configurare: una o più connessioni mostrano un pulsante Crea. Seleziona Crea per il reindirizzamento a Power Apps, dove puoi configurare la connessione necessaria.

  

• Stato di connessione misto: alcune connessioni sono pronte, mentre altre necessitano ancora di configurazione. Risolvi tutte le connessioni in sospeso prima di installare. Dopo aver creato una connessione mancante, torna al pannello dei modelli e seleziona l'icona di aggiornamento accanto alla connessione per aggiornarne lo stato.

  

Importa manualmente un modello di agente personalizzato

Usa questa opzione se preferisci importare manualmente la soluzione del modello o se hai scaricato il file .zip della libreria di agenti.

1. Nel kit agente Copilot vai a Libreria di agenti nel pannello a sinistra. Verrà visualizzata la pagina Libreria di agenti.

2. Seleziona la scheda Modelli.

3. Sfoglia o cerca il modello di agente personalizzato da cui vuoi scaricare il file .zip del modello.

4. Seleziona una scheda modello per agente personalizzato per aprire il pannello di dettagli del modello.

5. Seleziona Scarica.

6. Vai a Power Apps.

7. Nella barra superiore, verifica di trovarti nell'ambiente corretto. Seleziona Ambiente per cambiare, se necessario.

8. Nel riquadro a sinistra, seleziona Soluzioni.

9. Nella barra dei menu superiore seleziona Importa soluzione.

10. Seleziona Sfoglia, quindi scegli il file .zip scaricato.

11. Seleziona Avanti, rivedi i dettagli della soluzione e seleziona ancora Avanti .

12. Se richiesto, configura eventuali riferimenti a una connessione necessari.

13. Seleziona Importa e attendi il completamento dell'importazione.