Een agent publiceren naar het Microsoft-beheercentrum

Gebruik de a365 publish-opdracht om uw agent te verpakken en upload vervolgens het pakket naar het Microsoft 365-beheercentrum. Na publicatie kunt u binnen uw organisatie agentexemplaren maken en de agent beheren.

Vereisten

Controleer voordat u begint of u de volgende items hebt.

Vereiste accounts en machtigingen

  • Microsoft 365-tenant met een van de volgende rollen (vereist voor de uploadstap van het Beheercentrum):

    • Globale beheerder

Vereiste hulpprogramma's

Vereiste installatiestappen

Voltooi voor publicatie deze stappen:

  1. Agentblauwdruk maken: volg de configuratiestap om uw agentblauwdruk te maken.
  2. Agent lokaal testen: controleer of uw agent correct werkt met Agents Playground (zie Agents lokaal testen).
  3. Configuratiebestanden voorbereiden: controleer of a365.config.json en a365.generated.config.json up-to-date zijn.

Opdracht Publiceren

Voer de opdracht a365 publish uit:

a365 publish

Notitie

Het uitvoeren van a365 publish -h toont alle ondersteunde opties van deze opdracht.

Wat deze opdracht doet:

  1. Manifest bijwerken: werkt manifest.json bij met uw agentblauwdruk-id.
  2. Package maken: pakketten manifest.json en pictogrammen maken in manifest.zip.
  3. Afdrukinstructies: geeft stap-voor-stap instructies weer voor het uploaden naar het Microsoft 365-beheercentrum.

Notitie

De opdracht a365 publish werkt zowel voor agenten als AI-teamleden. Voor agents die zijn ingericht met --agent-name (configuratievrij), zorgt u ervoor dat a365.generated.config.json in uw werkmap staat voordat u a365 publish uitvoert, aangezien de opdracht de blauwdruk-id uit dit bestand leest.

Uploaden naar beheercentrum

Nadat a365 publish is voltooid, volgt u de weergegeven instructies om uw agent te uploaden:

  1. Ga naar het Microsoft 365-beheercentrum.
  2. Navigeer naar Agenten>Alle agenten.
  3. Selecteer Aangepaste agent uploaden.
  4. Upload het manifest.zip-bestand uit de manifest-map in uw project.

Zie voor meer informatie Agenten uploaden naar het Microsoft 365-beheercentrum.

Succesvolle publicatie verifiëren

Gebruik deze checklist om te controleren of uw agent succesvol is gepubliceerd:

✅ De publicatie met de CLI is geslaagd
✅ manifest map gemaakt met manifest.json en manifest.zip
✅ Agents wordt weergegeven in Microsoft-beheercentrum

CLI-uitvoer

U ziet deze uitvoermeldingen wanneer de publicatieopdracht slaagt:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Stapsgewijze uploadinstructies afgedrukt

Als de opdracht faalt, bekijk dan de foutmeldingen en zorg ervoor dat de blauwdrukinstelling is voltooid.

Mogelijke fouten:

Fout Stappen voor probleemoplossing
Agent blueprint ID not found Voer a365 setup uit om de blauwdrukinstelling te voltooien.
Permissions missing Voer de instelling opnieuw uit met de opdracht a365 setup permissions.

Volg deze stappen als het publiceren niet lukt.

Manifestbestanden

U kunt de volgende bestanden in de map manifest testen met de PowerShell-opdracht 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

Notitie

Als u deze bestanden niet ziet, probeer dan de opdracht a365 publish opnieuw uit te voeren.

Agent verschijnt in het Beheercentrum

Notitie

Na het uploaden kan het 5-10 minuten duren voordat uw agent verschijnt in het beheercentrum en Teams. Deze vertraging is normaal.

Controleer of de agent aanwezig is door de volgende stappen te volgen:

  1. Ga naar Microsoft 365-beheercentrum.
  2. Navigeer naar Agenten>Alle agenten.
  3. Uw agent verschijnt in de lijst.

De volgende tabel toont welke details beschikbaar zijn:

Veld Wat u moet controleren
Naam De naam van uw agent (uit manifest.json)
Versie Versienummer (bijvoorbeeld 1.0.0)
Uitgever Uw organisatienaam
Beschikbaarheid Beschikbaar/Alle gebruikers

Zie ook

Volgende stappen

Nadat u uw agent hebt gepubliceerd, maakt u een instantie zodat u deze kunt configureren en gebruiken in uw tenant.

Een agentexemplaar maken

Probleemoplossing

Veelvoorkomende problemen bij het publiceren van agents in het Microsoft 365-beheercentrum.

Fooi

De Gids voor probleemoplossing in Agent 365 bevat aanbevelingen voor probleemoplossing op hoog niveau, best practices en links naar relevante probleemoplossingsinformatie voor elk onderdeel van de Agent 365-ontwikkelingscyclus.

Publicatieopdracht mislukt

Symptomen:

  • Fout tijdens a365 publish
  • manifest.zip is niet gemaakt

Hoofdoorzaken:

  • Instelling is niet voltooid
  • Manifestvalidatiefouten
  • Onvoldoende machtigingen

Oplossing:

  1. Controleer of de instelling is voltooid.

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

  2. Voer de publicatieopdracht uit en volg de aanwijzingen.

Upload mislukt in Beheercentrum

Symptomen:

  • Fout bij uploaden manifest.zip in het Microsoft 365-beheercentrum
  • Agent verschijnt niet na upload

Hoofdoorzaken:

  • Onvoldoende rechten in het beheercentrum
  • Ongeldig of verouderd manifest.zip

Oplossing:

  1. Zorg dat u de rol Globale beheerder hebt.
  2. Voer a365 publish opnieuw uit om een nieuwe manifest.zip te genereren.
  3. Probeer opnieuw te uploaden door de uploadstappen te volgen.

Zie voor meer hulp Agenten uploaden naar het Microsoft 365-beheercentrum.

  • Last updated on