Publikujte agenta do centra správy Microsoft

Použijte příkaz a365 publish k zabalení agenta a pak ho nahrajte do Centra pro správu Microsoft 365. Po publikování můžete ve své organizaci vytvářet instance agentů a spravovat agenta.

Předpoklady

Než začnete, zkontrolujte, zda máte následující položky:

Požadované účty a oprávnění

  • Tenant Microsoft 365 s jednou z následujících rolí (požadováno pro krok nahrání v Centru pro správu):

    • Globální správce

Požadované nástroje

Požadované kroky pro nastavení

Před publikací proveďte tyto kroky:

  1. Vytvořte návrh agenta – postupujte podle kroku nastavení pro vytvoření návrhu agenta.
  2. Testujte agenta lokálně – Ověřte, že váš agent funguje správně pomocí Agents Playground (viz Místní testovací agenti).
  3. Připravte konfigurační soubory – Ujistěte a365.config.json se, že a365.generated.config.json jsou aktuální.

Příkaz Publikovat

Spusťte příkaz a365 publish:

a365 publish

Poznámka

Spuštěním a365 publish -h se zobrazí všechny možnosti, které tento příkaz podporuje.

Co tento příkaz dělá:

  1. Aktualizace manifestu – Aktualizuje manifest.json pomocí ID podrobného plánu vašeho agenta.
  2. Vytvořit balíček – Balíčky manifest.json a ikony do manifest.zip.
  3. Zobrazit instrukce – Zobrazí podrobný návod krok za krokem pro nahrání prostřednictvím Microsoft 365 admin centra.

Poznámka

Příkaz a365 publish funguje jak pro agenty, tak pro AI kolegy. U agentů nasazených pomocí --agent-name (config-free) se ujistěte, že a365.generated.config.json existuje ve vašem pracovním adresáři před spuštěním a365 publish, protože příkaz čte podrobný plán ID z tohoto souboru.

Nahrát do centra pro správu

Po dokončení a365 publish postupujte podle tištěných instrukcí k nahrání agenta:

  1. Přejděte na centrum pro správu Microsoft 365.
  2. Přejděte na Agenti>Všichni agenti.
  3. Vyberte Nahrát vlastního agenta.
  4. Nahrajte manifest.zip soubor ze složky manifest ve svém projektu.

Pro další informace viz Nahrávání agentů do Centra pro správu Microsoft 365.

Ověřte úspěšné publikování

Použijte následující kontrolní seznam k ověření, že váš agent byl úspěšně publikován:

✅ Publikování CLI bylo úspěšné
✅ manifest složka vytvořená s manifest.json a manifest.zip
✅ Agent je zobrazen v Centru pro správu Microsoft

Výstup CLI

Zobrazí se následující výstupní zprávy, když je příkaz publikovat úspěšně proveden:

✅ Manifest updated successfully
✅ manifest.zip created successfully
✅ Pokyny pro nahrání krok za krokem byly vytištěny

Pokud příkaz selže, zkontrolujte chybové zprávy a ujistěte se, že jste dokončili nastavení podrobného plánu.

Možné chyby:

Chyba Postup řešení
Agent blueprint ID not found Spusťte a365 setup pro dokončení nastavení podrobného plánu.
Permissions missing Znovu spusťte nastavení pomocí příkazu a365 setup permissions.

Postupujte podle těchto kroků, když publikování selže.

Soubory manifestu

Otestujte následující soubory ve složce manifest pomocí příkazu Test-Path PowerShell.

# 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

Poznámka

Pokud tyto soubory nevidíte, zkuste příkaz a365 publish spustit znovu.

Agent se objevuje v centru pro správu

Poznámka

Po nahrání může trvat 5–10 minut, než se agent zobrazí v Centru pro správu a Teams. Toto zpoždění je normální.

Potvrďte přítomnost agenta pomocí těchto kroků:

  1. Přejděte na Centrum pro správu Microsoft 365.
  2. Přejděte na Agenti>Všichni agenti.
  3. Váš agent se objevuje v seznamu.

Následující tabulka ukazuje, jaké podrobnosti můžete najít:

Pole Co zkontrolovat
Název Název agenta (z manifest.json)
Verze Číslo verze (například 1.0.0)
Vydavatel Název vaší organizace
Dostupnost Dostupné/Všichni uživatelé

Viz také

Další kroky

Po publikování agenta vytvořte jeho instanci, abyste ji mohli konfigurovat a používat ve vašem tenantu.

Vytvoření instance agenta

Řešení problému

Nejčastější problémy při publikování agentů do Centra pro správu Microsoft 365.

Zpropitné

Průvodce odstraňováním problémů Agent 365 obsahuje doporučení k odstraňování problémů na vysoké úrovni, osvědčené postupy a odkazy na obsah o řešení problémů pro každou část životního cyklu vývoje Agent 365.

Příkaz Publikovat selže

Příznaky:

  • Chyba při a365 publish
  • manifest.zip není vytvořen

Hlavní příčiny:

  • Nastavení není dokončeno
  • Chyby ověření manifestu
  • Nedostatečná oprávnění

Řešení:

  1. Ověřte, zda je nastavení dokončeno.

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

  2. Spusťte příkaz publish a postupujte podle pokynů.

Nahrávání v Centru pro správu selže

Příznaky:

  • Chyba při nahrávání manifest.zip v Centru pro správu Microsoft 365
  • Agent se po nahrání nezobrazí

Hlavní příčiny:

  • Nedostatečná oprávnění v Centru pro správu
  • Neplatné nebo zastaralé manifest.zip.

Řešení:

  1. Ujistěte se, že máte roli Globální správce.
  2. Spusťte a365 publish znovu, abyste vygenerovali nový manifest.zip.
  3. Zkuste znovu nahrát podle kroků nahrávání.

Pro další pomoc viz Nahrávání agentů do Centra pro správu Microsoft 365.

  • Last updated on