Agentin julkaiseminen Microsoft-hallintakeskuksessa

Käytä komentoa a365 publish paketoidaksesi agenttisi ja ladataksesi paketin Microsoft 365 -hallintakeskukseen. Julkaisun jälkeen voit luoda agentti-instansseja organisaatioosi ja hallita agenttia.

Edellytykset

Varmista ennen aloittamista, että sinulla on seuraavat nimikkeet:

Vaaditut tilit ja käyttöoikeudet

  • Microsoft 365 -vuokraaja, jolla on jokin seuraavista rooleista (vaaditaan hallintakeskukseen lataamista varten):

    • – yleinen järjestelmänvalvoja

Tarvittavat työkalut

Vaaditut asennusvaiheet

Ennen julkaisua suorita seuraavat vaiheet:

  1. Luo agentin blueprint – seuraa asennusvaihetta agentin blueprintin luomiseksi.
  2. Testaa agentti paikallisesti – Varmista, että agenttisi toimii odotetusti käyttämällä Agenttien testausalustaa (katso Testaa agentteja paikallisesti).
  3. Valmistele konfiguraatiotiedostot: Varmista, että a365.config.json ja a365.generated.config.json ovat ajan tasalla.

Julkaise-komento

Suorita a365 publishkomento.

a365 publish

Muistiinpano

Komennon a365 publish -h suorittaminen näyttää kaikki komennon käytettävissä olevat vaihtoehdot.

Mitä tämä komento tekee:

  1. Päivitä manifesti – Päivittää manifest.json agentin blueprint ID:n avulla.
  2. Luo paketti – Pakkaa manifest.json ja kuvakkeet kohteeseen manifest.zip.
  3. Tulosta ohjeet - Näyttää vaiheittaiset ohjeet lähettämistä varten Microsoft 365 -hallintakeskuksen kautta.

Muistiinpano

a365 publish-komento toimii sekä agenteille että tekoälykumppaneille. Jos agentti on provisioitu käyttämällä --agent-name (config-free), varmista, että a365.generated.config.json on olemassa työhakemistossasi ennen kuin suoritat komennon a365 publish, sillä komento lukee Blueprint-ID:n tästä tiedostosta.

Lataa hallintakeskukseen

Kun a365 publish on suoritettu, seuraa tulostettuja ohjeita agentin lataamiseksi.

  1. Siirry Microsoft 365:n hallintakeskukseen.
  2. Siirry kohtaan Agentit>Kaikki agentit.
  3. Valitse Lataa mukautettu agentti.
  4. Lataa manifest.zip-tiedosto projektin kansiosta manifest.

Lisätietoja on kohdassa Agenttien lataaminen Microsoft 365 -hallintakeskukseen.

Varmista onnistunut julkaisu

Käytä seuraavaa tarkistuslistaa varmistaaksesi, että agenttisi on julkaistu onnistuneesti:

✅ CLI:n julkaisu onnistuu
✅ manifest-kansio luotu, jossa on manifest.json ja manifest.zip
✅ Agentti näkyy Microsoft 365:n hallintakeskuksessa

CLI-tulos

Näet nämä tulostusviestit, kun julkaisu-komento onnistuu:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Vaiheittaiset lähetysohjeet tulostettu

Jos komento epäonnistuu, tarkista virheilmoitukset ja varmista, että blueprintin määrittely on suoritettu.

Mahdolliset virheet:

Virhe Askel ratkaisuun
Agent blueprint ID not found Suorita a365 setup viimeistelläksesi blueprintin määrityksen.
Permissions missing Suorita määritys uudelleen a365 setup permissions-komennolla.

Noudata näitä ohjeita, kun julkaisu epäonnistuu.

Luettelotiedostot

Voit testata seuraavia tiedostoja kansiossa manifest käyttämällä Test-Path PowerShell-komentoa.

# 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

Muistiinpano

Jos et näe näitä tiedostoja, kokeile suorittaa a365 publish -komento uudelleen.

Agentti ilmestyy hallintokeskukseen

Muistiinpano

Lataamisen jälkeen voi kestää 5–10 minuuttia, ennen kuin agentti ilmestyy hallintakeskukseen ja Teamsiin. Tämä viive on normaali.

Varmista, että agentti on läsnä näillä vaiheilla:

  1. Siirry Microsoft 365 -hallintakeskukseen.
  2. Siirry kohtaan Agentit>Kaikki agentit.
  3. Agenttisi näkyy luettelossa.

Seuraavasta taulukosta näet, mitä tietoja on saatavilla:

Kenttä Tarkistettava asia
Nimi Agenttisi nimi (lähteestä manifest.json)
Versio Versionumero (esimerkiksi 1.0.0)
Julkaisija Organisaatiosi nimi
Saatavuus Käytettävissä/Kaikki käyttäjät

Katso myös

Seuraavat vaiheet

Kun olet julkaissut agenttisi, luo esiintymä, jotta voit konfiguroida ja käyttää sitä vuokraajassasi.

Luo agentin esiintymä

Vianmääritys

Yleisiä ongelmia agenttien julkaisemisessa Microsoft 365 -hallintokeskukseen.

Vinkki

Agent 365:n vianmääritysopas sisältää yleisluontoisia vianmääritykseen liittyviä suosituksia, parhaita käytäntöjä sekä linkkejä vianmääritykseen liittyvään sisältöön Agent 365:n kehityksen elinkaaren kaikissa vaiheissa.

Julkaise-komento epäonnistuu

Oireet:

  • Virhe a365 publish aikana
  • manifest.zip ei ole luotu

Juurisyyt:

  • Asennus ei ole valmis
  • Kokoonpanotietojen validointivirheet
  • Riittämättömät käyttöoikeudet

Ratkaisu:

  1. Varmista, että asennus on valmis.

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

  2. Suorita julkaise-komento ja seuraa kehotteita.

Lataus epäonnistuu hallintokeskuksessa

Oireet:

  • Virhe ladattaessa manifest.zip Microsoft 365 -hallintakeskukseen
  • Agentti ei näy latauksen jälkeen

Juurisyyt:

  • Riittämättömät käyttöoikeudet hallintokeskuksessa
  • Virheellinen tai vanhentunut manifest.zip

Ratkaisu:

  1. Varmista, että sinulla on yleisen järjestelmänvalvojan rooli.
  2. Suorita a365 publish uudelleen, jotta voit luoda uuden manifest.zip.
  3. Yritä ladata uudelleen noudattamalla latausvaiheita.

Lisäohjeita löytyy kohdasta Agenttien tuonti Microsoft 365 -hallintakeskukseen.

  • Last updated on