Estendere Microsoft 365 Copilot con agenti

Microsoft 365 Copilot offre esperienze predefinite per interagire con contenuti e risorse provenienti da tutta l'organizzazione. Sebbene la funzionalità predefinita fornisca molte funzionalità utili, a volte i clienti hanno bisogno di interagire con un assistente conversazionale più mirato, accessibile direttamente all'interno di Microsoft 365 Copilot. Un esempio di dove è utile un assistente più mirato è quando hai bisogno di supporto per un'area tematica specifica con un vocabolario specializzato, basato su una base di conoscenze specifiche della materia.

È possibile aiutare Microsoft 365 Copilot a gestire queste situazioni estendendolo con un agente specializzato in Copilot Studio.

Esistono due modi differenti in cui gli agenti possono essere aggiunti a Microsoft 365 Copilot:

• Agenti personalizzati
• Agenti Copilot

Nota

Gli agenti copiloti sono chiamati agenti dichiarativi in Microsoft 365 Copilot. Altre informazioni sull'estendibilità di Microsoft 365 Copilot.

Questo articolo tratta:

• Creazione di un agente personalizzato
• Creazione di un agente Copilot
• Aggiunta di strumenti e conoscenze a un agente
• Pubblicazione di un agente personalizzato in Microsoft 365 Copilot e Microsoft Teams

Quali sono gli agenti, gli strumenti, le conoscenze e i prompt suggeriti da Copilot?

La tabella seguente fornisce informazioni più dettagliate sulle differenze tra agenti Copilot, strumenti, conoscenze di Copilot e prompt suggeriti.

Nome	Definizione
agente personalizzato	Un agente personalizzato è un agente che un autore crea da zero. Un agente personalizzato può includere un'ampia gamma di funzionalità, tra cui informazioni, azioni e richieste suggerite. Gli agenti personalizzati vengono creati in un'interfaccia conversazionale che genera la richiesta per il modello Copilot Studio. Gli agenti personalizzati possono essere pubblicati nei canali Microsoft 365 Copilot e Teams, ma possono essere utilizzati anche con altri canali.
Agente Copilot	Un agente Copilot viene creato in Copilot Studio creando una richiesta per Microsoft 365 Copilot. Questa richiesta viene utilizzata per definire un set di comportamenti, personalità e regole di runtime che governano le interazioni dell'agente. Un agente Copilot è equivalente a un agente dichiarativo creato nel generatore di agenti di Microsoft 365 Copilot. Un agente Copilot viene utilizzato nel contesto dell'estensione Microsoft 365 Copilot e può essere dotato di azioni e conoscenze. Un agente Copilot può anche essere utilizzato direttamente come agente in Microsoft Teams.
Strumento	Meccanismo che consente a un agente di chiamare altri sistemi e recuperare dati o eseguire altre azioni. Gli strumenti sono interazioni a turno singolo. Gli strumenti possono usare l'autenticazione e possono includere parametri e altre funzionalità. Vedere Usare gli strumenti con agenti personalizzati.
Knowledge Base	La conoscenza si riferisce alle informazioni che si trovano nel tenant Microsoft 365, compreso SharePoint e i connettori Graph.
Richiesta suggerita	I prompt suggeriti sono prompt creati dai creatori in un agente virtuale che semplificano l'esecuzione di azioni comuni o sofisticate da parte dei clienti.

Mantenere gli agenti al sicuro

I clienti e i partner di Microsoft 365 possono creare agenti Copilot che estendono Microsoft 365 Copilot con istruzioni personalizzate, conoscenze di base e strumenti richiamati tramite descrizioni dell'API REST configurate dall'agente. Gli strumenti recuperano i dati che influenzano il comportamento del Copilot di Microsoft 365, tra cui origini non attendibili, ad esempio messaggi di posta elettronica e ticket di supporto. Gli utenti malintenzionati possono creare payload in queste fonti non attendibili per manipolare il comportamento dell'agente, ad esempio rispondendo in modo errato alle domande o richiamando azioni personalizzate.

