Publicer agent til Microsoft Administration

Brug a365 publish-kommandoen til at pakke din agent, og upload pakken til Microsoft 365 Administration. Efter publiceringen kan du oprette agentforekomster i din organisation og administrere agenten.

Forudsætninger

Sørg for, at du har følgende elementer, før du starter:

Påkrævede konti og tilladelser

  • Microsoft 365-lejer med en af følgende roller (påkrævet til upload-trinnet i Administration):

    • - global administrator

Krævede værktøjer

Påkrævede konfigurationstrin

Gør dette inden publiceringen:

  1. Opret agentblueprint – følg opsætningstrinnet for at lave din agentblueprint.
  2. Test agent lokalt – Kontrollér, at din agent fungerer korrekt, ved at bruge Agents Playground (se Test agenter lokalt)
  3. Klargør konfigurationsfiler – kontrollér, at a365.config.json og a365.generated.config.json er opdaterede.

Kommandoen Publicer

Kør kommandoen a365 publish:

a365 publish

Bemærk!

Kør a365 publish -h for at se alle de muligheder, som denne kommando understøtter.

Det gør denne kommando:

  1. Opdater manifest – opdater manifest.json med dit agentblueprint-id.
  2. Opret pakke – pakker manifest.json og ikoner i manifest.zip.
  3. Vis instruktioner – viser trinvise instruktioner til upload via Microsoft 365 Administration.

Bemærk!

Kommandoen a365 publish fungerer for både agenter og AI-teammedlemmer. Hvis du har agenter, der er klargjort med --agent-name (konfigurationsfri), skal du sørge for, at a365.generated.config.json findes i din arbejdsmappe, før du kører a365 publish, da kommandoen læser blueprint-id'et fra denne fil.

Upload til Administration

Når a365 publish er afsluttet, skal du følge de viste instruktioner for at uploade din agent:

  1. Gå til Microsoft 365 Administration
  2. Naviger til Agenter>Alle agenter.
  3. Vælg Upload en brugertilpasset agent.
  4. Upload manifest.zip-filen fra manifest-mappen i dit projekt.

Få flere oplysninger i Upload agenter til Microsoft 365 Administration.

Bekræft, at publiceringen er gennemført

Brug følgende tjekliste til at bekræfte, at din agent er publiceret korrekt:

✅ CLI-publicering lykkes
✅ manifest-mappen er oprettet med manifest.json og manifest.zip
✅ Agenten vises i Microsoft Administration

CLI-output

Du ser følgende outputmeddelelser, når publicer-kommandoen lykkes:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Trinvise vejledninger til upload er udskrevet

Hvis kommandoen ikke virker, skal du gennemgå fejlmeddelelserne og sørge for, at du har gennemført blueprint-opsætningen.

Mulige fejl:

Error Trin til løsning
Agent blueprint ID not found Kør a365 setup for at fuldføre blueprint-opsætningen.
Permissions missing Kør opsætningen igen med a365 setup permissions-kommandoen.

Følg disse trin, når publiceringen mislykkes.

Manifestfiler

Du kan teste følgende filer i mappen manifest ved at bruge 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

Bemærk!

Hvis du ikke ser disse filer, så prøv at køre a365 publish-kommandoen igen.

Agenten vises i Administration

Bemærk!

Når du har uploadet, kan det tage 5-10 minutter, før din agent dukker op i Administration og Teams. Denne forsinkelse er normal.

Bekræft, at agenten er til stede, ved at bruge disse trin:

  1. Gå til Microsoft 365 Administration.
  2. Naviger til Agenter>Alle agenter.
  3. Din agent kan ses på listen.

Følgende tabel viser, hvilke oplysninger du kan finde:

Felt Hvad du skal tjekke
Navn Dit agentnavn (fra manifest.json)
Version Versionsnummer (for eksempel 1.0.0)
Udgiver Din organisations navn
Tilgængelighed Tilgængelig/alle brugere

Se også

Næste trin

Når din agent er publiceret, skal du oprette en forekomst, så du kan konfigurere og bruge den i din lejer.

Opret en agentforekomst

Fejlfinding

Typiske problemer ved publicering af agenter til Microsoft 365 Administration.

Tip

Agent 365 Fejlfindingsguide indeholder overordnede anbefalinger til fejlfinding, bedste praksis og links til fejlfindingsindhold for hver fase af udviklingslivscyklussen for Agent 365.

Kommandoen Publicer virker ikke

Symptomer:

  • Fejl under a365 publish
  • manifest.zip oprettes ikke

Rodårsager:

  • Installationen er ikke fuldført
  • Manifest-valideringsfejl
  • Utilstrækkelige tilladelser

Løsning:

  1. Kontrollér, at konfigurationen er fuldført.

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

  2. Kør publiceringskommandoen, og følg vejledningen.

Upload mislykkes i Administration

Symptomer:

  • Fejl ved upload af manifest.zip i Microsoft 365 Administration
  • Agenten vises ikke efter upload

Rodårsager:

  • Manglende rettigheder i Administration
  • Ugyldig eller forældet manifest.zip

Løsning:

  1. Sørg for, at du har rollen som Global administrator.
  2. Kør a365 publish igen for at generere en ny manifest.zip.
  3. Prøv at uploade igen ved at følge upload-trinene.

Få mere hjælp i Upload agenter til Microsoft 365 Administration.

  • Last updated on