Příprava souborů konektoru Agent a Power Platform na certifikaci

Po dokončení vývoje vlastního konektoru je potřeba připravit soubory na certifikaci. Jako ověřený vydavatel postupujte podle těchto kroků pro přípravu souborů k certifikaci a generování souborů konektoru a konektoru připraveného pro agenta, které odešlete společnosti Microsoft.

Poznámka:

Všechny konektory jsou připravené pro agenty. Tento článek obsahuje informace o certifikaci vlastních konektorů pro Azure Logic Apps, Microsoft Power Automate, Microsoft Power Apps a Microsoft Copilot Studio. Než budete postupovat podle kroků v tomto článku, přečtěte si článek Získání certifikace konektoru.

Krok 1: Splňte požadavky na odeslání pro konektory

Pro udržení vysokého standardu kvality a konzistence mezi našimi certifikovanými konektory tato sekce představuje sadu požadavků a pokynů, které musí váš vlastní konektor dodržovat pro certifikaci společnosti Microsoft.

Pojmenujte svůj konektor

Název musí splňovat následující požadavky:

Musí existovat a musí být v angličtině.
Musí být jedinečný a odlišitelný od jakéhokoli existujícího názvu konektoru.
Měl by být název vašeho produktu nebo organizace.
Měly by dodržovat stávající vzory pojmenování pro certifikovaný konektor. Pro nezávislé vydavatele by název konektoru by měl vypadat dle vzoru Connector Name (Independent Publisher).
Název nesmí být delší než 30 znaků.
Nemůžou obsahovat slova API, Connector, Copilot Studio ani žádný z našich jiných názvů produktů Power Platform (například Power Apps).
Nemůže končit nealfanumerickým znakem, včetně návratu na začátek řádku, nového řádku nebo mezery.

Příklady

Dobré názvy konektorů: Azure Sentinel*, *Office 365 Outlook
Špatné názvy konektorů: Azure Sentinel's Power Apps Connector, Office 365 Outlook API

Napište popis svého konektoru

Popis musí splňovat následující požadavky:

Ujistěte se, že váš popis je v souladu s pokyny pro Marketplace.
Musí existovat a musí být v angličtině.
Musí být bez gramatických a pravopisných chyb.
Měl by stručně popsat hlavní účel a hodnotu nabízenou vaším konektorem.
Nesmí být kratší než 30 znaků nebo delší než 500 znaků.
Nemůže obsahovat žádné Copilot Studio ani jiné názvy produktů Power Platform (například Power Apps).

Navrhněte ikonu pro svůj konektor (platí pouze pro ověřené majitele stránek)

Tato část se nevztahuje na nezávislé vydavatele.