Per proteggere il tuo agente dagli attacchi, utilizza i controlli in Copilot Studio per configurare connettori sicuri utilizzati per conoscenza e azioni personalizzate.

Prerequisiti

• Gli utenti e gli autori devono disporre di una licenza per utilizzare Microsoft 365 Copilot.
• I creatori devono disporre di permessi per creare e avere accesso a un ambiente Copilot Studio.

Creare e configurare un agente personalizzato

Per informazioni dettagliate sulla creazione e la configurazione degli agenti personalizzati, consulta i seguenti articoli:

• Creare un agente personalizzato
• Aggiunta di conoscenza a un agente personalizzato
• Aggiungere strumenti a un agente personalizzato

Crea un agente Copilot

La creazione di agenti Copilot in Copilot Studio è simile a quella degli agenti personalizzati, in quanto utilizza un'esperienza di creazione conversazionale.

Tuttavia, il punto di partenza è diverso per gli agenti Copilot.

Gli agenti personalizzati utilizzano il flusso di creazione dell'agente principale tramite Crea>Nuovo agente o Agenti>Nuovo agente.

Gli agenti Copilot, invece, vengono creati dalla pagina Copilot per la pagina Agente Microsoft 365 in Agenti.

Per creare un agente Copilot per Microsoft 365 Copilot:

1. Accedere a Copilot Studio all'indirizzo https://copilotstudio.microsoft.com

2. Vai ad Agenti nel riquadro di spostamento a sinistra.

3. Selezionare Copilot per Microsoft 365 nell'elenco degli agenti.

4. Da qui, seleziona Aggiungi sulla scheda Agenti. Viene reindirizzato all'esperienza di creazione conversazionale.

5. Descrivi con frasi complete cosa l'agente dovrebbe essere in grado di fare e sapere.

6. Quando l'interazione è completata, seleziona Ho finito nella chat.

   Nota

   Ignora l'interfaccia conversazionale in qualsiasi momento selezionando Passa alla configurazione.

7. Seleziona Crea per accedere alla pagina di panoramica dell'agente.

L'agente Copilot è stato creato. Puoi interagire con l'agente nel test canvas o aggiungervi altre funzionalità e conoscenze. Finora l'agente non ha origini di conoscenza. Le uniche informazioni in possesso dell'agente sono i dati fornitigli nelle istruzioni. L'agente non ha accesso alle conoscenze aziendali né ad altre azioni, pertanto le risposte vengono fornite in base alle conoscenze dell'IA generativa.

È possibile visualizzare l'agente Copilot appena creato nella scheda Agenti della pagina Copilot per l'agente Microsoft 365. Poiché l'agente non è un agente personalizzato, non viene visualizzato nell'elenco degli agenti principali.

Aggiungere la Knowledge Base a un agente Copilot

Quando si crea un agente per la prima volta, questo inizia con solo le conoscenze di base dell'IA generativa. L'agente non è a conoscenza di altre origini dati. Per aggiungere ulteriori conoscenze, aggiungi le conoscenze nella pagina Panoramica dell'agente o nella pagina Conoscenza.

Esistono tre tipi principali di conoscenza che possono essere aggiunti a un agente:

Nome	Definizione
SharePoint	Percorsi alle risorse SharePoint nell'organizzazione. Microsoft 365 Copilot utilizza le credenziali dell'utente per garantire che riceva solo risposte dalle informazioni a cui ha accesso.
Connettori di Copilot (Graph)	I connettori sono origini dati configurate dall'amministratore del tenant per aggiungere conoscenza a Microsoft Copilot e agli agenti. Altre informazioni sui connettori Copilot
Ricerca Web	L'agente può anche utilizzare la ricerca Web pubblica (tramite Bing) per recuperare i risultati Web

Nota

Ricerca Web viene configurata tramite la scheda delle funzionalità nella pagina di panoramica, non nella pagina di conoscenza.

Per iniziare ad aggiungere conoscenza all'agente:

