Brug en klassisk chatbot som en Azure Bot Service færdighed i en Azure Bot Service bot

Når du bruger en klassisk chatbot som en Azure Bot Service færdighed med en Bot Service-bot, tjekker Bot Service-boten, om noget af det, brugeren siger, matcher den klassiske chatbots trigger-fraser. Hvis der er et match, sender Bot Service-botten samtalen videre til den klassiske chatbot. Den klassiske chatrobot udtrækker alle objekter og udløser det tilsvarende emne.

Sådan opsætter du din klassiske chatbot som en Azure Bot Service skill:

1. Tilføj Bot Service bot til listen over tilladte for den klassiske chatbot.

2. Download Azure Bot Service færdighedsmanifest for den klassiske chatbot.

3. Forbind til en klassisk chatbot som en Azure Bot Service skill fra din Bot Service bot.

4. Bekræft, at den klassiske chatbot fungerer som en Azure Bot Service skill.

Forudsætninger

• Forstå, hvordan Azure Bot-servicefærdigheder fungerer.
• Hent din Bot Services app-id.

Føj din Bot Service bot til listen over tilladte for din klassiske chatbot

Føj Bot Service bots app-id til listen over tilladte for den klassiske chatrobot, du vil bruge som en færdighed. Robotterne skal være i samme tenant.

1. Få Microsoft-app-ID'et til din Bot Services-bot. Du kan finde disse oplysninger på Azure-portalen eller i robotkonfigurationerne.

2. I Copilot Studio skal du åbne den klassiske chatbot, du vil bruge som en Azure Bot Service-skill.

3. Gå til Indstillinger, vælg Sikkerhed, og vælg derefter Tillodsliste.

4. Vælg Tilføj tilladte opkalder.

5. Indsæt Bot Service-robottens app-id og vælg Næste.

   Advarsel

   En klassisk chatbot kan ikke fungere som en Azure Bot Service skill for andre klassiske chatbots. Hvis du prøver at tilføje et app-ID, der tilhører en klassisk chatbot, til tilladelseslisten, får du en fejl. Du kan kun tilføje et app-id for en Bot Service bot.

   Copilot Studio validerer Bot Service bots app-id og bekræfter, at den tilhører en robot i den samme lejer.

6. (Valgfrit) Tilføj et visningsnavn for den bot, du har tilføjet til tilladelseslisten.

7. Vælg Gem.

Den Bot Service bot vises med et displaynavn, hvis du har angivet et, eller med dens app-ID, hvis du ikke har angivet et displaynavn. Du kan altid slette eller redigere det ved at vælge ikonet til højre for robottens viste navn eller app-id.

Download Azure Bot Service færdighedsmanifest til din klassiske chatbot

Alle klassiske chatbots har Azure Bot Service færdighedsmanifest. Et færdighedsmanifest er en JSON-fil, der indeholder færdighedens navn, grænseflade og udløserfraser. Bot Service bots kan bruge den Azure Bot Service færdighedsmanifest fra en Copilot Studio klassisk chatbot til at konfigurere en forbindelse til den klassiske chatbot, der producerede manifestet.

En Bot Service bot bruger et Azure Bot Service færdighedsmanifest til at vide, hvornår den klassiske chatbot skal udløses (for eksempel som svar på noget, en bruger siger).

Azure Bot Service færdighedsmanifest for klassiske chatbots følger version 2.2 af Bot Service færdighedsmanifestskemaet og består af intents.lu og manifest.json filer.

Baseret på manifestdataene kan en Bot Service bot beslutte, at en klassisk chatbot skal håndtere brugerens anmodning. Botten sender alt, hvad brugeren sagde, videre til chatbotten. Derefter matcher chatbotten, hvad brugeren sagde, til et emne, udtrækker eventuelle enheder, der er nødvendige for at udfylde pladser, og udløser emnet.

Copilot Studio genererer og opdaterer automatisk Azure Bot Service-færdighedsmanifester. En klassisk chatbot har to manifest:

• Test manifest: Gør det muligt for Bot Service bot at oprette forbindelse til testversionen af din klassiske chatbot. Brug testmanifestet til at validere ændringer i din færdighed, inden du publicerer den.

  • Testmanifestet er straks tilgængeligt for hver nyoprettede klassiske chatrobot.
  • Den opdateres automatisk for at afspejle ændringer hver gang du gemmer din klassiske chatbot.

