Publiser agenten til administrasjonssenteret for Microsoft

Bruk a365 publish-kommandoen for å pakke agenten, og last deretter opp pakken til Administrasjonssenter for Microsoft 365. Etter publisering kan du opprette agentinstanser i organisasjonen din og administrere agenten.

Forutsetning

Pass på at du har følgende elementer før du begynner.

Krav til kontoer og tillatelser

  • Microsoft 365-leietaker med én av følgende roller (påkrevd for opplastingstrinn til administrasjonssenteret):

    • Global administrator

Obligatoriske verktøy

Nødvendige oppsettrinn

Før publisering, fullfør disse trinnene:

  1. Opprett agentkursplan – Følg oppsettrinn for å opprette din agentkursplan.
  2. Test agent lokalt – Kontroller at agenten din fungerer riktig ved å bruke Agents Playground (se Test agenter lokalt).
  3. Forbered konfigurasjonsfiler – Sørg a365.config.json for at de a365.generated.config.json er oppdaterte.

Publiser, kommando

Kjør a365 publish kommando:

a365 publish

Notat

Når du kjører a365 publish -h vises alle alternativene som denne kommandoen støtter.

Hva denne kommandoen gjør:

  1. Oppdater manifest – oppdaterer manifest.json med blueprint-ID for agenten.
  2. Opprett pakke – Pakker manifest.json og ikoner inn i manifest.zip.
  3. Vis instruksjoner – Viser trinnvise instruksjoner for opplasting via Administrasjonssenter for Microsoft 365.

Notat

a365 publish-kommandoen fungerer både for agenter og AI-teammedlemmer. For agenter som er klargjort ved hjelp av --agent-name (konfigurasjonsfritt), sørg for at a365.generated.config.json finnes i arbeidskatalogen din før du kjører a365 publish, ettersom kommandoen leser blueprint-ID-en fra denne filen.

Last opp til administrasjonssenteret

Etter at a365 publish er ferdig, følg de viste instruksjonene for å laste opp agenten din:

  1. Gå til administrasjonssenteret for Microsoft 365.
  2. Gå til Agenter>Alle agenter.
  3. Velg Last opp en egendefinert agent.
  4. Last opp manifest.zip-filen fra manifest-mappen i prosjektet ditt.

For mer informasjon, se Last opp agenter til Administrasjonssenter for Microsoft 365.

Verifiser vellykket publisering

Bruk følgende sjekkliste for å verifisere at agenten din har blitt publisert vellykket:

✅ CLI-publisering lykkes
✅ manifest mappe opprettet med manifest.json og manifest.zip
✅ Agenten vises i Microsoft administrasjonssenter

CLI-utdata

Du ser disse utdataene når publiser-kommandoen utføres med suksess:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Trinn-for-trinn opplastingsinstruksjoner skrevet ut

Hvis kommandoen feiler, gå gjennom feilmeldingene og sørg for at du har fullført oppsettet av blueprint.

Mulige feil:

Feil Trinn for å løse
Agent blueprint ID not found Kjør a365 setup for å fullføre oppsettet av kursplanen.
Permissions missing Kjør oppsettet på nytt med kommandoen a365 setup permissions.

Følg disse trinnene når publisering mislykkes.

Manifestfiler

Du kan teste følgende filer i mappen manifest ved å bruke PowerShell-kommandoen 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

Notat

Hvis du ikke ser disse filene, prøv å kjøre a365 publishkommandoen på nytt.

Agent vises i administrasjonssenteret

Notat

Etter opplasting kan det ta 5-10 minutter før agenten din vises i administrasjonssenteret og Teams. Denne forsinkelsen er normal.

Bekreft at agenten er til stede ved å følge disse trinnene:

  1. Gå til Administrasjonssenter for Microsoft 365.
  2. Gå til Agenter>Alle agenter.
  3. Agenten din vises i listen.

Tabellen nedenfor viser hvilke detaljer du kan finne:

Felt Hva du bør sjekke
Navn Agentnavnet ditt (fra manifest.json)
Versjon Versjonsnummer (f.eks. 1.0.0)
Utgiver Ditt organisasjonsnavn
Tilgjengelighet Tilgjengelig/alle brukere

Se også

Neste trinn

Etter at du har publisert agenten din, opprett en instans slik at du kan konfigurere og bruke den i leietakeren din.

Opprett en agentforekomst

Feilsøking

Vanlige problemer ved publisering av agenter til Administrasjonssenter for Microsoft 365.

Tips

Feilsøkingsveiledning for Agent 365 inneholder anbefalinger på høyt nivå for feilsøking, anbefalte fremgangsmåter og koblinger til feilsøkingsinnhold for hver fase i utviklingssyklusen i Agent 365.

Publiserkommandoen feiler

Symptomer:

  • Feil ved a365 publish
  • manifest.zip er ikke opprettet

Rotårsak:

  • Installasjonen er ikke fullført
  • Manifest valideringsfeil
  • Utilstrekkelige tillatelser

Løsning:

  1. Kontrollere at oppsettet er fullført.

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

  2. Kjør publish-kommandoen og følg instruksjonene.

Oplasting feiler i administrasjonssenteret

Symptomer:

  • Feil ved opplasting av manifest.zip i administrasjonssenter for Microsoft 365
  • Agenten vises ikke etter opplasting

Rotårsak:

  • Utilstrekkelige tillatelser i administrasjonssenteret
  • Ugyldig eller utdatert manifest.zip

Løsning:

  1. Sørg for at du har rollen som Global Administrator.
  2. Kjør a365 publish på nytt for å generere en ny manifest.zip.
  3. Prøv å laste opp igjen i henhold til opplastingstrinnene.

For mer hjelp, se Last opp agenter til Administrasjonssenter for Microsoft 365.

  • Last updated on