Perinteisen keskustelubotin käyttäminen Bot Framework -botin taitona

Muistiinpano

Tämä artikkeli sisältää tietoja, jotka Copilot Studio koskevat vain perinteisiä chatbotteja. Tämä ominaisuus ei ole käytettävissä uudessa Copilot Studio versiossa.

Kun käytät klassista chatbottia a taito with a Bot Framework botti, botti Bot Framework määrittää, vastaako käyttäjän sanoma klassisen chatbotin laukaisulausea. Jos vastaavuus löytyy, botti Bot Framework välittää keskustelun perinteiselle chatbotille. Perinteinen keskustelubotti poimii kaikki entiteetit ja käynnistää vastaavat aihe.

Voit myös välittää muuttujan a Copilot Studio taito aihe Composerin syötteenä Bot Framework ja käyttää sen palauttamia tulosteita.

Tärkeää

Sinulla on oltava kokeiluversio tai täysi lisenssi, jotta voit käyttää klassisia Copilot Studio chatbotteja osaamisalueet. Tämä ominaisuus ei ole käytettävissä Teams-käyttöoikeudessa Copilot Studio .

Voit määrittää perinteisen keskustelubotin taito seuraavasti:

1. Bot Framework Lisää botti perinteisen keskustelubotin sallittujen luetteloon.

2. Lataa klassisen keskustelubotin taito-luettelo.

3. Käytä ladattua taito-luetteloa Composerissa Bot Framework luodaksesi yhteyden bottien välille.

4. Varmista emulaattorilla, Bot Framework että botti toimii taito.

Edellytykset

• Tietoja Bot Framework -taitojen toiminnasta.
• Tietoja Bot Framework Composerin käyttämisestä.
• Tietoja Bot Framework Composerin taitojen käyttämisestä.
• Hanki Bot Framework -botin sovellustunnus.

Bot Framework Lisää botti perinteisen keskustelubotin sallittujen luetteloon

Bot Framework Lisää botti sovellustunnus sen perinteisen keskustelubotin sallittujen luetteloon, jota haluat käyttää taito. Bottien on oltava samassa vuokraajassa.

1. Avaa Bot Framework Composerissa botti, joka käyttää kyseistä taitoa. Valitse Määritä ja valitse sitten Kehitysresurssit. Kopioi Microsoftin sovellustunnus -kohdan tunnus.

2. Avaa Copilot Studio klassinen chatbot, jota haluat käyttää taito.

3. Valitse siirtymisvalikossa Asetukset ja valitse Suojaus. Valitse sitten sallittujen kohteiden luettelo.

4. Valitse Lisää sallittu kutsuja.

5. Liitä Bot Framework -botin sovellustunnus ja valitse Seuraava.

   Varoitus

   Klassinen chatbot ei voi toimia taito muille klassisille chatboteille. Jos yrität lisätä sallittujen kohteiden luetteloon Power Virtual Agent -bottiin kuuluvan sovellustunnuksen, näkyviin tulee virhe. Voit lisätä sovellustunnuksen vain Bot Framework -botille.

   Copilot Studio Bot Framework vahvistaa botti:n sovellustunnuksen ja vahvistaa, että se kuuluu saman vuokraajan botti.

6. (Valinnainen) Lisää Näyttönimi botille, jonka olet lisännyt sallittujen kohteiden luetteloon.

7. Valitse Tallenna.

Bot Framework -botti näytetään sen näyttönimen mukaan, jos se on syötetty, tai sen sovellustunnuksen mukaan, jos näyttönimeä ei ole syötetty. Voit poistaa tai muokata sitä milloin tahansa valitsemalla botin näyttönimen oikealla puolella olevan kuvakkeen tai sovellustunnuksen.

Muistiinpano

Sallittujen kohteiden luetteloon lisättyjä Bot Framework -botteja ei viedä botin sisällön osana.

Lataa klassinen keskustelubotti taito luetteloi perinteiselle keskustelubotillesi

Bot Framework Botit voivat käyttää A Copilot Studio taito manifestia määrittääkseen yhteyden klassiseen keskustelubottiin, joka tuotti manifestin.

