Pluginy pro Microsoft Copilot s Work IQ Developer Tools: import, tvorba a distribuce

Existující plugin pro agenty můžete importovat do Work IQ Developer Tools (WIQD) a připravit pro registr pluginů, případně vytvořit nový a využít celý postup sestavení balíčku pro Microsoft Copilot.

Plugin rozšiřuje možnosti Microsoft Copilot při práci. Sdružuje jednu nebo více schopností, například dovednosti (skills), MCP servery nebo agenty, aby Copilot mohl podporovat pracovní postupy důležité pro Vaši organizaci.

Pokud začínáte od nuly, Work IQ Developer Tools (WIQD) Vám pomohou převést obchodní problém nebo neefektivní pracovní postup do pluginu, který rozšíří možnosti Copilot.

Většina vývojářů ale nezačíná s prázdnou složkou. Možná už máte dovednosti popisující pracovní postupy, MCP server propojený s Vašimi systémy nebo agenta vytvořeného pro jiného klienta. WIQD umožňují využít tuto existující práci jako základ pluginu pro Microsoft Copilot.

První rozhodnutí je jednoduché: importovat, nebo vytvořit.

Jakmile si vyberete výchozí bod, popište v preferovaném prostředí pro práci s programovacím agentem, co má plugin dělat. Microsoft doporučuje GitHub Copilot. Ať už importujete existující řešení, nebo vytváříte nové, používáte stejnou sadu příkazů WIQD.

Preview: Sada příkazů wiqd plugin je aktuálně ve fázi public preview a může se měnit.

Začněte s tím, co už máte

Pokud Váš existující plugin používá formát Agent Plugins, můžete jej importovat do WIQD. Tento formát sdružuje dovednosti a konfigurace MCP serverů. WIQD převezmou podporované části do projektu, který můžete zkontrolovat a dále rozvíjet, místo abyste je museli ručně vytvářet znovu.

Nainstalujte WIQD a poté importujte plugin:

wiqd plugin import --path ./my-agent-plugin \
  --privacy-url https://contoso.com/privacy \
  --terms-url https://contoso.com/terms

Po importu zkontrolujte, co WIQD do projektu převzaly. Než přejdete k validaci a sestavení balíčku, můžete upravit, jak budou jednotlivé schopnosti v Microsoft Copilot fungovat.

Nemáte plugin? Popište jej

Začněte tím, jakou práci má Copilot vykonávat. Plugin WIQD pro GitHub Copilot CLI umožňuje popsat požadovaný výsledek přirozeným jazykem. Následně pomocí příkazů WIQD vytvoří plugin a průběžně informuje o jednotlivých krocích.

Můžete například zadat:

Create a standalone plugin called Triage Helper. Add a skill that triages incoming customer issues and connect it to our incident-management MCP server.

Na základě tohoto požadavku mohou WIQD použít například následující příkazy:

wiqd plugin create --name "Triage Helper"
wiqd plugin add skill --name "Triage Issues"
wiqd plugin add connector --name "Incident Management" \
  --description "Triage and manage customer incidents" \
  --url https://incidents.contoso.com/mcp

Od nápadu se tak dostanete k projektu pluginu, aniž byste se museli nejprve učit strukturu příkazů. WIQD průběžně uvádějí, které příkazy spustily. Stejné příkazy máte k dispozici i tehdy, když chcete práci řídit přímo z terminálu.

Vytvoření pluginu přímo v terminálu

Příkazy WIQD, které používá plugin pro GitHub Copilot CLI, jsou dostupné také přímo v terminálu pro lokální vývoj a opakovatelnou automatizaci. Než vyzkoušíte následující příklad pro Bash, nainstalujte WIQD.

Vytvořte triage-helper, připravte základ dovednosti pro třídění příchozích problémů a zaregistrujte MCP server pro správu incidentů:

# Vytvořte plugin
wiqd plugin create --name triage-helper
cd triage-helper
# Přidejte potřebné schopnosti
wiqd plugin add skill --name "Triage Issues"
wiqd plugin add connector \
  --name "Incident Management" \
  --description "Triage and manage customer incidents" \
  --url https://incidents.contoso.com/mcp

