Pubblica l'agente nel centro amministrativo Microsoft

Usare il a365 publish comando per creare un pacchetto dell'agente e quindi caricare il pacchetto nell'interfaccia di amministrazione di Microsoft 365. Dopo la pubblicazione, è possibile creare istanze dell'agente all'interno dell'organizzazione e gestire l'agente.

Prerequisiti

Prima di iniziare, assicurati di avere i seguenti elementi.

Account e autorizzazioni obbligatori

• Tenant di Microsoft 365 con uno dei ruoli seguenti (obbligatorio per la fase di caricamento nel Centro amministrativo):

  • Amministratore globale
  • Amministratore ID Agente

Strumenti necessari

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

Passaggi di installazione obbligatori

Prima della pubblicazione, completare questi passaggi:

1. Crea il blueprint dell'agente - Segui il passaggio di configurazione per creare il blueprint dell'agente.
2. Agente di test in locale : verificare che l'agente funzioni correttamente usando Agents Playground (vedere Agenti di test in locale).
3. Preparare i file di configurazione : assicurarsi a365.config.json che e a365.generated.config.json siano aggiornati.

Comando Pubblica

Esegui il a365 publish comando:

a365 publish

Cosa fa questo comando:

1. Aggiorna il manifesto - Aggiorna manifest.json con il tuo ID del progetto agente
2. Creare un pacchetto - Pacchetti manifest.json e icone in manifest.zip
3. Istruzioni di stampa - Visualizza istruzioni dettagliate per il caricamento tramite l'interfaccia di amministrazione di Microsoft 365

Carica al centro amministrativo

Una volta che a365 publish è terminato, seguire le istruzioni stampate per caricare l'agente:

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

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

Verifica il successo della pubblicazione

Utilizza la seguente lista di controllo per verificare che il tuo agente abbia pubblicato con successo:

✅ La pubblicazione tramite CLI ha esito positivo
✅ manifest cartella creata con manifest.json e manifest.zip
✅ Agent viene visualizzato nell'interfaccia di amministrazione Microsoft

Output CLI

Questi messaggi di output vengono visualizzati quando il comando publish ha esito positivo:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Istruzioni dettagliate per il caricamento stampate

Se il comando non riesce, esaminare i messaggi di errore e assicurarsi di aver completato la configurazione del progetto.

Possibili errori:

Segui questi passaggi quando la pubblicazione fallisce.

File manifesto

È possibile testare i file seguenti nella manifest cartella usando il comando PowerShell Test-Path .

# 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 nel centro amministrativo

Verificare che l'agente sia presente attenendosi alla procedura seguente:

1. Passare a Microsoft 365 interfaccia di amministrazione.
2. Passare a Agenti>Tutti gli agenti.
3. L'agente viene visualizzato nell'elenco.

La tabella seguente mostra quali dettagli puoi trovare:

Vedere anche

• Blueprint dell'agente di configurazione
• 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 durante la pubblicazione di agenti nell'interfaccia di amministrazione di Microsoft 365.

Fallimento del comando Publish

Sintomi:

• Errore durante a365 publish
• manifest.zip non viene creato

Cause principali:

• La configurazione non è completa
• Errori di validazione manifesti
• Autorizzazioni insufficienti

Soluzione:

1. Verifica che la configurazione sia completa.

   a365 config display -g
   # Check for: 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 nel centro di amministrazione di Microsoft 365
• L'agente non viene visualizzato dopo il caricamento

Cause principali:

• Autorizzazioni insufficienti nell'interfaccia di amministrazione
• Non valido o obsoleto manifest.zip

Soluzione:

1. Assicurarsi di avere il ruolo Amministratore globale o Amministratore ID agente.
2. Eseguire a365 publish di nuovo per generare un nuovo manifest.zip oggetto.
3. Provare a caricare di nuovo seguendo la procedura di caricamento.

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