Vytvořte logo o rozměrech 1:1 v rozsahu 100 x 100 až 230 × 230 pixelů (bez zaoblených hran).
Použijte neprůhledné, nebílé pozadí (#ffffff) a jinou než výchozí barvu (#007ee5), které odpovídá zadané barvě pozadí ikony.
Ikona musí být jiná než jakákoli jiná ikona certifikovaného konektoru.
Odešlete logo ve formátu PNG jako <icon>.png.
Nastavte rozměry loga pod 70 % pro výšku obrázku a šířku s konzistentním pozadím.
Ujistěte se, že barva značky je platná hexadecimální barva a neměla by být bílá (#ffffff) ani výchozí (#007ee5).

Definování souhrnů a popisů operací a parametrů

Shrnutí a popisy musí splňovat následující požadavky:

Musí existovat a musí být v angličtině.
Musí být bez gramatických a pravopisných chyb.
Souhrny operací a parametrů by měly být fráze, 80 znaků nebo kratší, a měly by obsahovat pouze alfanumerické znaky nebo závorky.
Popisy operací a parametrů by měly být úplné, popisné věty, které končí interpunkcí.
Nesmí obsahovat žádné Copilot Studio ani jiné názvy produktů Power Platform (například Power Apps).

Definování přesných provozních reakcí

Odpovědi operací musí splňovat následující požadavky:

Odpovědi operace definujte pomocí přesného schématu pouze u očekávaných odpovědí.
Nepoužívejte výchozí odpovědi s přesnou definicí schématu.
Zadejte platné definice odpovědního schématu pro všechny operace ve Swagger.
Prázdná schémata odpovědí nejsou povolena s výjimkou zvláštních případů, kdy je schéma odpovědi dynamické. To znamená, že ve výstupu se nezobrazí žádný dynamický obsah a tvůrci musí k analýze odpovědi použít JSON.
Prázdné operace nejsou povoleny.
Odstraňte prázdné vlastnosti, pokud nejsou vyžadovány.

Ověřte vlastnosti Swaggeru

Vlastnosti musí splňovat následující požadavky:

Ujistěte se, že openapidefinition.json je správně naformátovaný soubor JSON.
Ujistěte se, že definice swaggeru vyhovuje standardu OpenAPI Specification v2.0 a rozšířenému standardu konektorů.

Ověřte parametry připojení

Parametry musí splňovat následující požadavky:

Ujistěte se, že je vlastnost aktualizovaná s odpovídajícími hodnotami pro uiDefinition (zobrazovaný název, popis).

Pokud váš parametr připojení používá Základní ověřování, ujistěte se, že je JSON správně naformátován podle následujícího příkladu.

{
  "username": {
    "type": "securestring",
    "uiDefinition": {
      "displayName": "YourUsernameLabel",
      "description": "The description of YourUsernameLabel for this api",
      "tooltip": "Provide the YourUsernameLabel tooltip text",
      "constraints": {
        "tabIndex": 2,
        "clearText": true,
        "required": "true"
        }
  }
},
  "password": {
    "type": "securestring",
    "uiDefinition": {
      "displayName": "YourPasswordLabel",
      "description": "The description of YourPasswordLabel for this api",
      "tooltip": "Provide the YourPasswordLabel tooltip text",
      "constraints": {
        "tabIndex": 3,
        "clearText": false,
        "required": "true"
      }
    }
  }
}

Pokud váš parametr připojení má APIKey jako ověřování, ujistěte se, že je JSON správně naformátován podle následujícího příkladu.

{
  "api_key": {
    "type": "securestring",
    "uiDefinition": {
      "displayName": "YourApiKeyParameterLabel",
      "tooltip": "Provide your YourApiKeyParameterLabel tooltip text",
      "constraints": {
        "tabIndex": 2,
        "clearText": false,
        "required": "true"
      }
    }
  }
}

Pokud má parametr připojení generické ověřování OAuth, ujistěte se, že je JSON správně naformátovaný jako v následujícím příkladu.

{
  "token": {
    "type": "oAuthSetting",
    "oAuthSettings": {
      "identityProvider": "oauth2",
      "scopes": [
        "scope1"
      ],
      "redirectMode": "GlobalPerConnector",
      "customParameters": {
        "AuthorizationUrl": {
          "value": "https://contoso.com"
        },
        "TokenUrl": {
          "value": "https://contoso.com"
        },
        "RefreshUrl": {
          "value": "https://contoso.com"
        }
      },
      "clientId": "YourClientID"
    },
    "uiDefinition": null
  }
}

Pokud má váš parametr připojení poskytovatele identity OAuth2, ujistěte se, že poskytovatel identity je ze seznamu podporovaných poskytovatelů OAuth2. Tady je příklad identity poskytovatele GitHub OAuth2:

{
  "token": {
    "type": "oAuthSetting",
    "oAuthSettings": {
      "identityProvider": "github",
      "scopes": [
        "scope1"
      ],
      "redirectMode": "GlobalPerConnector",
      "customParameters": {},
      "clientId": "YourClientId"
    },
    "uiDefinition": null
  }
}

Důležité

Pokud váš konektor používá OAuth, je důležité pravidelně monitorovat a obnovovat ID klienta a tajné přihlašovací údaje klienta, aby zákazníci mohli váš konektor dál používat. Nezapomeňte odeslat aktualizaci konektoru jeden měsíc před datem, kdy id klienta a tajný klíč klienta vyprší.

Pokud má parametr připojení Microsoft Entra ID jako ověřování, ujistěte se, že je JSON správně naformátovaný jako v následujícím příkladu.

{
  "token": {
    "type": "oAuthSetting",
    "oAuthSettings": {
      "identityProvider": "aad",
      "scopes": [
        "scope1"
      ],
      "redirectMode": "GlobalPerConnector",
      "customParameters": {
        "LoginUri": {
          "value": "https://login.microsoftonline.com"
        },
        "TenantId": {
          "value": "common"
        },
        "ResourceUri": {
          "value": "resourceUri"
        },
        "EnableOnbehalfOfLogin": {
          "value": false
        }
      },
      "clientId": "AzureActiveDirectoryClientId"
    },
    "uiDefinition": null
  }
}

Vytváření kvalitních anglických jazykových řetězců

Konektory jsou lokalizovány jako součást lokalizace Power Automate; proto při vývoji konektoru je kvalita řetězců anglického jazyka klíčem ke kvalitě překladu. Zde je několik hlavních oblastí, na které je třeba se zaměřit při vytváření hodnot řetězců, které poskytnete.

Spusťte program kontroly pravopisu, abyste zajistili, že všechny hodnoty řetězce neobsahují typografické chyby. Pokud existuje nějaký neúplný anglický jazykový řetězec, výsledek překladu je neúplný nebo nesprávný v kontextu.
Ujistěte se, že věta je v úplné podobě – to znamená, že má alespoň předmět a predikát. Pokud věta není úplná, může to také vést k nižší kvalitě překladů.
Ujistěte se, že význam věty je jasný. Pokud je význam věty nejednoznačný, může to také způsobit nižší kvalitu nebo nesprávné překlady.
Ujistěte se, že souhrny, x-ms-souhrny a popisy jsou gramaticky správné. Souhrny nekopírujte a nevkládejte. Chcete-li zjistit, jak se zobrazují v produktu, přejděte na Vedení řetězce konektoru.
Pokud je to možné, vyhněte se složeným řetězcům vytvářeným za běhu programu. Místo toho použijte plně vytvořené věty. Zřetězené řetězce nebo věty znesnadňují překlad nebo mohou způsobit nesprávný překlad.
Zkratky zapisujte velkými písmeny, aby byly jasně srozumitelné. Velká písmena sníží možnost záměny za typografickou chybu.
Pokud chcete lokalizovat hodnotu řetězce, opravte řetězce formuláře CAlMel. Řetězce ve formě CaMel (například minimizeHighways nebo MinimizeHighways) jsou obvykle považovány za nepřeložitelné.

Krok 2: Spusťte Kontrolu řešení k ověření vašeho konektoru.

Kontrola řešení je mechanismus, který provádí statickou analýzu, aby se zajistilo, že váš konektor dodržuje certifikační standardy Microsoft. Přidejte konektor do řešení v Power Automate nebo Power Apps a pak postupujte podle pokynů v Pokudujte vlastní konektor pomocí kontroly řešení a spusťte kontrolu řešení.

V tomto videu se dozvíte, jak spustit kontrolu řešení.

Krok 3: Splnění požadavků k odeslání pro akce konektoru

Ujistěte se, že akce konektoru dodržují tyto pokyny:

Zodpovědné pokyny pro AI popisují, jaké konektory připravené pro agenty je potřeba dodržovat.
100.10 Nevhodný obsah zvýrazní oddíl v podmínkách použití komerčního marketplace Microsoftu, který popisuje standardy, podle kterých musí být všechny konektory připravené pro agenty. Akce konektoru nesmí generovat, obsahovat ani poskytovat přístup k nevhodnému, škodlivému nebo urážlivému obsahu generovanému umělou inteligencí.
Použijte konektory v Copilot Studiu, abyste se dozvěděli, jak konektory jsou nástroji, které rozšiřují funkčnost Microsoft Copilot Studio.

Poznámka:

Před certifikací zajistěte kvalitu vašeho konektoru připraveného pro agenty podle všech specifikací. V opačném případě se certifikace zpozdí, protože vás budeme muset požádat o provedení změn.
Poskytněte produkční verzi adresy URL hostitele. Zkušební, vývojářské a testovací adresy URL hostitele nejsou povoleny.

Do Microsoftu odešlete sadu souborů, což je generování řešení z portálu pro tvůrce nebo Microsoft Copilot Studio. Chcete-li soubory zabalit, postupujte podle pokynů v této části.

Zabalte soubory konektoru

Vytváření vlastního konektoru v řešení.
Spusťte kontrolu řešení na vašem řešení konektoru v prvním kroku.
Exportujte řešení konektoru.
Vytvořte testovací tok pomocí nově vytvořeného vlastního konektoru nebo přidejte existující tok do řešení.
Exportujte řešení toku.
Vytvořte balíček s řešeními z kroků 3 a 5.
Vytvořte soubor intro.md.
Vytvořte konečný balíček jako soubor zip v následujícím formátu:

Poznámka:

Názvy složek a souborů mimo řešení jsou pouze orientační a můžete si je zvolit podle svých požadavků. Se soubory uvnitř řešení však nemanipulujte.

Nahrajte balíček do objektu blob úložiště a vygenerujte adresu URL SAS. Ujistěte se, že identifikátor URI SAS je platný alespoň 15 dnů.
Odešlete balíček do Partnerského centra.

Jak ověření vydavatelé, tak nezávislí vydavatelé stahují openapidefinition.json ve svých artefaktech. V tomto souboru musíte nastavit IconBrandColor .

Ověření vydavatelé: Nastavte iconBrandColor na barvu vaší značky v souboru openapidefinition .
Nezávislí vydavatelé: Nastavte iconBrandColor na #da3b01 v souboru openapidefinition.

Vytvořte artefakt intro.md.

Soubor intro.md je nezbytný jak pro nezávislé vydavatele, tak pro ověřené vydavatele. Musíte vytvořit soubor intro.md, abyste zdokumentovali funkce a funkčnost vašeho konektoru. Příklad dokumentace, kterou je třeba zahrnout, naleznete v části Příklad souboru Readme.md. Další informace o zápisu souboru intro.md najdete tím, že se podíváte na jiné soubory intro.md (označované také jako soubory Readme.md) v našem úložišti GitHub.

Pokud jste nezávislý vydavatel a váš konektor používá protokol OAuth, nezapomeňte uvést pokyny, jak získat přihlašovací údaje.

Tip

Známé problémy a omezení je skvělá sekce, kterou je třeba udržovat, aby vaši uživatelé měli aktuální informace.

Krok 5: Ověření struktury balíčku

Ověřovací skript balíčku ověří strukturu balíčku a pomůže vygenerovat balíček v přijatelném formátu pro certifikaci. Stáhněte skript validátoru balíčku ConnectorPackageValidator.ps1.

Důležité

Pokud používáte macOS, musíte nainstalovat PowerShell v systému macOS.

Pokud nejste uživatelem Microsoft 365 nebo Windows, proveďte kroky popsané v Co je Microsoft Entra ID pro vytvoření ID Entra, aby se vygenerovala adresa URL SAS pro váš balíček a tím se ověřte v Partnerském centru, abyste získali oznámení o certifikaci.

Pokud chcete spustit ověřovací skript balíčku, postupujte takto:

Otevřete Windows PowerShellu v režimu správce.
Změňte umístění jednotky zadáním cd /.

Následující příklad používá C:\.
Přejděte na cestu, kam jste stáhli skript validátoru balíčku.

Například, pokud je cesta C:\Users\user01\Downloads, zadáte cd .\Users\user01\Downloads\.
Nastavte zásadu spouštění na unrestricted zadáním následujícího příkazu:

Set-ExecutionPolicy -ExecutionPolicy Unrestricted

Tento příkaz umožňuje spuštění PowerShell bez jakéhokoli omezení.
Potvrďte zadání zadáním Y, což znamená Ano.
Spusťte ConnectorPackageValidator.ps1zadáním cesty k souboru ZIP, který obsahuje balíček konektoru.

Jak je znázorněno v následujícím příkladu, prvním argumentem je platná cesta k souboru ZIP, který obsahuje balíček.

Pokud je struktura balíčku správná, zobrazí se následující zpráva o úspěchu:

Pokud dojde k problému se strukturou balíčku, skript poskytne podrobnosti o problému tím, že zjistí a zvýrazní chyby ve struktuře balíčku.

Krok 6: Odeslání konektoru k certifikaci

Během procesu odeslání otevřete svůj konektor do našeho úložiště Microsoft Power Platform Connectors.

(Pro nezávislé vydavatele) Chcete-li odeslat balíček společnosti Microsoft k certifikaci, postupujte podle pokynů v Proces certifikace nezávislého vydavatele.
(Pro ověřené vydavatele) Chcete-li odeslat balíček společnosti Microsoft k certifikaci do Partnerského centra, postupujte podle pokynů v Proces certifikace ověřeného vydavatele.

Pokud jste ověřený vydavatel a používáte vlastní kód, budete muset odeslat soubor script.csx.

Pokud váš konektor má OAuth, zadejte ID klienta a tajný klíč v Partnerském centru. Chcete-li aktualizovat aplikaci, získejte také název API z žádosti o odeslání konektoru.

Jako součást odeslání společnost Microsoft certifikuje váš konektor nebo plugin. Pokud potřebujete vyřešit chyby se swaggerem, přejděte do části Oprava chyb nástroje Swagger Validator.

Kontrolní seznam před odesláním

Před přechodem na krok Odešlete svůj konektor k certifikaci Microsoft, se ujistěte, že:

Váš vlastní konektor splňuje všechny standardy nastavené v kroku 1: Splnění požadavků na odeslání pro konektory a krok 3: Splnění požadavků na odeslání pro akce konektoru.
V žádné z operací nechybí souhrn, popis ani informace o viditelnosti.
Otestovali jste vlastní konektor, abyste zajistili, že operace fungují podle očekávání (alespoň 10 úspěšných volání na operaci).
V sekci testování v průvodci vlastním konektorem nedojde k žádným chybám běhu nebo ověření schématu.

V případě dotazů týkajících se certifikace

Abyste se mohli připojit ke schůzce pracovní doby, musíte mít Microsoft Teams. Pokud potřebujete přístup, prohlédněte si možnosti v Microsoft Teams.

Připojte se ke schůzce Office Hours každé úterý od 15:30 do 16:30 UTC (koordinovaný světový čas).

Tip

Vytvořte videa YouTube, blogy nebo jiný obsah pro sdílení ukázek nebo snímků obrazovky, jak začít s konektorem a konektorem připraveným pro agenta.
Zahrňte odkazy do souboru intro.md, abychom ho mohli přidat do našich dokumentů.
Přidejte popisky do vašeho souboru swagger, aby vaši uživatelé byli úspěšnější.

Další krok

Last updated on 2026-03-11