Brug en klassisk chatrobot som en færdighed i en Bot Service bot

Når du bruger en klassisk chatbot som en skill med en Bot Service bot, bestemmer Bot Service bot, om noget, som brugeren siger, stemmer overens med den klassiske chatbots trigger-sætninger. Hvis der er et match, kan Bot Service bot overføre samtalen til den klassiske chatbot. Den klassiske chatrobot udtrækker alle objekter og udløser det tilsvarende emne.

Sådan konfigurerer du den klassiske chatrobot som en færdighed:

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

2. Download færdighedsmanifestet for den klassiske chatrobot.

3. Opret forbindelse til en Copilot Studio-færdighed fra din robot.

4. Bekræft, at robotten fungerer som en færdighed.

Forudsætninger

• Forstå, hvordan Bot-tjenestens færdigheder fungerer.
• Hent app-id'et for din Bot Service bot.

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 chatrobot, du vil bruge som en færdighed.

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 chatrobot kan ikke fungere som en færdighed for andre klassiske chatrobotter. 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 Save.

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

Download færdighedsmanifestet til din klassiske chatbot

Bot Service robotter kan bruge et Copilot Studio-kompetencemanifest til at konfigurere en forbindelse til den klassiske chatrobot, der producerede manifestet.

Alle klassiske chatrobotter har færdighedsmanifester. Et færdighedsmanifest er en JSON-fil, der indeholder færdighedens navn, grænseflade og udløserfraser.

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

Copilot Studio-kvalifikationsmanifester følger version 2.2 af skemaet til Bot Service kvalifikationsmanifest og består af filer 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 kompetencemanifester. Den klassiske chatrobot har to færdighedsmanifester:

• 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 Copilot Studio-færdighed fra din robot

Brug oplysningerne fra dit Copilot Studio-kompetencemanifest til at oprette en kompetenceforbindelse i din Bot Service bot.

For mere information om strukturen af færdighedsmanifestet, se Færdighedsmanifest.

Aktivitetsafsnittet i kompetencemanifestet indeholder de emner, der er tilgængelige i din klassiske chatbot.

Du kan implementere en færdighedsforbruger i din Bot Service bot til at kalde en klassisk chatrobot som en færdighed.

Test din klassiske chatrobot som en færdighed med en Bot Service bot

Brug Bot Service Emulator til at teste, at din Bot Service bot korrekt anvender en klassisk chatbot som en funktion.

Opdater en multitenant Bot Service-robot til en enkeltlejer-robot

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

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 en enkeltlejerinstallation, kan denne kommunikation ikke længere bruges. 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 den samme lejer som Bot Service bot – I scenarier, hvor chatrotten Copilot Studio allerede er udrullet i den samme lejer som Bot Service bot og kun bruges af denne robot, skal du opdatere robotten til en konfiguration med en enkelt lejer og derefter geninstallere din Bot Service bot. Du kan få flere oplysninger om, hvordan du konfigurerer en Bot Service bot til en enkelt lejer, i Provision og publicere en bot.

• Copilot Studio-chatrobot, der ikke kan opdateres til en enkelt lejer – I scenarier, hvor Copilot Studio-chatrotten allerede er installeret i den samme lejer som Bot Service bot, men robotten ikke kan opdateres til en enkelt lejer, skal du opdatere koden i Bot Service bot for at oprette tokenet for at kommunikere med Copilot Studio chatbot. 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 færdighed fra multiprofil til en enkelt lejer.

Relaterede oplysninger

• Oversigt over færdigheder
• Færdighedsmanifest
• Teste en færdighed i Emulator