Příkazy vytvoří strukturu projektu. Stále ale musíte napsat instrukce dovednosti pro třídění problémů a nastavit případné ověřování, které MCP server vyžaduje. Jakmile je plugin připravený, další kroky jsou stejné bez ohledu na to, zda jste jej vytvořili přes CLI, popsali přirozeným jazykem, nebo importovali existující řešení.

Validace a sestavení balíčku pluginu

Ať už jste plugin importovali, vytvořili pomocí přirozeného jazyka, nebo sestavili příkazy WIQD, pokračujte z adresáře projektu pluginu. Než začnete zřizovat prostředky v Microsoft 365, zkontrolujte projekt lokálně:

# Zkontrolujte artefakty deklarativního agenta, pokud jsou přítomné
wiqd plugin validate

Jde o offline kontrolu, nikoli o úplné prověření pluginu. Nekontroluje obsah dovedností ani hlavní manifest aplikace. Výsledek bez chyb proto u pluginu s dovednostmi a konektory neznamená, že je vše v pořádku.

Dále se přihlaste a zřiďte prostředky Microsoft 365. Tento krok mění Vaše prostředí a poskytuje informace, které WIQD potřebují k sestavení balíčku:

wiqd auth login --interactive
wiqd plugin provision
wiqd plugin package
wiqd plugin validate --mode deep

Hloubková validace kontroluje sestavený balíček aplikace pro Microsoft 365. Balíček sdružuje dovednost, konfiguraci MCP konektoru a případně také deklarativního agenta, pokud jej Váš scénář vyžaduje. Váš tým tak může celou jednotku verzovat, distribuovat a podporovat.

Úspěšná validace balíčku nezaručuje stejné chování ve všech prostředích Copilot. Před sdílením nebo publikováním ověřte, zda každé cílové prostředí podporuje schopnosti, které Váš plugin potřebuje.

Zpřístupnění pluginu uživatelům

Pro použití uvnitř Vaší organizace mohou WIQD sdílet plugin s konkrétními uživateli nebo v celém tenantovi:

wiqd plugin share --scope users --email developer@contoso.com
# Nebo jej zpřístupněte v celém tenantovi
wiqd plugin share --scope tenant

Pro nezávislého dodavatele softwaru (ISV), který oslovuje zákazníky mimo vlastní organizaci, představuje balíček hotový plugin určený k odeslání a následné podpoře. Zákazníci tak nemusí sami sestavovat řešení z jednotlivých dovedností, manifestů a nastavení konektorů. Balíček odešlete prostřednictvím Partner Center k certifikaci Microsoftem a před vydáním vypořádejte případné připomínky. WIQD připravují balíček, ale veřejné publikování a certifikaci zajišťuje Partner Center.

Jeden balíček, ověření pro každé prostředí

Formát Agent Plugins poskytuje dovednostem a konfiguracím MCP serverů přenositelnou podobu. WIQD umožňují převzít podporované části existujícího řešení do projektu pluginu pro Microsoft 365 nebo pomáhají vytvořit nový projekt a následně jej zabalit pro distribuci. Registr pluginů Microsoft Copilot poskytuje spravovaný záznam pluginu, který mohou vyhledat zapojená prostředí Microsoftu.

Jeden balíček ale neznamená jednotné běhové prostředí. Každé prostředí Copilot určuje, které schopnosti podporuje, jak uživatelé plugin získají a jak se jeho schopnosti spouštějí. Plugin s dovedností, MCP konektorem a agentem proto nemusí všude poskytovat stejné možnosti.

Můžete navázat na existující práci nebo vytvořit plugin podle potřeb svého scénáře. V obou případech získáte jeden balíček použitelný napříč zapojenými prostředími. Kompatibilitu je ale nutné ověřit tam, kde budou Vaši uživatelé plugin skutečně používat.

Jak začít

• Začněte s WIQD.
• Projděte si specifikaci Agent Plugins.
• Postupujte podle návodu k tvorbě pluginu pomocí WIQD.
• Prostudujte si referenční dokumentaci příkazů wiqd plugin.
• Po sestavení a validaci balíčku pomocí WIQD postupujte podle přehledu publikování pro Microsoft 365 Copilot a pokynů k odeslání nabídky na marketplace prostřednictvím Partner Center.