Condividi tramite

Crea raccolte di componenti riutilizzabili (anteprima)

  • Articolo

Una raccolta di componenti è una raccolta di componenti agente riutilizzabili. I componenti Copilot includono argomenti, conoscenze, azioni ed entità. È possibile Condividi raccogliere componenti tra più agenti all'interno del proprio ambiente. È inoltre possibile utilizzare una soluzione per esportare e importare raccolte di componenti per spostarne il contenuto su più ambienti per soddisfare i propri scenari di gestione del ciclo di vita delle applicazioni (ALM) .

Per modificare una raccolta di componenti o aggiungerne una a un agente, devi essere la persona che ha creato la raccolta o un utente con il ruolo addetto alla personalizzazione del sistema o di amministratore di sistema. Una volta che una raccolta di componenti è disponibile per un agente, tutti gli autori di agente possono vedere e utilizzare la raccolta, ma non possono modificare i componenti al suo interno. Altre informazioni sulla configurazione della sicurezza utente in un ambiente.

Crea raccolte di componenti

È possibile creare raccolte di componenti direttamente dalla pagina Impostazioni per un agente. Puoi anche crearli dalla pagina Libreria . Quando aggiungi componenti agente a una raccolta, questa operazione sposta i componenti selezionati nella raccolta. L'agente di origine contiene ora riferimenti a questi componenti all'interno della raccolta. Ora puoi Condividi la raccolta con altri agenti nel tuo ambiente, oppure impacchettarla in una soluzione da importare in altri ambienti.

Crea una raccolta di componenti da un agente

  1. Aprire il file agente che contiene i componenti che si desidera rendere disponibili come raccolta di componenti.

  2. Vai su Impostazioni e Seleziona Raccolte componenti.

  3. Se stai per creare la prima raccolta di componenti nel tuo ambiente, Seleziona Crea. Altrimenti, Seleziona Nuovo.

  4. Inserisci un nome e una descrizione per la raccolta dei componenti.

  5. Seleziona Avanti.

  6. Seleziona i componenti che vuoi aggiungere alla raccolta dei componenti. È possibile utilizzare le categorie e il campo di ricerca per restringere l'elenco dei componenti.

  7. Seleziona Avanti.

  8. Rivedi il contenuto della tua raccolta e Seleziona Crea.

Crea una raccolta di componenti dalla libreria

  1. Nella navigazione laterale, Seleziona Libreria.

  2. Seleziona Aggiungi nuovo, quindi Seleziona Raccolta componenti.

  3. Inserisci un nome e una descrizione per la raccolta dei componenti.

  4. Selezionare Fine.

  5. Connetti il file agente che contiene i componenti che vuoi aggiungere Condividi alla tua nuova raccolta di componenti.

  6. Aggiungi componenti dall'agente selezionato alla raccolta.

Connetti e agente a una raccolta di componenti

  1. Accedere alla libreria e usare Seleziona per creare la raccolta di componenti desiderata. È possibile Seleziona la categoria Raccolta componenti e il campo Cerca per restringere l'elenco delle raccolte componenti.

  2. Nell'area Installato su , Seleziona Add agente.

  3. Seleziona il agente in cui vuoi utilizzare la raccolta di componenti e Seleziona Aggiungi.

    È possibile aggiungere alla raccolta dei componenti qualsiasi componente degli agenti connessi. Tutti gli agenti connessi possono utilizzare anche tutti i componenti di quella raccolta.