Kaikilla klassisilla chatboteilla on taito manifestia. Nämä ovat JSON-tiedostoja, jotka sisältävät taidon nimen, liittymän ja käynnistinlauseet.

A Bot Framework botti voi käyttää taito manifestia tietääkseen, milloin klassinen keskustelubotti käynnistetään (esimerkiksi vastaus johonkin, mitä käyttäjä sanoo sille).

Copilot Studio taito luettelotiedostot noudattavat taito manifestimallin versiota 2.2 Bot Framework ja koostuvat intents.lu - ja manifest.json tiedostoista .

V Bot Framework botti voi päättää perinteisessä chatbotissa, että se käsittelee käyttäjän pyynnön luettelotietojen perusteella. Se välittää klassiselle chatbotille kaiken, mitä käyttäjä sanoi. Sitten klassinen chatbot vastaa sitä, mitä käyttäjä sanoi a Copilot Studio aihe, poimii kaikki aukon täyttämiseen tarvittavat entiteetit ja käynnistää Copilot Studio aihe.

Copilot Studio taito luettelotiedostot luodaan ja päivitetään automaattisesti. Perinteisellä keskustelubotilla on kaksi taito manifestia:

• Testiluettelo: Antaa botti Bot Framework muodostaa yhteyden klassisen keskustelubotin testiversioon. Käytä testiluettelotiedostoa taidon muutosten tarkistamisessa ennen sen julkaisemista.

  • Testiluettelotiedosto on heti käytettävissä jokaiselle uudelle klassiselle keskustelubotille.
  • Se päivittyy automaattisesti vastaamaan muutoksia aina, kun tallennat perinteisen keskustelubotin.

• Julkaistu luettelotiedosto: Sallii Bot Framework botti yhteyden muodostamisen perinteisen keskustelubotin julkaistuun versioon.

  • Julkaistu luettelotiedosto on saatavilla vain klassisille keskusteluboteille, jotka on julkaistu vähintään kerran.
  • Se päivittyy automaattisesti vastaamaan muutoksia aina, kun julkaiset asiakaspalvelija.

Muistiinpano

Julkaistu luettelotiedosto ei ole käytettävissä perinteisille keskusteluboteille, joita ei ole koskaan julkaistu.

Jos haluat luoda botti Julkaistu-luettelon , julkaise perinteinen keskustelubottisi.

Molemmat taidon luettelotiedostot näkyvät Hallitse sallittujen kohteiden luetteloa -paneelissa.

Taidon luettelotiedostot näkyvät myös avustajan Tiedot-sivulla. Valitse siirtymisvalikosta Asetukset ja valitse sitten Tiedot. Tiedot-sivulla näkyvät muut metatiedot, kuten ympäristön tunnus, vuokraajan tunnus ja botin sovellustunnus.

Lataa luettelotiedosto valitsemalla se. Se ladataan .zip-tiedostona, jonka nimi on _<botti nimen>luettelotiedosto julkaistulle luettelotiedostolle tai < botti nimi>test__manifest testiluettelolle.

Muistiinpano

Taito luettelotiedosto ei sisällä järjestelmäaiheita eikä Composer-valintaikkunoita, jotka on lisätty perinteiseen keskustelubottiin. Vain avustajien tekijöiden luomat aiheet ja Composerin aikeen käynnistimet, jotka tekijät lisäävät bottiin, sisällytetään.

Yhdistä taito Copilot Studio Composerissa

Käytä Copilot Studio taito luettelot luodaksesi taito-yhteyden botti Composerissa Bot Framework .

1. Valitse Bot Framework Composer -projektissa Lisää ja valitse sitten Muodosta yhteys taitoon.

2. Etsi ja valitse Copilot Studio luettelotiedosto .zip arkisto ja valitse sitten Seuraava.

3. Valitse perinteisen keskustelubotin aiheet tai aikeet, jotka haluat lisätä botti-viestiin Bot Framework , ja valitse sitten Seuraava.

4. Tarkista ja muokkaa perinteisen keskustelubotin käynnistinlauseita ja valitse sitten Seuraava.

5. Varmista, että Käytä Orchestratoria usean botin projekteissa on valittuna ja valitse Jatka.

6. Varmista, että Copilot Studio taito on lisätty botti Bot Framework oikein ja että uusi käynnistin, jossa on klassisen keskustelubotin nimi, näkyy Composerin projektissa.

