Publicera agenten i Microsoft Admin Center

Använd a365 publish-kommandot för att paketera din agent och ladda upp paketet till Administrationscenter för Microsoft 365. Efter att du har publicerat kan du skapa agentinstanser inom din organisation och administrera agenten.

Krav

Innan du börjar, se till att du har följande objekt.

Nödvändiga konton och behörigheter

  • Microsoft 365 tenant med en av följande roller (krävs för uppladdningssteget i Admin Center):

    • Global administratör för

Verktyg som krävs

Nödvändiga installationssteg

Innan du publicerar, utför dessa steg:

  1. Skapa agent-blåkopian - Följ inställningssteg för att skapa din agent-blåkopian.
  2. Testa agenten lokalt – Verifiera att din agent fungerar korrekt genom att använda Agents Playground (se Testa agenter lokalt).
  3. Förbered konfigurationsfiler – Säkerställ att a365.config.json och a365.generated.config.json är uppdaterade.

Publiceringskommando

Kör a365 publish-kommandot:

a365 publish

Kommentar

Kör a365 publish -h för att visa alla alternativ som detta kommando stöder.

Vad detta kommando gör:

  1. Uppdatera manifest - Uppdaterar manifest.json med ditt agent-Blueprint-ID.
  2. Skapa paket - Paketerar manifest.json och ikoner i manifest.zip.
  3. Visa instruktioner – Visar steg-för-steg-instruktioner för uppladdning via Administrationscenter för Microsoft 365.

Kommentar

Kommandot a365 publish fungerar både för agenter och AI-lagkamrater. För agenter som provisioneras med --agent-name (konfigurationsfritt), se till att a365.generated.config.json finns i din arbetskatalog innan du kör a365 publish, eftersom kommandot läser Blueprint-ID:t från denna fil.

Ladda upp till administrationscentret

När a365 publish har slutförts, följ de visade instruktionerna för att ladda upp din agent:

  1. Gå till Administrationscenter för Microsoft 365.
  2. Navigera till Agenter>Alla agenter.
  3. Välj Ladda upp anpassad agent.
  4. Ladda upp filen manifest.zip från mappen manifest i ditt projekt.

För mer information, se Ladda upp agenter till Administrationscenter för Microsoft 365.

Verifiera framgångsrik publicering

Använd följande checklista för att verifiera att din agent har publicerats framgångsrikt:

✅ CLI-publiceringen lyckas
✅ manifest mapp skapad med manifest.json och manifest.zip
✅ Agenten visas i Microsoft admincenter

CLI-utdata

Du ser dessa utdatameddelanden när publiceringskommandot lyckas:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅Steg-för-steg-uppladdningsinstruktioner visas

Om kommandot misslyckas, granska felmeddelandena och säkerställ att du har slutfört blueprint-konfigurationen.

Möjliga fel:

Error Steg för att åtgärda
Agent blueprint ID not found Kör a365 setup för att slutföra Blueprint-konfigurationen.
Permissions missing Kör om konfigurationen med a365 setup permissions kommandot.

Följ dessa steg när publicering misslyckas.

Manifestfiler

Du kan testa följande filer i mappen manifest genom att använda PowerShell-kommandot 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

Kommentar

Om du inte ser dessa filer, försök köra kommandot a365 publish igen.

Agenten visas i administrationscentret

Kommentar

Efter uppladdning kan det ta 5–10 minuter för din agent att dyka upp i administrationscentret och Teams. Denna fördröjning är normal.

Bekräfta att agenten finns med följande steg:

  1. Gå till Administrationscenter för Microsoft 365.
  2. Navigera till Agenter>Alla agenter.
  3. Din agent visas i listan.

Följande tabell visar vilka uppgifter du kan hitta:

Fält Vad du bör kontrollera
Namn Ditt agentnamn (från manifest.json)
Version Versionsnummer (till exempel 1.0.0)
Utgivare Ditt organisationsnamn
Tillgänglighet Tillgängligt/Alla användare

Se även

Nästa steg

När du har publicerat din agent, skapa en instans så att du kan konfigurera och använda den i din tenant.

Skapa en agentinstans

Felsökning

Vanliga problem när man publicerar agenter till Administrationscenter för Microsoft 365.

Dricks

Agent 365-felsökningsguide innehåller övergripande felsökningsrekommendationer, bästa praxis och länkar till felsökningsinnehåll för varje enskild del av Agent 365:s utvecklingslivscykel.

Publiceringskommando misslyckas

Symtom:

  • Fel under a365 publish
  • manifest.zip har inte skapats

Grundorsaker:

  • Installationen har inte slutförts
  • Manifestvalideringsfel
  • Otillräckliga behörigheter

Lösning:

  1. Kontrollera att installationen har slutförts.

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

  2. Kör publish-kommandot och följ anvisningarna.

Uppladdning misslyckas i administrationscentret

Symtom:

  • Fel vid uppladdning manifest.zip i Administrationscenter för Microsoft 365
  • Agenten visas inte efter uppladdning

Grundorsaker:

  • Otillräckliga behörigheter i administrationscentret
  • Ogiltig eller föråldrad manifest.zip

Lösning:

  1. Se till att du har rollen global administratör.
  2. Kör a365 publish igen för att generera en ny manifest.zip.
  3. Försök ladda upp igen enligt uppladdningsstegen.

För mer hjälp, se Ladda upp agenter till Administrationscenter för Microsoft 365.

  • Last updated on