Delen via

Een klassieke chatbot als een vaardigheid gebruiken in een Bot Framework-bot

  • Artikel

Opmerking

Dit artikel bevat informatie die alleen van toepassing is op klassieke chatbots. Copilot Studio Deze functie is niet beschikbaar in de nieuwe Copilot Studio ervaring.

Wanneer u een klassieke chatbot gebruikt als een vaardigheid met een Bot Framework bot, bepaalt de Bot Framework bot of iets wat de gebruiker zegt, overeenkomt met de trigger-zinnen van de klassieke chatbot. Als er een match is, stuurt de Bot Framework bot het gesprek door naar de klassieke chatbot. De klassieke chatbot extraheert alle entiteiten en activeert de bijpassende onderwerp.

U kunt ook een variabele doorgeven aan a Copilot Studio vaardigheid onderwerp als invoer van Bot Framework Composer en de uitvoer gebruiken die deze retourneert.

Belangrijk

Je hebt een proef of volledige Copilot Studio licentie nodig om klassieke chatbots als vaardigheden te kunnen gebruiken. Deze mogelijkheid is niet beschikbaar met de Teams Copilot Studio licentie.

Om uw klassieke chatbot in te stellen als vaardigheid:

  1. Voeg de Bot Framework bot toe aan de toegestane lijst voor de klassieke chatbot.

  2. Download het vaardigheid-manifest voor de klassieke chatbot.

  3. gebruik het gedownloade vaardigheid-manifest in Bot Framework Composer om een verbinding tussen de bots te maken.

  4. gebruik de Bot Framework emulator om te bevestigen dat bot werkt als een vaardigheid.

Vereisten

Voeg uw Bot Framework bot toe aan de toegestane lijst voor uw klassieke chatbot

Voeg de app-ID van de bot toe aan de toegestane lijst voor de klassieke chatbot die u wilt gebruiken als vaardigheid. Bot Framework De bots moeten in dezelfde tenant zijn.

  1. Open in Bot Framework Composer de bot die de vaardigheid zal gebruiken. Selecteer Configureren en selecteer daarna Ontwikkelresources. Kopieer de id in Microsoft App-id.

  2. Open in Copilot Studio de klassieke chatbot die u wilt gebruiken als vaardigheid.

  3. Ga in het navigatiemenu naar Instellingen en selecteer Beveiliging. Selecteer daarna Acceptatielijst.

  4. Selecteer Toegestane beller toevoegen.

  5. Plak de app-id van uw Bot Framework-bot en selecteer Volgende.

    Let op

    Een klassieke chatbot kan niet als vaardigheid fungeren voor andere klassieke chatbots. Als u probeert een app-id die bij een Power Virtual Agent-bot hoort aan de acceptatielijst toe te voegen, krijgt u een foutmelding. U kunt alleen een app-id toevoegen voor een Bot Framework-bot.

    Copilot Studio valideert de app-ID van de bot en bevestigt dat deze bij een bot in dezelfde tenant hoort. Bot Framework

  6. (Optioneel) Voeg een weergavenaam toe voor de bot die u aan de acceptatielijst hebt toegevoegd.

  7. Selecteer Opslaan.

De Bot Framework-bot wordt weergegeven met de weergavenaam als u er een hebt ingevoerd, of met de app-id als u geen weergavenaam hebt ingevoerd. Als u het op elk gewenst moment wilt verwijderen of bewerken, selecteert u het pictogram rechts van de weergavenaam of app-id van de bot.

Notitie

De Bot Framework-bots die aan de Acceptatielijst zijn toegevoegd, worden niet geëxporteerd als onderdeel van de botinhoud.

Download het klassieke chatbot-manifest vaardigheid voor uw klassieke chatbot

Bot Framework bots kunnen een Copilot Studio vaardigheid-manifest gebruiken om een verbinding te configureren met de klassieke chatbot die het manifest heeft geproduceerd.

Alle klassieke chatbots hebben vaardigheid-manifesten. Dit zijn JSON-bestanden die de naam, interface en triggerzinnen van een vaardigheid bevatten.