1. Torna alla pagina di panoramica dell'agente.
2. Dalla scheda Conoscenza, seleziona Aggiungi conoscenza.
3. Scegli un'origine dati.
   • Se utilizzi SharePoint, specifica un percorso alla radice della raccolta o del sito. Al momento non è supportata la specificazione di una singola pagina o di un singolo file.
   • Se si usa un connettore Copilot e l'amministratore ha configurato un connettore Copilot in Microsoft 365, è possibile scegliere un connettore Copilot dalle origini dati configurate.
   • La ricerca Web può essere abilitata/disabilitata dalla pagina di panoramica dell'agente nella scheda Impostazioni aggiuntive .

È possibile aggiungere più origini di conoscenza con una combinazione di tipologie a un agente. Inoltre, per SharePoint, è possibile includere fino a quattro percorsi.

Una volta configurate le origini di conoscenza, l'agente con conoscenza è immediatamente disponibile nella chat di prova. Chiudi il riquadro della conoscenza, seleziona gesto di aggiornamento nella parte superiore della chat di prova per ottenere una nuova chat, quindi prova a porre le domande che dovrebbero essere presenti nell'origine dati.

Nota

Se i risultati non vengono restituiti, invia un feedback a Microsoft per l'analisi e il miglioramento del prodotto.

Aggiungere uno strumento a un agente Copilot

Uno strumento viene usato per consentire a un agente di recuperare informazioni o di eseguire un'attività, ad esempio l'aggiornamento di un record o il completamento di una transazione. Gli strumenti possono essere creati da connettori Copilot (noti anche come connettori power platform). I tipi di azione includono prompt di AI Builder, connettori predefiniti e connettori personalizzati. Per altre informazioni sui connettori Copilot, vedi Aggiungere azioni agli agenti personalizzati.

Nota

Attualmente, gli agenti Copilot non supportano i flussi degli agenti.

L'aggiunta di uno strumento richiede una pianificazione aggiuntiva da parte del creatore rispetto all'aggiunta di conoscenze. Entrano in gioco diverse considerazioni:

• Lo strumento deve usare l'autenticazione dell'utente o l'autenticazione dell'autore?
• Il creatore può fornire descrizioni per informare l'intelligenza artificiale generativa quando e come richiamare lo strumento?
• I parametri della funzione devono essere sempre compilati automaticamente oppure devono essere inseriti dal creatore al momento della creazione?

Ognuna di queste considerazioni entra in gioco quando si aggiungono strumenti a un agente.

Per aggiungere uno strumento:

1. Torna alla pagina di panoramica dell'agente Copilot.

2. Nella scheda Strumenti scegliere Aggiungi strumento.

3. Cercare lo strumento desiderato o scegliere Nuovo strumento.

   Se si seleziona Nuovo strumento, viene visualizzato un riquadro Aggiungi strumento in cui è possibile selezionare il tipo di strumento da aggiungere. Le opzioni disponibili sono:

   • Rapido
   • Uso del computer
   • Connettore personalizzato
   • REST API (Interfaccia di Programmazione delle Applicazioni REST)
   • Protocollo contesto modello

   I flussi di agenti non sono attualmente disponibili come opzione di estensione degli agenti Copilot.

4. Per ognuna delle nuove opzioni dello strumento, dopo aver selezionato il tipo di nuovo strumento da aggiungere, viene illustrata un'esperienza guidata per creare lo strumento. L'esperienza è simile a quella usata per aggiungere un nuovo strumento a un agente personalizzato.

Visualizzare e aggiornare le configurazioni degli strumenti

Dopo aver creato uno strumento, viene visualizzato nell'elenco degli strumenti nella pagina di panoramica dell'agente, in Strumenti. È possibile selezionare la voce dello strumento per visualizzare e modificare la configurazione dello strumento. Nell'esperienza di configurazione dello strumento sono disponibili tre schede:

• Dettagli
• Ingressi dati
• Risultati

Sezione Dettagli

La sezione Dettagli viene usata per configurare il nome dello strumento, il nome visualizzato e la descrizione.

