Sdílet prostřednictvím

Používání klasického chatovacího robota jako dovednosti v robotu Bot Framework

  • Článek

Poznámka:

Tento článek obsahuje informace platné pouze pro Copilot Studio klasické chatboty. Tato funkce není v novém Copilot Studio prostředí dostupná.

Když používáte klasického chatbota jako dovednost s a Bot Framework robot, Bot Framework robot určí, zda něco uživatel říká, že odpovídá spouštěcím frázím klasického chatbota. Pokud existuje shoda, Bot Framework robot předá konverzaci klasickému chatbotovi. Klasický chatbot extrahuje všechny entity a spustí odpovídající téma.

Můžete také předat proměnnou do a Copilot Studio dovednost téma jako vstup z Bot Framework Skladatel a použijte výstupy, které vrací.

Důležité

Abyste mohli používat klasické chatboty jako dovednosti, musíte mít zkušební nebo plnou Copilot Studio licenci. Tato funkce není k dispozici s Týmy Copilot Studio licence.

Chcete-li nastavit svého klasického chatbota jako dovednost:

  1. Přidejte Bot Framework robot do seznamu povolených pro klasického chatbota.

  2. Stáhněte si manifest dovednost pro klasického chatbota.

  3. Pomocí staženého manifestu dovednost v Bot Framework Composer vytvořte spojení mezi roboty.

  4. Pomocí Bot Framework emulátoru potvrďte, že robot funguje jako dovednost.

Předpoklady

Přidejte svůj Bot Framework robot do seznamu povolených pro vašeho klasického chatbota

Přidejte ID aplikace Bot Framework robot na seznam povolených pro klasického chatbota, kterého chcete používat jako dovednost. Roboti musejí být ve stejném klientu.

  1. V Bot Framework Composeru otevřete robota, který bude dovednost používat. Vyberte položku Konfigurovat a poté vyberte Zdroje pro vývoj. Zkopírujte ID v poli ID aplikace Microsoft.

  2. V Copilot Studio otevřete klasického chatbota, kterého chcete použít jako dovednost.

  3. V navigační nabídce pod Nastavení vyberte Zabezpečení. Poté vyberte Seznam povolených.

  4. Vyberte položku Přidat povoleného volajícího.

  5. Vložte ID aplikace robota Bot Framework a vyberte Další.

    Upozornění

    Klasický chatbot nemůže fungovat jako dovednost pro ostatní klasické chatboty. Pokud se pokusíte přidat ID aplikace, které patří robotu Power Virtual Agent, do seznamu povolených, zobrazí se chyba. Můžete přidat pouze ID aplikace pro robota Bot Framework.

    Copilot Studio ověří ID aplikace Bot Framework robot a potvrdí, že patří robot stejného tenanta.

  6. (Volitelné) Přidejte Zobrazovaný název pro robota, kterého jste přidali do seznamu povolených.

  7. Zvolte Uložit.

Robot Bot Framework je zobrazen svým zobrazovaným názvem, pokud jste nějaký zadali, nebo podle ID aplikace, pokud jste zobrazovaný název nezadali. Chcete-li údaj odstranit nebo upravit, vyberte ikonu napravo od zobrazovaného názvu nebo ID aplikace robota.

Poznámka:

Roboti Bot Framework přidaní do seznamu povolených nejsou exportováni jako součást obsahu robota.

Stáhněte si manifest klasického chatbota dovednost pro svého klasického chatbota

Bot Framework boti mohou použít manifest Copilot Studio dovednost ke konfiguraci připojení ke klasickému chatbotu, který manifest vytvořil.

Všichni klasičtí chatboti mají dovednost manifesty. Jedná se o soubory JSON, které obsahují název dovednosti, rozhraní a spouštěcí fráze.

A Bot Framework robot může použít manifest dovednost, aby věděl, kdy spustit klasického chatbota (například v odpověď k něčemu, co mu uživatel řekne).

Copilot Studio dovednost manifesty se řídí verzí 2.2 Bot Framework dovednost schématu manifestu a skládají se ze souborů intents.lu a manifest.json .

A Bot Framework robot se může rozhodnout, že klasický chatbot by měl zpracovat požadavek uživatele na základě dat z manifestu. Klasickému chatbotovi předá vše, co uživatel řekl. Poté klasický chatbot porovná to, co uživatel řekl k a Copilot Studio téma, extrahuje všechny entity, které jsou potřeba pro slot-filling a spustí Copilot Studio téma.