A Bot Framework bot kan een vaardigheid-manifest gebruiken om te weten wanneer de klassieke chatbot trigger moet worden (bijvoorbeeld in respons op iets dat een gebruiker tegen de chatbot zegt).

Copilot Studio vaardigheid manifesteert volgen versie 2.2 van het Bot Framework vaardigheid manifestschema en bestaat uit intents.lu en manifest.json bestanden.

A Bot Framework bot kan beslissen dat een klassieke chatbot het verzoek van de gebruiker moet afhandelen, op basis van de manifestgegevens. Alles wat de gebruiker zegt, wordt doorgestuurd naar de klassieke chatbot. Vervolgens koppelt de klassieke chatbot wat de gebruiker heeft gezegd aan een Copilot Studio onderwerp, extraheert alle entiteiten die nodig zijn voor het vullen van slots en activeert de Copilot Studio onderwerp.

Copilot Studio vaardigheid-manifesten worden automatisch gegenereerd en bijgewerkt. Een klassieke chatbot heeft twee vaardigheid-manifesten:

  • Testmanifest: Hiermee kan de Bot Framework bot Verbinden naar de testversie van uw klassieke chatbot. Gebruik het testmanifest om wijzigingen in uw vaardigheid te valideren voordat u deze publiceert.

    • Het testmanifest is direct beschikbaar voor elke nieuw aangemaakte klassieke chatbot.
    • De wijzigingen worden automatisch doorgevoerd telkens wanneer u uw klassieke chatbot opslaat.

  • Gepubliceerd manifest: Hiermee kan de Bot Framework bot Verbinden naar de gepubliceerde versie van uw klassieke chatbot.

    • Het gepubliceerde manifest is alleen beschikbaar voor klassieke chatbots die minimaal één keer zijn gepubliceerd.
    • Het wordt automatisch bijgewerkt met wijzigingen telkens wanneer u uw agent publiceert.

Notitie

Het gepubliceerde manifest is niet beschikbaar voor klassieke chatbots die nog nooit zijn gepubliceerd.

Om het gepubliceerde manifest van uw bot te genereren, publiceert u uw klassieke chatbot.

Beide manifesten van vaardigheid worden weergegeven in het paneel Acceptatielijst beheren.

De manifesten van vaardigheid worden ook weergegeven op de detailpagina van de copilot. Selecteer in het navigatiemenu Instellingen en daarna Details. De pagina Details toont andere metagegevens, zoals Omgevings-id, Tenant-id en App-id van bot.

Om een manifest te downloaden, selecteert u het. Het wordt gedownload als een .zip-bestand met de naam _<bot naam>manifest voor het gepubliceerde manifest, of <bot naam>test__manifest voor het testmanifest.

Notitie

Het vaardigheid-manifest bevat geen systeemonderwerpen en Composer-dialogen die aan een klassieke chatbot worden toegevoegd. Alleen onderwerpen die zijn gemaakt door copilot-auteurs en intentietriggers van Composer die auteurs aan de bot toevoegen, worden opgenomen.

Verbinden naar a Copilot Studio vaardigheid in Composer

Gebruik Copilot Studio vaardigheid-manifesten om een vaardigheid-verbinding te maken in uw Bot Framework bot in Composer.

  1. Selecteer in een Bot Framework Composer-project de optie Toevoegen en vervolgens Verbinden met een vaardigheid.

  2. Blader naar een Copilot Studio manifest .zip-archief, selecteer dit en selecteer vervolgens Volgende.

  3. Selecteer de onderwerpen of bedoelingen in uw klassieke chatbot die u wilt toevoegen aan uw Bot Framework bot en selecteer vervolgens Volgende.

  4. Bekijk en bewerk de trigger-zinnen voor uw klassieke chatbot en selecteer vervolgens Volgende.

  5. Zorg ervoor dat Orchestrator gebruiken voor projecten met meerdere bots is geselecteerd en selecteer Doorgaan.

  6. Controleer of de Copilot Studio vaardigheid correct is toegevoegd aan uw Bot Framework bot en of er een nieuwe trigger met de naam van uw klassieke chatbot in het project in Composer staat.