Etsi aihe taidon luettelotiedostosta

Käytä tapahtumaa käynnistääksesi a Copilot Studio aihe taito. Jos haluat kutsua tiettyä aihetta Composerssa, viittaa aiheeseen taidon luettelotiedostoon liitetyn tapahtuman nimellä.

1. Valitse Muodosta yhteys taitoon -toiminto.

2. Valitse Taidon dialogin nimi -kohdassa Näytä taidon luettelotiedosto.

3. Etsi toiminnot luettelotiedostosta. Tämä ominaisuus sisältää sisäkkäisiä ominaisuuksia, jotka edustavat klassisessa keskustelubotissasi käytettävissä olevia aiheita.

4. Etsi aihe, jota haluat kutsua, ja etsi sen nimiominaisuus. Copilot Studio Kun taito saa tämän nimisen tapahtuman, se käynnistää aihe.

   Tässä esimerkissä tapahtuma-aktiviteetin nimi on dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d.

Soita a Copilot Studio taito aihe

Sen sijaan, että luottaisit siihen, mitä käyttäjä sanoo laukaistakseen a Copilot Studio taito aihe, voit soittaa sille suoraan. Voit soittaa Copilot Studio suoraan vain aiheisiin, jotka on lueteltu taito luettelotiedostossa.

1. Valitse Composerin sisällön tuotantoalustassa Lisää ja valitse sitten Käytä ulkoisia resursseja. Valitse lopuksi Muodosta yhteys taitoon.

2. taito Valitse Valintaikkunan nimi -luettelosta perinteinen keskustelubotti.

3. Etsi tapahtuma-aktiviteetin nimi perinteiselle keskustelubotille aihe johon haluat soittaa. Kopioi arvo, jätä lainausmerkit pois ja tallenna arvo seuraavissa vaiheissa käyttöä varten.

4. Valitse Sulje.

5. Valitse Aktiviteetti-osassa Näytä koodi.

6. Kirjoita tai liitä seuraava koodi. Korvaa TOPIC_ACTIVITY_NAME aiheen tapahtuman aktiviteetin nimellä. Varmista, että nimiominaisuudessa ei ole lainausmerkkejä.

   [Activity
       type = event
       name = TOPIC_ACTIVITY_NAME
   ]
   

Syötemuuttujan välittäminen arvoon a Copilot Studio taito aihe

Bot Framework Säveltäjä voi välittää muuttujan a Copilot Studio taito aihe:aan syötteenä. Lisätietoja syötemuuttujia hyväksyvien aiheiden luomisesta Copilot Studio on kohdassa Muuttujien käsitteleminen.

Copilot Studio Jos aihe, joka voi vastaanottaa syötemuuttujan, on lueteltu taito luettelotiedostossasi, voit välittää siihen Composer-muuttujan.

1. Valitse Composerin sisällön tuotantoalustassa Lisää ja valitse sitten Käytä ulkoisia resursseja. Valitse lopuksi Muodosta yhteys taitoon.

2. taito Valitse Valintaikkunan nimi -luettelosta perinteinen keskustelubotti.

3. Etsi tapahtuma-aktiviteetin nimi perinteiselle keskustelubotille aihe johon haluat soittaa. Kopioi arvo, jätä lainausmerkit pois ja tallenna arvo seuraavissa vaiheissa käyttöä varten.

4. Etsi aiheen arvo-ominaisuus. Arvo-ominaisuus sisältää $ref-ominaisuuden. Kopioi arvo ja tallenna se seuraavassa vaiheessa käyttöä varten.

   Varoitus

   Jos a Copilot Studio aihe:llä ei ole syötteitä, sillä ei ole arvo-ominaisuutta .

5. Etsi määritykset-ominaisuus, hae sitten sisäkkäinen ominaisuus, joka vastaa edellisessä vaiheessa löydettyä $ref-arvoa. Huomaa aihe syötteiden nimet ja tyypit Copilot Studio . Niitä käytetään seuraavassa vaiheessa.

6. Valitse Sulje.

7. Valitse Aktiviteetti-osassa Näytä koodi.