• Published manifest: Gør det muligt for Bot Service bot at oprette forbindelse til den publicerede version af din klassiske chatbot.

  • Det publicerede manifest er kun tilgængeligt for den klassiske chatrobot, der er publiceret mindst én gang.
  • Den opdateres automatisk for at afspejle ændringer hver gang du udgiver din klassiske chatbot.

Begge færdighedsmanifest vises på panelet Administrer allowlist .

Færdighedsmanifesterne vises også på chatbottens Detaljer-side . Gå til Indstillinger, og vælg derefter Detaljer. Detaljesiden viser andre metadata, herunder Environment ID, Tenant ID og Bot app ID.

Hvis du vil hente et manifest, skal du markere det. Det downloades som en .zip-fil med navnet _<robotnavn>manifest for det Publicerede manifest eller <robotnavn>test__manifest for testmanifestet.

Opret forbindelse til en klassisk chatbot som en Azure Bot Service-skill fra din bot

Brug informationen fra din Azure Bot Service skillmanifest til at skabe en skillforbindelse i din Bot Service bot.

Lær mere om strukturen af Azure Bot Service-færdighedsmanifestet i Azure Bot Service-færdighedsmanifest.

Aktivitetssektionen i Azure Bot Service skillmanifest indeholder de emner, der er tilgængelige i din klassiske chatbot.

Du kan implementere en Azure Bot Service skill consumer i din Bot Service bot for at kalde en klassisk chatbot som en Azure Bot Service-færdighed.

Test din klassiske chatbot som en Azure Bot Service skill med en Bot Service bot

Brug Bot Service Emulator til at teste, om din Bot Service bot korrekt kalder en klassisk chatbot som en Azure Bot Service skill.

Opdater en multilejer Bot Service bot til en enkeltelejer-bot

Følgende illustration viser scenariet, hvor en Bot Service bot kalder en klassisk chatbot for at bruge den som en Azure Bot Service skill.

Både den Bot Service bot og den klassiske chatbot har en Microsoft Entra ID appregistrering, som Azure Bot-forekomster refererer til. Du opretter disse Microsoft Entra ID appregistreringer som multitenant. Den Bot Service bot anmoder om et token fra lejeren Bot Service og bruger dette token til at godkende til Copilot Studio ved hjælp af Azure Bot Service. Copilot Studio bruger den samme mekanisme til at kontakte Bot Service bot.

Da Copilot Studio-chatbottens programregistrering nu er enkeltlejerarkitektur, fungerer denne kommunikation ikke længere. Microsoft Entra ID nægter at oprette tokens for programregistreringer med en enkelt tenant, der ikke er i den samme tenant.

Derudover validerer Copilot Studio det indgående token og afviser anmodninger fra lejere, som det ikke forventer, f.eks. det lejer-id, hvor den klassiske chatbots programregistrering blev oprettet.

For at løse dette problem skal du følge de retningslinjer, der gælder for din situation:

• Klassiske chatbots i samme tenant som Azure Bot Service-botten: I scenarier, hvor Copilot Studio-chatbotten allerede er implementeret i samme tenant som Bot Service-botten og kun bruges af denne bot, opdater Azure Bot Service-botten til en single-tenant-konfiguration, og genudrul den. Lær mere i Klargør og udgiv en bot.

• Copilot Studio-chatrobot, der ikke kan opdateres til enkelt lejer: I scenarier, hvor Copilot Studio-chatrobotten allerede er implementeret i samme lejer som Bot Service-robotten, og robotten ikke kan opdateres til enkelt lejer, skal du opdatere koden i Bot Service-robotten for at oprette token til kommunikation med Copilot Studio-chatrobotten. Tokenet skal oprettes for den lejer, hvor Copilot Studio-chatrotten også blev oprettet. Derudover skal svaret accepteres, hvilket sandsynligvis kræver, at du følger trinnene i Konvertere en eksisterende Azure Bot Service-færdighed fra multiprofil til en enkelt lejer.

Relaterede oplysninger

• Azure Bot Service oversigt over færdigheder
• Azure Bot Service-færdighedsmanifest
• Test en Azure Bot Service-skill i emulator