Het onderwerp zoeken in het manifest van vaardigheid

Gebruik een gebeurtenis om trigger a Copilot Studio onderwerp in de vaardigheid te plaatsen. Als u een specifiek onderwerp wilt aanroepen vanuit Composer, verwijst u naar het onderwerp met de bijbehorende gebeurtenis in het manifest van vaardigheid.

  1. Selecteer de actie Verbinden met een vaardigheid.

  2. Selecteer onder Naam van vaardigheidsdialoogvenster de optie Manifest van vaardighied weergeven.

  3. Zoek activiteiten in het manifest. Deze eigenschap bevat geneste eigenschappen die de onderwerpen vertegenwoordigen die beschikbaar zijn in uw klassieke chatbot.

  4. Zoek het onderwerp dat u wilt aanroepen en zoek naar de eigenschap name. Wanneer de Copilot Studio vaardigheid een gebeurtenis met deze naam ontvangt, wordt de onderwerp geactiveerd.

    In dit voorbeeld is de naam van de gebeurtenisactiviteit dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d.

Bel a Copilot Studio vaardigheid onderwerp

In plaats van te vertrouwen op wat een gebruiker zegt tegen trigger a Copilot Studio vaardigheid onderwerp,, kunt u het rechtstreeks aanroepen. U kunt alleen rechtstreeks onderwerpen aanroepen die in het manifest vaardigheid staan. Copilot Studio

  1. Selecteer in het ontwerpcanvas van Composer Toevoegen en selecteer vervolgens Toegang tot externe bronnen en selecteer vervolgens Verbinden met een vaardigheid.

  2. Selecteer uw klassieke chatbot in de lijst vaardigheid Dialog Name .

  3. Zoek de naam van de evenementactiviteit voor de klassieke chatbot onderwerp die u wilt aanroepen. Kopieer de waarde, laat de aanhalingstekens weg, en sla deze op voor gebruik in de volgende stappen.

  4. Selecteer Sluiten.

  5. Selecteer in de sectie Activiteit de optie Code weergeven.

  6. Typ of plak de volgende code. Vervang TOPIC_ACTIVITY_NAME door de naam van de gebeurtenisactiviteit van uw onderwerp. Zorg ervoor dat er geen aanhalingstekens in de eigenschap name staan.

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

Geef een invoervariabele door aan a Copilot Studio vaardigheid onderwerp

Bot Framework Composer kan een variabele als invoer doorgeven aan a Copilot Studio vaardigheid onderwerp. Zie Copilot Studio Werken met variabelen voor meer informatie over het maken van onderwerpen die invoervariabelen accepteren .

Als een Copilot Studio onderwerp die een invoervariabele kan ontvangen in uw vaardigheid-manifest staat, kunt u er een Composer-variabele aan doorgeven.

  1. Selecteer in het ontwerpcanvas van Composer Toevoegen en selecteer vervolgens Toegang tot externe bronnen en selecteer vervolgens Verbinden met een vaardigheid.

  2. Selecteer uw klassieke chatbot in de lijst vaardigheid Dialog Name .

  3. Zoek de naam van de evenementactiviteit voor de klassieke chatbot onderwerp die u wilt aanroepen. Kopieer de waarde, laat de aanhalingstekens weg, en sla deze op voor gebruik in de volgende stappen.

  4. Zoek de eigenschap value van het onderwerp. De eigenschap value bevat een eigenschap $ref. Kopieer die waarde en sla deze op voor gebruik in de volgende stap.

    Waarschuwing

    Als a Copilot Studio onderwerp geen invoer heeft, heeft het geen waarde eigenschap.

  5. Zoek de eigenschap definitions en zoek vervolgens naar een geneste eigenschap die overeenkomt met de $ref-waarde die u in de vorige stap hebt gevonden. Let op de namen en typen van de invoer van Copilot Studio onderwerp. U gebruikt deze in de volgende stappen.

  6. Selecteer Sluiten.

  7. Selecteer in de sectie Activiteit de optie Code weergeven.

  8. Typ of plak de volgende code. Vervang deze waarden:

    1. Vervang TOPIC_ACTIVITY_NAME door de naam van de gebeurtenisactiviteit van uw onderwerp.
    2. Vervang PVA_INPUT_VARIABLE door een invoervariabele uit uw onderwerp.
    3. Vervang COMPOSER_INPUT_VARIABLE door een Composer-variabele die een waarde zal opleveren.
    [Activity
    Type = event
    Name = TOPIC_ACTIVITY_NAME
    Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
]

    In dit voorbeeld levert de variabele Composer dialog.storeLocation een waarde aan de invoervariabele pva_StoreLocation in de klassieke chatbot onderwerp dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16.

