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

I modelli di agente dichiarativo sono definizioni di agente predefinite progettate per Microsoft 365 Copilot. La libreria di agenti ti aiuta a personalizzare e a scaricare questi modelli, ma la distribuzione in Teams è sempre un passaggio manuale. Scarica il file .zip della soluzione e caricalo in Teams.

Quando selezioni un modello di agente dichiarativo nella libreria di agenti, si apre un pannello che mostra la descrizione del modello e tre opzioni di creazione.

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.

Personalizza e scarica

Personalizzare e scaricare è l'opzione più comune. Ti permette di configurare il modello direttamente nella libreria di agenti prima di scaricare il file di soluzione .zip pronto per la distribuzione.

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 per agente dichiarativo che vuoi usare.

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

5. Nel pannello di dettagli del modello, seleziona Personalizza e scarica, poi seleziona Continua. Si apre il pannello di personalizzazione.

6. Nel pannello di personalizzazione, modifica i seguenti campi:

   • Nome: il nome visualizzato dell'agente, ad esempio "Pianifica la mia giornata".
   • Descrizione: un breve riassunto di ciò che fa l'agente (fino a 1.000 caratteri). Aggiorna questo riassunto per riflettere il caso d'uso della tua organizzazione.
   • Istruzioni: il prompt completo del sistema che definisce la persona, il comportamento, le regole e lo stile di risposta dell'agente (fino a 8.000 caratteri). Personalizza questo prompt in base alle tue specifiche esigenze.
   • Funzionalità: attiva o disattiva le origini dati Microsoft 365 a cui l'agente può accedere.
   • Prompt di avvio: visualizza, aggiorna o elimina i prompt di avvio per l'agente dichiarativo.

   

7. Dopo aver personalizzato il modello, seleziona Download per scaricare il file .zip della soluzione modificata. Il file viene salvato sul tuo computer e si apre un nuovo pannello.

8. Il nuovo pannello mostra istruzioni dettagliate per installare l'agente in Teams:

   1. Apri Microsoft Teams (app desktop o teams.microsoft.com).
   2. Seleziona App nel riquadro sinistro. Viene visualizzato il riquadro App.
   3. Nella parte inferiore del riquadro App seleziona Gestire le app. Si apre la pagina Gestire le app.
   4. Seleziona Carica un'app, poi seleziona Carica nella sezione Carica un'app personalizzata.
   5. Seleziona il file .zip scaricato dal tuo computer. Si apre il pannello di dettagli delle app.
   6. Seleziona Aggiungi.

   

9. Seleziona Fatto.

Usa Agent Builder

Agent Builder ti permette di creare l'agente direttamente in Microsoft 365 Copilot. Non è necessario alcun upload del file .zip.

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 per agente dichiarativo che vuoi usare.

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

5. Nel pannello di dettagli del modello, seleziona Usa Agent Builder, quindi seleziona Continua. Una nuova scheda del browser si apre automaticamente con la guida alla configurazione di Microsoft 365 Agent Builder. Se la scheda non si apre, seleziona Download per scaricare una copia della guida di configurazione in formato PDF.

   

6. Segui la guida alla configurazione per configurare e distribuire direttamente il tuo agente in Microsoft 365 Copilot.

Crea con VS Code

Per gli sviluppatori che preferiscono un approccio basato sul codice, puoi clonare il repository dei modelli e personalizzarlo usando Visual Studio Code con l'estensione Toolkit agenti di Microsoft 365.

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 per agente dichiarativo che vuoi usare.

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

5. Nel pannello di dettagli del modello, seleziona Crea con VS Code, quindi seleziona Continua. Una nuova scheda del browser si apre automaticamente con la guida all'installazione per gli sviluppatori. Se la scheda non si apre, seleziona Download per scaricare una copia della guida di configurazione in formato PDF.

   

6. Copia l'URL clone di GitHub: https://github.com/microsoft/m365-agent-templates.git.

7. Clona il repository usando l'URL fornito.

8. Apri il repository clonato in Visual Studio Code.

9. Segui la guida alla configurazione dello sviluppatore per personalizzare la definizione dell'agente, le istruzioni e le capacità utilizzando l'estensione Toolkit agenti di Microsoft 365.

10. Carica manualmente l'agente su Teams seguendo questi passaggi:

    1. Apri Microsoft Teams (app desktop o teams.microsoft.com).
    2. Seleziona App nel riquadro sinistro. Viene visualizzato il riquadro App.
    3. Nella parte inferiore del riquadro App seleziona Gestire le app. Si apre la pagina Gestire le app.
    4. Seleziona Carica un'app, poi seleziona Carica nella sezione Carica un'app personalizzata.
    5. Seleziona il file .zip scaricato dal tuo computer. Si apre il pannello di dettagli delle app.
    6. Seleziona Aggiungi.