Copilot Studio dovednost manifesty se generují a aktualizují automaticky. Klasický chatbot má dva dovednost manifesty:

  • Test manifest: Umožňuje Bot Framework robot připojit se k testovací verzi vašeho klasického chatbota. Pomocí testovacího manifestu ověřte změny své dovednosti, než je publikujete.

    • Testovací manifest je okamžitě k dispozici pro každého nově vytvořeného klasického chatbota.
    • Automaticky se aktualizuje, aby odrážel změny pokaždé, když uložíte svého klasického chatbota.

  • Published manifest: Umožňuje Bot Framework robot připojit se k publikované verzi vašeho klasického chatbota.

    • Publikovaný manifest je dostupný pouze pro klasické chatboty, kteří byli alespoň jednou publikováni.
    • Automaticky se aktualizuje, aby odrážel změny pokaždé, když zveřejníte agent.

Poznámka:

Publikovaný manifest není dostupný pro klasické chatboty, které nebyly nikdy publikovány.

Chcete-li vygenerovat svůj robot Publikovaný manifest, publikujte svého klasického chatbota.

Oba manifesty dovedností jsou zobrazeny v panelu Spravovat seznam povolených.

Manifesty dovedností jsou také zobrazeny na stránce s podrobnostmi kopilota. Na navigačním panelu klikněte na tlačítko Nastavení a vyberte Podrobnosti. Stránka Podrobnosti zobrazuje další metadata, včetně ID prostředí, ID klientu a ID aplikace robota.

Chcete-li stáhnout manifest, vyberte jej. Stáhne se jako soubor .zip označený _<robot název>manifest pro Publikovaný manifest nebo <robot název>test__manifest pro Testovací manifest.

Poznámka:

Dovednost manifest nezahrnuje systémová témata a dialogová okna Composer, která se přidávají ke klasickému chatbotu. Zahrnuta jsou pouze témata, která byla vytvořena autory kopilotů, a triggery záměrů Composeru, které autoři přidají do robota.

Připojte se k a Copilot Studio dovednost v aplikaci Composer

Pomocí manifestů Copilot Studio dovednost vytvořte spojení dovednost ve vašem Bot Framework robot v aplikaci Composer.

  1. V projektu Bot Framework Composeru vyberte položku Přidat a poté Připojit se k dovednosti.

  2. Vyhledejte a vyberte Copilot Studio manifest archiv .zip a poté vyberte Další.

  3. Vyberte témata nebo záměry ve svém klasickém chatbotu, které chcete přidat do svého Bot Framework robot, a poté vyberte Další.

  4. Zkontrolujte a upravte spouštěcí fráze pro svého klasického chatbota a poté vyberte Další.

  5. Zkontrolujte, že je vybrána možnost Použít Orchestrator u projektů s více roboty a poté vyberte Pokračovat.

  6. Ověřte, že Copilot Studio dovednost je správně přidáno do vašeho Bot Framework robot a že se v projektu ve Composeru objeví nový spouštěč se jménem vašeho klasického chatbota.

Vyhledání tématu v manifestu dovednosti

Pomocí události spusťte Copilot Studio téma v dovednost. Chcete-li volat konkrétní téma z Composeru, odkazujte na něj podle názvu související události v manifestu dovednosti.

  1. Vyberte akci Připojit k dovednosti.

  2. V části Název dialogu dovednosti vyberte Zobrazit manifest dovednosti.

  3. Vyhledejte v manifestu vlastnost activities. Tato vlastnost obsahuje vnořené vlastnosti, které představují témata dostupná ve vašem klasickém chatbotu.

  4. Najděte téma, které chcete zavolat, a vyhledejte jeho vlastnost name. Když Copilot Studio dovednost přijme událost s tímto názvem, spustí téma.

    V tomto příkladu je název aktivity události dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d.

Zavolejte na Copilot Studio dovednost téma

Místo toho, abyste se spoléhali na to, co uživatel říká, aby spustilo Copilot Studio dovednost téma,, můžete to zavolat přímo. Přímo můžete volat pouze Copilot Studio témata, která jsou uvedena v manifestu dovednost.

  1. Na vytvářecím plátně Composeru vyberte Přidat, poté vyberte Přístup k externím zdrojům a pak vyberte Připojit se k dovednosti.

  2. V seznamu dovednost Dialog Name vyberte svého klasického chatbota.

  3. Najděte název aktivity události pro klasického chatbota téma , kterému chcete zavolat. Zkopírujte hodnotu (s vynecháním uvozovek) a uložte ji pro použití v dalších krocích.

  4. Vyberte Zavřít.

  5. V sekci Aktivita vyberte Zobrazit kód.

  6. Zadejte nebo vložte následující kód. Část TOPIC_ACTIVITY_NAME nahraďte názvem vaší aktivity události tématu. Ujistěte se, že ve vlastnosti name nejsou žádné uvozovky.

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

Předejte vstupní proměnnou do a Copilot Studio dovednost téma

Bot Framework Skladatel může předat proměnnou do a Copilot Studio dovednost téma jako vstup. Chcete-li se dozvědět, jak vytvořit Copilot Studio témata, která přijímají vstupní proměnné, viz Práce s proměnnými.