• Nome strumento: nome dell'azione come illustrato in Microsoft 365 Copilot nelle citazioni. Queste informazioni possono anche essere influenti nell'aiutare Microsoft 365 Copilot scegliere l'azione da eseguire.
• Nome visualizzato: nome descrittivo per l'azione come visualizzato nell'esperienza utente di Microsoft 365 Copilot.
• Descrizione dell'agente per sapere quando usare questo strumento: una descrizione completa della conversazione di quando Copilot deve usare questa azione e il tipo di domande che lo attivano.

Sezioni input e output

Copilot Studio popola automaticamente un set di input e output ispezionando l'oggetto del connettore. L'autore può consentire a Copilot di compilare tali campi o compilarli manualmente durante la creazione.

Per impostazione predefinita, non è richiesta alcuna personalizzazione per questa esperienza, a meno che il creatore non scelga di compilare manualmente un campo o di sovrascrivere una descrizione.

Testare lo strumento

Dopo aver apportato le modifiche, è possibile testare lo strumento nella chat di test di Copilot Studio. Seleziona Aggiorna nella parte superiore della chat di prova, quindi poni una domanda che dovrebbe richiamare l'azione.

La prima volta che l'utente attiva l'azione, l'agente presenta una scheda di connessione nella chat. Questa scheda viene usata per richiedere all'utente di accedere all'azione con le proprie credenziali o di usare le credenziali di Single Sign-On (SSO), a seconda delle esigenze.

Prompt suggeriti

Spesso, quando gli utenti interagiscono per la prima volta con qualsiasi tipo di agente, non sanno cosa chiedere o non comprendono la ricchezza dell'agente. Di conseguenza tendono a porre domande semplici. Microsoft 365 Copilot risolve questo problema offrendo un'esperienza di suggerimenti suggeriti. I prompt suggeriti presentano all'utente semplici prompt per iniziare.

Copilot Studio genera automaticamente prompt suggeriti quando si usa l'esperienza di conversazione per creare l'agente. È anche possibile modificare o crearne uno personalizzato in qualsiasi momento dalla sezione Prompt suggeriti nella pagina Panoramica .

Comprendere i suggerimenti proposti

Un modo per usare i prompt suggeriti è servire da scorciatoia per domande semplici che si prevede che gli utenti chiedano. Tuttavia, rappresentano anche un'opportunità per presentare richieste più sofisticate che altrimenti l'utente potrebbe non comprendere.

All'interno delle richieste suggerite, gli autori dell'agente hanno accesso completo alle capacità del modello linguistico avanzato Microsoft 365 Copilot, comprese le azioni e le conoscenze che hai aggiunto. Prendi in considerazione la possibilità di creare richieste sofisticate che aiutino gli utenti a svolgere facilmente attività comuni.

Richieste suggerite dall'autore

1. Vai alla pagina Panoramica dell'agente.
2. Scorrere verso il basso fino a Prompt suggeriti e selezionare Modifica.
3. Aggiungere fino a sei prompt suggeriti e selezionare Salva.

Pubblica un agente personalizzato nel canale Teams + Microsoft 365

Puoi anche estendere Microsoft 365 Copilot con un agente personalizzato pubblicando l'agente nel canale Teams + Microsoft 365. Fai riferimento a Connessione e configurazione di un agente per Teams e Microsoft 365 per i dettagli su come pubblicare l'agente personalizzato nel canale Teams + Microsoft 365.

Pubblicazione di un agente Copilot

Una volta che l'agente funziona come desiderato nell'esperienza di test di Copilot Studio, puoi pubblicare. La pubblicazione converte l'agente dallo stato di bozza allo stato pubblicato, pronto per essere caricato nel catalogo dell'organizzazione. A differenza di un agente autonomo, un agente Copilot non viene distribuito automaticamente in Microsoft 365 Copilot e Teams una volta pubblicato.

Pubblicare l'agente Copilot

1. Torna alla pagina Panoramica dell'agente.

2. Scegli Pubblica in alto a destra.

   Le informazioni nel modulo successivo vengono utilizzate per popolare la voce di catalogo nei cataloghi di Office e Teams dell'organizzazione e nell'elenco delle app integrate di Interfaccia di amministrazione di Microsoft. Non viene utilizzato dal modello linguistico di Microsoft 365 Copilot.

