Pubblicare l'agente nell'interfaccia di amministrazione di Microsoft

Usa il comando a365 publish per creare il pacchetto del tuo agente e quindi carica il pacchetto nell’interfaccia di amministrazione di Microsoft 365. Dopo la pubblicazione, puoi creare istanze dell'agente all'interno della tua organizzazione e gestire l'agente.

Prerequisiti

Prima di iniziare, accertati di disporre delle seguenti elementi.

Account e autorizzazioni obbligatori

• Tenant di Microsoft 365 con uno dei seguenti ruoli (richiesti per il passaggio di caricamento dell'interfaccia di amministrazione):

  • Amministratore globale

Strumenti richiesti

• Interfaccia della riga di comando di A365 installata (Interfaccia della riga di comando di Agent 365)

Passaggi di installazione obbligatori

Prima di pubblicare, completa questi passaggi:

1. Crea il progetto dell'agente - Segui il passaggio di configurazione per creare il progetto dell'agente.
2. Testa l'agente localmente - Verifica che l'agente funzioni correttamente con il playground per gli agenti (vedi Testare gli agenti in locale).
3. Prepara i file di configurazione - Verifica che a365.config.json e a365.generated.config.json siano aggiornati.

Comando Pubblica

Esegui il comando a365 publish:

a365 publish

Cosa fa questo comando:

1. Aggiorna manifesto - Aggiorna manifest.json con il tuo ID progetto dell'agente.
2. Crea un pacchetto - Pacchetti manifest.json e icone in manifest.zip.
3. Istruzioni di stampa - Mostra istruzioni passo dopo passo per il caricamento tramite l'interfaccia di amministrazione di Microsoft 365.

Caricare l'interfaccia di amministrazione

Al termine di a365 publish, segui le istruzioni stampate per caricare il tuo agente:

1. Vai all'interfaccia di amministrazione di Microsoft 365.
2. Vai su Agenti>Tutti gli agenti.
3. Seleziona Carica agente personalizzato.
4. Carica il file manifest.zip dalla cartella manifest del tuo progetto.

Per altre informazioni, vedi Caricare agenti nell'interfaccia di amministrazione di Microsoft 365.

Verifica che la pubblicazione sia avvenuta con successo

Usa la seguente lista di controllo per verificare che il tuo agente sia stato pubblicato con successo:

✅ La pubblicazione tramite interfaccia della riga di comando è stata completata
✅ Cartella manifest creata con manifest.json e manifest.zip
✅ L'agente appare nell'interfaccia di amministrazione di Microsoft

Output CLI

Visualizzi questi messaggi di output quando il comando publish viene eseguito con successo:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Istruzioni di caricamento passo dopo passo stampate

Se il comando non va a buon fine, controlla i messaggi di errore e assicurati di aver completato la configurazione del progetto.

Possibili errori:

Segui questi passaggi quando la pubblicazione non riesce.

File manifesto

Puoi verificare i seguenti file nella cartella manifest utilizzando il comando Test-Path di PowerShell.

# Check manifest folder and contents exists
Test-Path <deploymentProjectPath>/manifest/
Test-Path <deploymentProjectPath>/manifest/manifest.json
Test-Path <deploymentProjectPath>/manifest/manifest.zip
# All should return: True

L'agente appare nell'interfaccia di amministrazione

Verifica la presenza dell'agente seguendo questi passaggi:

1. Vai all'interfaccia di amministrazione di Microsoft 365.
2. Vai su Agenti>Tutti gli agenti.
3. L'agente è presente nell'elenco.

La tabella seguente mostra quali informazioni puoi trovare:

Vedi anche

• Configurare il progetto dell'agente
• L'agente non appare in Teams

Passaggi successivi

Dopo aver pubblicato il tuo agente, crea un'istanza così da poterla configurare e usarla nel tuo tenant.

Risoluzione dei problemi

Problemi comuni quando si pubblicano gli agenti nell'interfaccia di amministrazione di Microsoft 365.

Comando di pubblicazione non riesce

Sintomi:

• Errore durante a365 publish
• manifest.zip non è stato creato

Cause principali:

• Configurazione non completata
• Errori di convalida del manifesto
• Autorizzazioni insufficienti

Soluzione:

1. Verifica che la configurazione sia completata.

   Get-Content a365.generated.config.json | ConvertFrom-Json | Select-Object agentBlueprintId
   

2. Esegui il comando publish e segui i prompt.

Il caricamento non riesce nell’interfaccia di amministrazione

Sintomi:

• Errore durante il caricamento di manifest.zip nell'interfaccia di amministrazione di Microsoft 365
• L'agente non appare dopo il caricamento

Cause principali:

• Autorizzazioni insufficienti nell’interfaccia di amministrazione
• manifest.zip non valido o obsoleto

Soluzione:

1. Verifica di avere il ruolo di amministratore globale.
2. Esegui nuovamente a365 publish per generare un nuovo manifest.zip.
3. Prova a caricare di nuovo seguendo i passaggi di caricamento.

Per altre informazioni, vedi Caricare agenti nell'interfaccia di amministrazione di Microsoft 365.