8. Kirjoita tai liitä seuraava koodi. Korvaa seuraavat arvot:

   1. Korvaa TOPIC_ACTIVITY_NAME aiheen tapahtuman aktiviteetin nimellä.
   2. Korvaa PVA_INPUT_VARIABLE aiheen syöttömuuttujalla.
   3. Korvaa COMPOSER_INPUT_VARIABLE Composerin muuttujalla, joka sisältää arvon.

   [Activity
       Type = event
       Name = TOPIC_ACTIVITY_NAME
       Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
   ]
   

   Tässä esimerkissä Composer-muuttuja dialog.storeLocation antaa arvon syötemuuttujalle perinteisessä keskustelubotin pva_StoreLocation aihe dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16.

Vastaanota tulosmuuttuja a Copilot Studio taito aihe

On mahdollista vastaanottaa tulosteita a Copilot Studio taito aihe Composerissa. Lisätietoja tuloksia palauttavien aiheiden luomisesta Copilot Studio on kohdassa Muuttujien käsitteleminen.

1. Valitse Composerin sisällön tuotantoalustassa Lisää ja valitse sitten Käytä ulkoisia resursseja. Valitse lopuksi Muodosta yhteys taitoon.

2. taito Valitse Valintaikkunan nimi -luettelosta perinteinen keskustelubotti.

3. Etsi tapahtuma-aktiviteetin nimi perinteiselle keskustelubotille aihe johon haluat soittaa. Kopioi arvo, jätä lainausmerkit pois ja tallenna arvo seuraavissa vaiheissa käyttöä varten.

4. Etsi aiheen resultValue-ominaisuus. resultValue-ominaisuus sisältää $ref-ominaisuuden. Kopioi arvo ja tallenna se seuraavassa vaiheessa käyttöä varten.

   Varoitus

   Jos a Copilot Studio aihe:lla ei ole tulosteita, sillä ei ole resultValue-ominaisuutta .

5. Etsi määritykset-ominaisuus, hae sitten sisäkkäinen ominaisuus, joka vastaa edellisessä vaiheessa löydettyä $ref-arvoa. Huomaa aihe:n Copilot Studio tulosmuuttujien nimet ja tyypit. Niitä käytetään seuraavassa vaiheessa.

   Tässä esimerkissä aihe Copilot Studio palauttaa kaksi tulosta, joiden tyyppi on Merkkijono,pva_State ja pva_Item.

6. Valitse Sulje.

7. Valitse Aktiviteetti-osassa Näytä koodi.

8. Kirjoita tai liitä seuraava koodi. Korvaa TOPIC_ACTIVITY_NAME aiheen tapahtuman aktiviteetin nimellä. Varmista, että nimiominaisuudessa ei ole lainausmerkkejä.

   [Activity
       type = event
       name = TOPIC_ACTIVITY_NAME
   ]
   

9. Määritä koodialueella Ominaisuus-asetukseksi Composer-muuttuja, jotta voit vastaanottaa ja tallentaa tulostearvot kohteesta taito aihe Copilot Studio .

10. Valitse Composerin sisällön tuotantoalustassa Lisää. Valitse Hallitse ominaisuuksia ja valitse sitten Määritä ominaisuudet.

11. Määritä ominaisuudeksi Composerin arvo, joka tallentaa poimitun arvon. Määritä sitten arvoksi Composerin muuttuja, joka tallennettiin aiheen tuloksiin.

    Tässä esimerkissä arvojen dialog.skillResult.pvaState ja dialog.skillResult.pvaItem tulosarvot poimitaan uuteen Säveltäjämuuttujat-valintaikkunaan . Tila ja dialogi. Kohde.

Testaa klassista keskustelubottiasi taito avulla Bot Framework botti

Testaa emulaattorin Bot Framework avulla, että botti Bot Framework kutsuu klassista chatbottia oikein taito.

Tärkeää

Bot Framework Sinun botti on lisättävä perinteisen keskustelubotin sallittujen luetteloon, jotta taito yhteys toimii.

Lisätietoja

• Taitojen yleiskatsaus
• Taitojen luettelotiedosto
• Bot Framework Composer -ohjeet
• Composerin taidot
• Muodosta yhteys etätaitoon Composerissa
• Testaa taito Emulatorissa