Pokud je v manifestu dovednost uvedena Copilot Studio téma, která může přijímat vstupní proměnnou, můžete jí předat proměnnou Composer.

  1. Na vytvářecím plátně Composeru vyberte Přidat, poté vyberte Přístup k externím zdrojům a pak vyberte Připojit se k dovednosti.

  2. V seznamu dovednost Dialog Name vyberte svého klasického chatbota.

  3. Najděte název aktivity události pro klasického chatbota téma , kterému chcete zavolat. Zkopírujte hodnotu (s vynecháním uvozovek) a uložte ji pro použití v dalších krocích.

  4. Najděte vlastnost value tématu. Vlastnost value obsahuje vlastnost $ref. Zkopírujte tuto hodnotu a uložte ji pro použití v dalším kroku.

    Upozorňující

    Pokud a Copilot Studio téma nemá vstupy, nebude mít vlastnost value .

  5. Vyhledejte vlastnost definitions, pak vyhledejte vnořenou vlastnost, která odpovídá hodnotě $ref, kterou jste zjistili v předchozím kroku. Poznamenejte si názvy a typy vstupů Copilot Studio téma. Budete je používat v dalších krocích.

  6. Vyberte Zavřít.

  7. V sekci Aktivita vyberte Zobrazit kód.

  8. Zadejte nebo vložte následující kód. Nahraďte tyto hodnoty:

    1. Část TOPIC_ACTIVITY_NAME nahraďte názvem vaší aktivity události tématu.
    2. Část PVA_INPUT_VARIABLE nahraďte vstupní proměnnou z vašeho tématu.
    3. Část COMPOSER_INPUT_VARIABLE nahraďte proměnnou Composeru, která poskytne hodnotu.
    [Activity
    Type = event
    Name = TOPIC_ACTIVITY_NAME
    Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
]

    V tomto příkladu proměnná Composer dialog.storeLocation poskytuje hodnotu vstupní proměnné pva_StoreLocation v klasickém chatbotu téma dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16.

Přijměte výstupní proměnnou z a Copilot Studio dovednost téma

V aplikaci Composer je možné přijímat výstupy z a Copilot Studio dovednost téma. Chcete-li se dozvědět, jak vytvořit Copilot Studio témata, která vracejí výstupy, přečtěte si Práce s proměnnými.

  1. Na vytvářecím plátně Composeru vyberte Přidat, poté vyberte Přístup k externím zdrojům a pak vyberte Připojit se k dovednosti.

  2. V seznamu dovednost Dialog Name vyberte svého klasického chatbota.

  3. Najděte název aktivity události pro svého klasického chatbota téma , kterému chcete zavolat. Zkopírujte hodnotu (s vynecháním uvozovek) a uložte ji pro použití v dalších krocích.

  4. Najděte vlastnost resultValue tématu. Vlastnost resultValue obsahuje vlastnost $ref. Zkopírujte tuto hodnotu a uložte ji pro použití v dalším kroku.

    Upozorňující

    Pokud a Copilot Studio téma nemá výstupy, nebude mít vlastnost resultValue .

  5. Vyhledejte vlastnost definitions, pak vyhledejte vnořenou vlastnost, která odpovídá hodnotě $ref, kterou jste zjistili v předchozím kroku. Všimněte si jmen a typů výstupních proměnných Copilot Studio téma. Budete je používat v dalších krocích.

    V tomto příkladu Copilot Studio téma vrací dva výstupy typu String, pva_State a pva_Item.

  6. Vyberte Zavřít.

  7. V sekci Aktivita vyberte Zobrazit kód.

  8. Zadejte nebo vložte následující kód. Část TOPIC_ACTIVITY_NAME nahraďte názvem vaší aktivity události tématu. Ujistěte se, že ve vlastnosti name nejsou žádné uvozovky.

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

  9. V oblasti kódu nastavte Vlastnost na proměnnou Composer, abyste mohli přijímat a ukládat výstupní hodnoty z Copilot Studio dovednost téma.

  10. Ve vytvářecím plátně Composeru vyberte Přidat, poté vyberte Spravovat vlastnosti a pak vyberte Nastavit vlastnosti.

  11. Nastavte Vlastnost na hodnotu Composeru, která bude uchovávat extrahovanou hodnotu. Poté nastavte Hodnotu na proměnnou Composeru, do které jste uložili výstupy tématu.

    V tomto příkladu jsou výstupní hodnoty z dialog.skillResult.pvaState a dialog.skillResult.pvaItem extrahovány do nový skladatel proměnné dialog.State a dialog.Položka.

Otestujte svého klasického chatbota jako dovednost pomocí a Bot Framework robot

Pomocí Bot Framework Emulátoru otestujte, zda váš Bot Framework robot správně volá klasického chatbota jako dovednost.

Důležité

Váš Bot Framework robot musí být přidán do seznamu povolených klasického chatbota, aby připojení dovednost fungovalo.

Další informace