Pubblica l'agente nel centro amministrativo Microsoft

Usa il a365 publish comando per pubblicare il tuo agente nel centro amministrativo Microsoft 365. Quando pubblichi il tuo agente, puoi creare istanze di agente all'interno della tua organizzazione. Puoi anche facilmente governare l'agente.

Prerequisiti

Prima di iniziare, assicurati di avere i seguenti elementi.

Account e autorizzazioni obbligatori

• Microsoft Entra tenant con uno dei seguenti ruoli:

  • Amministratore globale
  • Amministratore ID Agente
  • Sviluppatore ID Agente

• Sottoscrizione Azure con accesso contributore o proprietario

Strumenti necessari

• Interfaccia della riga di comando di Azure installata e autenticata (Installa l'interfaccia della riga di comando di Azure)
• 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 in ordine:

1. Crea il blueprint dell'agente - Segui il passaggio di configurazione per creare il blueprint dell'agente.
2. Prova l'agente localmente - Verifica che il tuo agente funzioni correttamente usando Agents Playground (vedi Testare agenti localmente)
3. Prepara i file di configurazione - Assicurati a365.config.json e a365.generated.config.json sono aggiornati

Comando Publish

Esegui il a365 publish comando:

a365 publish

Cosa fa questo comando:

1. Aggiorna manifesto - Aggiornamenti manifest.json e agenticUserTemplateManifest.json con il tuo ID blueprint dell'agente
2. Prompt di personalizzazione - Apre il tuo editor predefinito per personalizzare versione, nomi, descrizioni e icone
3. Crea pacchetto - Pacchetti manifest.json, icone e template utente agente in manifest.zip
4. Configura permessi - Aggiunge i permessi API necessari all'app client personalizzata
5. Carica nel servizio Titoli - Pubblica il pacchetto nel centro amministrazione Microsoft 365
6. Configura l'accesso al titolo - Imposta l'accesso per tutti gli utenti del tuo tenant
7. Configura l'autenticazione dei blueprint - Imposta l'identità del carico di lavoro e l'autenticazione a runtime
8. Concedere permessi Graph - Applica i permessi Microsoft Graph al progetto dell'agente

Personalizzare il manifesto

L'interfaccia della riga di comando viene sospesa durante la pubblicazione per consentire di personalizzare il manifesto dell'agente:

=== MANIFEST UPDATED ===
Location: [path]\manifest\manifest.json

=== CUSTOMIZE YOUR AGENT MANIFEST ===
Please customize these fields before publishing:
  Version ('version')
    - Increment for republishing (e.g., 1.0.0 to 1.0.1)
    - REQUIRED: Must be higher than previously published version
  Agent Name ('name.short' and 'name.full')
    - Make it descriptive and user-friendly
    - Currently: [your-agent-name] Blueprint
    - IMPORTANT: 'name.short' must be 30 characters or less
  Descriptions ('description.short' and 'description.full')
    - Short: 1-2 sentences
    - Full: Detailed capabilities
  Developer Info ('developer.name', 'developer.websiteUrl', 'developer.privacyUrl')
    - Should reflect your organization details
  Icons
    - Replace 'color.png' and 'outline.png' with your custom branding

Open manifest in your default editor now? (Y/n):

Verifica il successo della pubblicazione

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

✅ La pubblicazione di CLI ha✅ successomanifest Cartella creata con manifest.json e manifest.zip
✅ L'agente appare nel registro del centro amministrazione Microsoft
✅ Esistono credenziali di identità federate

Output CLI

Dovresti vedere questi messaggi di output quando la pubblicazione avrà successo:

✅ Upload succeeded con operationId e titolo
✅ Title access configured for all users
✅ Microsoft Graph permissions granted successfully
✅ Agent blueprint configuration completed successfully
✅ Publish completed successfully!

Se la pubblicazione fallisce, rivedere i messaggi di errore e assicurarsi che la configurazione del blueprint sia stata completata.

Possibili errori:

Segui questi passaggi quando la pubblicazione fallisce.

File manifesto

I seguenti file vengono creati nella manifest cartella e puoi testarli 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

Puoi confermare che l'agente è presente utilizzando questi passaggi:

1. Passa a: https://admin.cloud.microsoft/#/agents/all
2. Il tuo agente appare nella scheda Registro
3. La disponibilità appare come Tutti gli utenti (il segno verde indica successo)

La tabella seguente mostra quali dettagli puoi trovare:

Identità federata creata

Puoi visualizzare il record federated identity (FIC) creato in Microsoft Entra.

1. Vai su Registrazioni> App App Blueprint per il tuo agente
2. Naviga su Certificati e segreti>Credenziali federate
3. Vedi 2 FIC

Se non vedi questi record, controlla i permessi dell'app Blueprint nel portale Azure.

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 quando si pubblicano gli agenti nel centro amministrativo Microsoft.

Fallimento del comando Publish

Sintomi:

• Errore durante a365 publish
• L'agente non appare nel centro amministrativo

Cause radice:

• 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.

3. Quando ti viene richiesto, personalizza il manifesto:

   • Aggiorna il numero di versione (deve essere unico se si ripubblica)
   • Imposta il nome dell'agente (30 caratteri o meno)
   • Aggiorna le descrizioni
   • Verifica le informazioni dello sviluppatore

4. Scrivi continue o c continuare dopo la personalizzazione.