Aggiungere componenti da un agente a una raccolta

  1. Accedere alla libreria e usare Seleziona per creare la raccolta di componenti desiderata. È possibile Seleziona la categoria Raccolta componenti e il campo Cerca per restringere l'elenco delle raccolte componenti.

  2. [Connetti il agente](#connect-an agent-to-a-component-collection) che vuoi aggiungere alla raccolta dei componenti, se non è già elencato nell'area Installato su .

  3. Seleziona Aggiungi, quindi Seleziona Aggiungi da un agente.

  4. Seleziona il agente desiderato e Seleziona Avanti.

  5. Seleziona i componenti che vuoi aggiungere alla raccolta dei componenti. È possibile utilizzare le categorie e il campo di ricerca per restringere l'elenco dei componenti.

  6. Seleziona Avanti.

  7. Rivedi il contenuto della tua raccolta e Seleziona Aggiungi alla raccolta.

Creare una soluzione per esportare e importare raccolte di componenti

Si utilizzano soluzioni per esportare i componenti agente da un ambiente e importarli in un altro. La soluzione funge da vettore per i componenti. È possibile esportare e importare più componenti agente in un'unica soluzione.

  1. Vai alla pagina Soluzioni .

  2. Selezionare Nuova soluzione.

  3. Immetti le informazioni seguenti per la nuova soluzione:

    • nome visualizzato: Nome da mostrare nell'elenco delle soluzioni. Puoi modificarlo in un secondo momento.
    • Nome: Nome univoco della soluzione, generato da nome visualizzato. Puoi cambiarlo solo prima di salvare la soluzione.
    • Editore: Seleziona è l'editore predefinito o ne può creare uno nuovo. Valuta la possibilità di creare un singolo editore e utilizzarlo in modo coerente in tutti gli ambienti per la tua soluzione. Altre informazioni sugli autori di soluzioni.
    • Versione: inserisci un numero per la versione della tua soluzione. Il numero di versione è incluso nel nome file durante l'esportazione della soluzione.

  4. Seleziona Crea.

Aggiungere raccolte di componenti a una soluzione

  1. Vai alla pagina Soluzioni e apri la soluzione desiderata, se non è già presente.

  2. Seleziona Aggiungi esistente, puntare a agente e Seleziona Componente collezione.

    Viene visualizzato un pannello che mostra tutte le raccolte di componenti disponibili.

  3. Seleziona le raccolte di componenti che vuoi esportare, quindi Seleziona Aggiungi nella parte inferiore del pannello.

Esportare una soluzione in raccolte di componenti Condividi in altri ambienti

È possibile esportare e importare raccolte di componenti esportando e importando le soluzioni che le contengono da un ambiente a un altro.

  1. Vai alla pagina Soluzioni .

  2. Seleziona l'icona Comandi (⋮) per la soluzione che contiene le raccolte di componenti che desideri esportare, quindi Seleziona Esporta soluzione.

  3. Immetti o seleziona le opzioni seguenti:

    • Numero di versione: Copilot Studio incrementa automaticamente la versione della soluzione. Puoi accettare la versione predefinita o inserire la tua.
    • Esporta come: Seleziona il tipo di pacchetto, Gestito o Non gestito. Altre informazioni sulle soluzioni gestite e non gestite.

  4. Selezionare Esporta. L'esportazione potrebbe richiedere diversi minuti. Guarda il messaggio di stato nella parte superiore della pagina Soluzioni.

  5. Una volta completata l'esportazione, Seleziona il pulsante Scarica per scaricare un file .zip.

    Il nome del file ha il seguente formato: NomeSoluzione_Versione_TipoSoluzione.zip, ad esempio ContosoSolution_1_0_0_1_managed.zip.

Importa una soluzione per aggiungere raccolte di componenti a un ambiente

  1. Vai alla pagina Soluzioni .

  2. Seleziona il ambiente in cui vuoi importare la tua raccolta di componenti.

  3. Selezionare Importa soluzione.

  4. Nel pannello Importa , Seleziona Browse, Seleziona il file .zip che contiene la soluzione con la raccolta dei componenti, quindi Seleziona Avanti.

  5. Seleziona Importa L'importazione potrebbe richiedere diversi minuti. Guarda il messaggio di stato nella parte superiore della pagina Soluzioni.

  6. Attendi alcuni momenti durante il completamento dell'importazione.

Se l'importazione non riesce, Seleziona Scarica il file di registro per scaricare un file XML contenente i dettagli sulla causa del fallimento dell'importazione. Il motivo più comune per cui un'importazione fallisce è che la soluzione non contiene alcuni componenti richiesti.

Aggiungi raccolte di componenti importate al tuo agente

Dopo aver importato una raccolta di componenti, puoi utilizzarla nei tuoi agenti.

  1. Aprire agente in cui si desidera utilizzare la raccolta di componenti.

  2. Vai alla pagina Impostazioni e seleziona Seleziona Raccolte componenti.

  3. Accanto alla raccolta dei componenti importati, Seleziona i puntini di sospensione (…) e Seleziona Aggiungi a agente.

    Apparirà un messaggio che ti chiederà di confermare.

  4. Seleziona Aggiungi a agente.

    Il nome del tuo agente appare sotto Attivo per per questa raccolta di componenti.

  5. Esamina i componenti della raccolta importata e pubblica agente per rendere le modifiche disponibili ai tuoi clienti.

Aggiungere componenti a una raccolta di componenti in una soluzione personalizzata

Se aggiungi nuovi componenti agente a una raccolta di componenti in Copilot Studio, devi aggiungerli anche a qualsiasi soluzione non gestita che faccia riferimento a questa raccolta di componenti.

  1. Accedere alla pagina Soluzioni e aprire la soluzione non gestita che contiene la raccolta di componenti da aggiornare.

  2. Nel riquadro Oggetti , raccolte di componenti Seleziona agente.

  3. Seleziona l'icona Comandi (⋮) per la raccolta che vuoi aggiornare, puntare su Avanzate e Seleziona Aggiungi gli oggetti richiesti.

  4. Seleziona OK.

    Nel riquadro Oggetti , puoi Seleziona agente componenti per verificare che i componenti previsti siano ora visualizzati.

Aprire Esplora soluzioni

In Copilot Studio, Seleziona i puntini di sospensione (…) nella navigazione laterale e Seleziona Soluzioni.

La pagina Soluzioni si apre in una nuova scheda del browser.

Problema noto

Se hai caricato file come fonti di conoscenza per un agente, l'aggiunta di tali file a una raccolta di componenti li rimuove dal agente di origine. Come soluzione alternativa, è possibile spostare tali file dalla raccolta dei componenti al loro agente di origine.