3. Compila i campi come necessario e seleziona Pubblica.

   Una volta completata l'operazione, verrai indirizzato alla pagina Opzioni di disponibilità.

Nota

Quando selezioni Pubblica, viene eseguito il provisioning di una risorsa bot nell'ambiente Microsoft Entra ID del tenant, corrispondente all'agente Copilot. La risorsa consente agli utenti di interagire con l'agente in Microsoft Teams.

Configura opzioni di disponibilità

La pagina Opzioni disponibilità viene utilizzata per distribuire l'agente all'account dell'autore dell'agente affinché lo utilizzi o a piccoli gruppi di colleghi gestiti da elenchi di distribuzione, oppure per pubblicarlo nel catalogo dell'organizzazione da parte di un amministratore.

Nota

Se un amministratore ha disabilitato il sideload o la pubblicazione per il tenant, una o più di queste funzionalità potrebbero essere bloccate. Collaborare con l'amministratore del tenant per determinare il meccanismo di distribuzione più appropriato per il tenant.

Opzione Disponibilità	Descrzione
Condividi collegamento	Puoi copiare un collegamento diretto in Microsoft Teams per richiamare l'agente pubblicato. Aprendo il collegamento nel tenant si apre un'esperienza di chat con l'agente.
Mostra ai miei colleghi e agli utenti condivisi	Consente di concedere l'accesso ad altri per partecipare alla creazione dell'agente oppure a gruppi di sicurezza per concedere loro l'accesso per utilizzare l'agente in Microsoft 365 Chat o Teams.
Mostra a tutti nella mia organizzazione	Invia all'amministratore del tenant affinché lo aggiunga al catalogo organizzativo così che tutti gli utenti del tenant possano installarlo come desiderano.
Scarica come .zip	Scarica come cartella zip. Questa opzione di disponibilità ti consente di caricare manualmente in Teams/Microsoft 365 Copilot per inviarlo all'amministratore per la revisione o caricarlo direttamente nel catalogo dell'organizzazione.

Ulteriori informazioni sulla gestione delle app nel catalogo Teams sono disponibili qui: Gestisci app di Power Platform

Utilizza l'agente Copilot in Microsoft 365 Copilot o Microsoft Teams

L'agente deve ora essere disponibile per essere testato in Microsoft 365 Copilot o Teams. Gli utenti possono interagire con l'agente @mentioning nell'interfaccia di chat di Microsoft 365 Copilot o selezionando l'agente dalla barra laterale. Dopo che un utente seleziona un agente, l'utente interagisce solo con l'agente fino a quando non termina la conversazione e torna a Copilot o Teams.

Nello screenshot, l'utente richiede informazioni presenti nelle conoscenze incluse nell'agente. L'IA generativa, valutando istruzioni, conoscenza e azioni dell'agente, determina che il modo migliore per risolvere la richiesta è utilizzare la propria conoscenza per generare una risposta. L'IA generativa include anche i riferimenti per le fonti che utilizza per generare la risposta.

Suggerimenti per gli autori di agenti

• Microsoft 365 Copilot memorizza nella cache le risposte delle domande poste in precedenza in una determinata sessione, anche se ha chiamato un'azione per recuperare i dati. Per interrompere questa cache, usa il pulsante Nuova chat.
• Per maggiori informazioni sul motivo per cui l'IA generativa seleziona o meno un'azione, immetti -developer on nella casella di input di Microsoft 365 Copilot e poni la domanda.
• I risultati visualizzati in fase di esecuzione in Microsoft 365 Copilot potrebbero essere diversi da quelli visualizzati nel canvas di test di Copilot Studio e Microsoft Teams.
• A differenza degli agenti personalizzati, gli agenti Copilot non raccolgono dati nella scheda Analisi di Copilot Studio. Questa funzionalità è in fase di valutazione per le versioni future.
• Quando utilizzi Microsoft 365 Copilot per testare il tuo agente, usa l'esperienza di feedback "Non mi piace" per fornire feedback al team Microsoft Copilot affinché esamini e risolva i problemi. Il feedback non influisce direttamente sulla qualità di attivazione di Microsoft 365 Copilot.