Crea istanze di agente

Importante

Devi far parte del programma di anteprima Frontier per ottenere l'accesso in anteprima a Microsoft Agent 365. Frontier ti mette in contatto diretto con le ultime innovazioni di Microsoft nell'IA. Le anteprime Frontier sono soggette alle condizioni di anteprima esistenti dei tuoi contratti del cliente. Poiché queste funzionalità sono ancora in fase di sviluppo, la disponibilità e le funzionalità possono cambiare nel tempo.

Una volta che il tuo agente è pubblicato e disponibile nel Microsoft Admin Center, è pronto per essere istanziato in istanze e utenti agent, in base al blueprint dell'agente e al codice dell'agente che hai creato.

Prerequisiti

• Blueprint dell'agente configurato correttamente secondo il passaggio del Blueprint dell'agente.
• L'applicazione dell'agente è stata pubblicata correttamente secondo Publish agent al Microsoft Admin Center

1. Configura l'agente nel Portale Sviluppatori di Teams

Dopo la pubblicazione, devi configurare il blueprint dell'agente nel Portale Sviluppatori di Teams per collegare il tuo agente all'infrastruttura di messaggistica di Microsoft 365. Senza questa configurazione, il tuo agente non riceve messaggi da Teams, email o altri servizi Microsoft 365.

Ottieni il tuo ID del progetto

Esegui il seguente comando per visualizzare la tua configurazione:

a365 config display -g

Copiare il valore agentBlueprintId dall'output.

Naviga al Portale Sviluppatori

Apri il browser e vai alla pagina di configurazione:

https://dev.teams.microsoft.com/tools/agent-blueprint/<your-blueprint-id>/configuration

Sostituisci <your-blueprint-id> con il agentBlueprintId valore che hai copiato.

Annotazioni

Se non hai accesso al Portale degli Sviluppatori, contatta l'amministratore del tuo tenant per concederti l'accesso o completare questa configurazione per tuo conto.

Configurare l'agente

Nel portale sviluppatori:

1. Imposta il tipo di agente su basato su bot
2. Imposta l'ID del bot al tuo agentBlueprintId valore
3. Seleziona Salva

Questa configurazione è richiesta prima di poter creare istanze di agente in Teams.

Per maggiori informazioni sui Blueprint di Identità Agente e sulla configurazione del Portale Sviluppatori, vedi Configura il Blueprint di Identità Agente.

2. Crea un'istanza di agente

Ora puoi richiedere istanze del blueprint del tuo agente da Teams. Questa richiesta va nuovamente all'amministratore del tenant, che deve approvare dalla scheda Richieste nel Centro Amministrazione Microsoft 365: Centro Amministrazione Microsoft - Agenti Richiesti. Una volta approvato, puoi creare un'istanza agente da Teams. Vedi come farlo qui: scopri, crea e integra un agente

3. Testa il tuo agente schierato

Dopo aver creato un'istanza agente, puoi testarla in Microsoft 365 per assicurarti che funzioni correttamente in produzione.

Dopo il deployment, e con le notifiche degli agenti attivate nell'SDK Agent 365, il tuo agente si integra con i servizi Microsoft 365. Funziona con Teams per chat, canali e riunioni; con email e calendario per invio/ricezione e programmazione; e con SharePoint e OneDrive per l'accesso ai documenti e la condivisione dei file. Supporta inoltre funzionalità di collaborazione come la presenza organizzativa, le attività del Planner e i commenti ai documenti.

Importante

Proprio come gli utenti normali, anche gli utenti agenti necessitano di licenze Microsoft 365 appropriate per accedere ai servizi. Le licenze comuni includono Microsoft 365 E5, Teams Enterprise e Microsoft 365 Copilot.

Visualizzare l'agente distribuito nell'interfaccia di amministrazione

Dopo aver pubblicato il tuo agente, appare nel Microsoft Admin Center per l'assunzione. Potrebbe volerci un po' di tempo per propagarsi.

Accedi all'interfaccia di amministrazione di Microsoft 365 - Agenti per:

• Visualizzare l'agente pubblicato
• Gestire le impostazioni dell'agente
• Monitorare l'utilizzo dell'agente
• Configura autorizzazioni

Testare l'agente in Teams

Dopo aver distribuito, pubblicato, configurato il blueprint dell'agente e creato un utente agente, puoi testare direttamente l'utente agente in Microsoft Teams:

Annotazioni

Requisito della licenza: Assicurati di avere la licenza "Microsoft Agent 365 Frontier" assegnata al tuo account. Questa licenza è necessaria per creare istanze di agente e interagire con gli agenti in Microsoft Teams mentre l'Agente 365 è in Anteprima. Contatta l'amministratore del tuo inquilino se non possiedi questa licenza.

1. Inizia i test

   • Cerca il tuo nuovo utente agente in Teams. Il processo di creazione dell'utente agente è asincrono e può richiedere da pochi minuti a qualche ora perché l'utente agente diventi ricercabile dopo la creazione.
   • Avvia una nuova chat con la tua nuova istanza di agente creata.
   • Invia messaggi di test per verificare la funzionalità dell'agente.

2. Messaggio di test di esempio

   Se hai configurato l'agente con Email, invia questo messaggio per testare la funzionalità email (aggiorna l'email del destinatario secondo necessità):

   Send an email to recipient@contoso.com with subject "Hello from Teams" and message "This is a test message from my agent!"
   

   L'agente deve elaborare la richiesta e inviare il messaggio e-mail richiedere più conferma.

Passaggi successivi

Congratulazioni! Il tuo agente è ora live nel cloud e pronto a lavorare insieme al tuo team su Microsoft 365. Quello che è iniziato come codice locale è ora un assistente rilevabile e pronto per l'impresa dove gli utenti possono creare istanze di agente in tutta l'organizzazione. Il ciclo di sviluppo del tuo agente è completo—ma il suo impatto è appena iniziato.

Gran parte di ciò che hai costruito nel ciclo di vita dello sviluppatore dell'agent 365 è open-source e accoglie i contributi della community. Segnala bug, richieste di funzionalità e pull request:

• Campioni Agent 365: Hai qualche agente campione interessante e divertente? Condividi qui il tuo codice di agente con la community open source!
• Node.js SDK: L'SDK dell'Agente 365 in Node.js
• SDK Python: L'SDK Agent 365 in Python
• .NET SDK: L'SDK Agent 365 in C# (.NET)
• Agent 365 DevTools CLI: Una CLI per aiutarti durante tutto il ciclo di sviluppo di Agent 365