Modelli personalizzati nella libreria di agenti nel kit agente Copilot

Gli amministratori possono estendere la libreria di agenti creando modelli personalizzati, ovvero modelli di agente specifici per l'organizzazione memorizzati in Dataverse. I modelli personalizzati appaiono accanto ai modelli di sistema nella libreria di agenti e sono disponibili per gli autori per la consultazione a l'installazione.

Nota

Solo gli utenti con il ruolo di sicurezza CSK - Amministratore possono gestire modelli personalizzati. Gli autori vedono i modelli personalizzati pubblicati nella raccolta ma non possono crearli, modificarli o eliminarli.

I modelli personalizzati supportano due stati di pubblicazione:

Status Comportamento
Attive Visibili sia agli amministratori che agli autori. Gli autori possono esplorarli e installarli.
Inattivo Visibili solo agli amministratori. Agiscono come una bozza: gli autori non possono né vederli né installarli.

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 - Amministratore nel kit agente Copilot per creare, modificare, pubblicare, annullare la pubblicazione ed eliminare modelli personalizzati.
  • Nell'ambiente Power Platform è abilitato Copilot Studio.

Creare un modello personalizzato

  1. Nel kit agente Copilot vai a Libreria di agenti nel pannello a sinistra. Verrà visualizzata la pagina Libreria di agenti.
  2. Seleziona + Nuovo modello. Si apre il pannello Nuovo modello.
  3. Compila i campi obbligatori:
    1. Nome: il nome visualizzato del modello, ad esempio "Pianifica la mia giornata".
    2. Descrizione: una breve descrizione dello scopo e della funzionalità del modello.
    3. Stato di pubblicazione: imposta lo stato di visibilità del modello su Attivo o Inattivo.
    4. Icona e colore: scegli un'icona e un colore per rappresentare il modello.
    5. File modello (.zip): carica una soluzione agente di Copilot Studio o un pacchetto di agente dichiarativo con file ZIP fino a 30 MB.
    6. URL Scopri di più: opzionalmente fornisci un URL alla documentazione per ulteriori informazioni.
    7. URLdella guida di configurazione: opzionalmente fornisci un URL per una guida di configurazione.
  4. Seleziona Crea. La libreria di agenti si aggiorna automaticamente per mostrare la nuova scheda del modello.

Suggerimento

Crea un modello con lo stato di pubblicazione Inattivo per usarlo come bozza. Quando lo desideri, modifica il modello e cambia lo stato in Attivo per renderlo visibile agli autori.

Modifica un modello personalizzato

Per modificare un modello personalizzato, esegui questa procedura:

  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 modificare.
  4. Seleziona l'icona ModificaImmagine dell'icona Modifica. in una scheda di modello personalizzato (identificata dall'indicatore "Personalizzato"). Si apre il pannello Modifica modello.
  5. Aggiorna eventuali campi oppure seleziona Sostituisci file per caricare un nuovo file ZIP della soluzione.
  6. Seleziona Salva.

Importante

Quando cambi lo stato di pubblicazione di un modello da Attivo a Inattivo, il modello scompare immediatamente dalla libreria di agenti. Gli autori che hanno già installato l'agente non sono interessati, ma le nuove installazioni vengono bloccate fino a quando il modello non viene ripubblicato.

Eliminare un modello personalizzato

Per eliminare un modello personalizzato, esegui questi passaggi:

  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 eliminare.
  4. Seleziona l'icona ModificaImmagine dell'icona Modifica. in una scheda di modello personalizzato (identificata dall'indicatore "Personalizzato"). Si apre il pannello Modifica modello.
  5. Seleziona Elimina modello, quindi conferma l'eliminazione.

Importante

L'eliminazione di un modello personalizzato è un'azione permanente. Gli agenti precedentemente installati da questo modello non sono interessati.