Ontvang een uitvoervariabele van a Copilot Studio vaardigheid onderwerp

Het is mogelijk om uitvoer van a Copilot Studio vaardigheid onderwerp te ontvangen in Composer. Zie Copilot Studio Werken met variabelen voor meer informatie over het maken van onderwerpen die uitvoer retourneren.

  1. Selecteer in het ontwerpcanvas van Composer Toevoegen en selecteer vervolgens Toegang tot externe bronnen en selecteer vervolgens Verbinden met een vaardigheid.

  2. Selecteer uw klassieke chatbot in de lijst vaardigheid Dialog Name .

  3. Zoek de naam van de evenementactiviteit voor de klassieke chatbot onderwerp die u wilt bellen. Kopieer de waarde, laat de aanhalingstekens weg, en sla deze op voor gebruik in de volgende stappen.

  4. Zoek de eigenschap resultValue van het onderwerp. De eigenschap resultValue bevat een eigenschap $ref. Kopieer die waarde en sla deze op voor gebruik in de volgende stap.

    Waarschuwing

    Als a Copilot Studio onderwerp geen uitvoer heeft, heeft het ook geen resultValue eigenschap.

  5. Zoek de eigenschap definitions en zoek vervolgens naar een geneste eigenschap die overeenkomt met de $ref-waarde die u in de vorige stap hebt gevonden. Let op de namen en typen van de uitvoervariabelen van Copilot Studio onderwerp. U gebruikt deze in de volgende stappen.

    In dit voorbeeld retourneert de Copilot Studio onderwerp twee uitvoertypen van het type String, pva_State en pva_Item.

  6. Selecteer Sluiten.

  7. Selecteer in de sectie Activiteit de optie Code weergeven.

  8. Typ of plak de volgende code. Vervang TOPIC_ACTIVITY_NAME door de naam van de gebeurtenisactiviteit van uw onderwerp. Zorg ervoor dat er geen aanhalingstekens in de eigenschap name staan.

    [Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]

  9. Stel onder het codegebied Property in op een Composer-variabele om de uitvoerwaarden van de Copilot Studio vaardigheid onderwerp. te ontvangen en op te slaan

  10. Selecteer in het ontwerpcanvas van Composer Toevoegen en selecteer vervolgens Eigenschappen beheren en selecteer vervolgens Eigenschappen instellen.

  11. Stel de optie Eigenschap in op de Composer-waarde die de geëxtraheerde waarde moet opslaan. Stel vervolgens Waarde in op de Composer-variabele waarin u de uitvoer van het onderwerp hebt opgeslagen.

    In dit voorbeeld worden de uitvoerwaarden van dialog.skillResult.pvaState en dialog.skillResult.pvaItem geëxtraheerd in de nieuwe Composer-variabelen dialog.State en dialog.Item.

Test je klassieke chatbot als vaardigheid met een Bot Framework bot

Gebruik de Bot Framework emulator om te testen of uw Bot Framework bot een klassieke chatbot correct aanroept als een vaardigheid.

Belangrijk

Je Bot Framework bot moet worden toegevoegd aan de toegestane lijst van de klassieke chatbot om de vaardigheid-verbinding te laten werken.

Meer informatie