Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Anmärkning
Den här artikeln gäller endast klassiska chattbottar. Den här funktionen är inte tillgänglig för Copilot Studio-agenter.
När du använder en klassisk chattrobot som en skill med en Bot Service robot, avgör Bot Service roboten om något som användaren säger matchar den klassiska chattrobotens triggerfraser. Om det finns en matchning kan Bot Service robot skicka konversationen till den klassiska chattroboten. Den klassiska chattroboten extraherar eventuella entiteter samt utlöser matchande ämne.
Important
Om du vill använda klassiska chattrobotar som kunskaper måste du ha en trial eller fullständig Copilot Studio-licens. Den här funktionen är inte tillgänglig med Copilot Studio för Teams-planen.
Så här konfigurerar du en klassisk chattrobot som en färdighet:
Lägg till Bot Service-boten i tillåtlistan för den klassiska chattroboten.
Ladda ned färdighetsmanifestet för den klassiska chattroboten.
Förutsättningar
Lägg till din bot från Bot Service i den tillåtna listan för din klassiska chattbot
Lägg till Bot Service-botens app-ID i tillåtlistan för den klassiska chatbot som du vill använda som en färdighet. Botarna måste vara i samma klientorganisation.
Hämta Microsofts app-ID för din Bot Services-robot. Du hittar den här informationen i Azure-portalen eller i robotkonfigurationerna.
I Copilot Studio öppnar du den klassiska chattroboten som du vill använda som en färdighet.
Gå till Inställningar, välj Säkerhet och välj sedan Tillåten lista.
Välj Lägg till tillåten uppringare.
Klistra in Bot Service robotens app-ID och välj Nästa.
Försiktighet
En klassisk chattrobot kan inte fungera som en funktion för andra klassiska chattrobotar. Om du försöker lägga till ett app-ID som tillhör en klassisk chatbot i tillåtslistan får du ett felmeddelande. Du kan bara lägga till ett app-ID för en Bot Service robot.
Copilot Studio verifierar Bot Service robotens app-ID och bekräftar att den tillhör en robot i samma klientorganisation.
(Valfritt) Lägg till ett visningsnamn för boten du lagt till i tillåtningslistan.
Välj Spara.
Bot Service-boten visas med sitt visningsnamn om du har angett ett, eller med sitt app-ID om du inte har. Om du vill ta bort eller redigera den när som helst markerar du ikonen till höger om ikonens visningsnamn eller app-ID.
Anmärkning
Bot Service-bottar som läggs till i den tillåtna listan exporteras inte som en del av botens innehåll.
Ladda ner färdighetsmanifestet för din klassiska chatbot
Bot Service robotar kan använda ett Copilot Studio-kunskapsmanifest för att konfigurera en anslutning till den klassiska chattroboten som skapade manifestet.
Alla klassiska chattrobotar har färdighetsmanifest. Ett färdighetsmanifest är en JSON-fil som innehåller färdighetens namn, gränssnitt och utlösande fraser.
En Bot Service robot använder ett kunskapsmanifest för att veta när den klassiska chattroboten ska utlösas (till exempel som svar på något som en användare säger).
Copilot Studio-färdighetsmanifest följer version 2.2 i Bot Service schema för färdighetsmanifest och består av intents.lu och manifest.json filer.
Baserat på manifestdata kan en Bot Service robot besluta att en klassisk chattrobot ska hantera användarens begäran. Boten vidarebefordrar allt användaren sagt till chatboten. Sedan matchar chatbotten vad användaren sagt till ett ämne, extraherar eventuella entiteter som behövs för att fylla luckor och aktiverar ämnet.
Copilot Studio genererar och uppdaterar kunskapsmanifest automatiskt. En klassisk chattrobot har två färdighetsmanifest:
Test manifest: Tillåter att Bot Service robot ansluter till testversionen av den klassiska chattroboten. Använd testmanifest för att verifiera ändringar i din färdighet innan du publicerar den.
- Testmanifest är omedelbart tillgängligt för alla nyskapade klassiska chattrobotar.
- Den uppdateras automatiskt för att spegla förändringar varje gång du sparar din klassiska chatbot.
Publicerat manifest: Tillåter att roboten Bot Service ansluter till den publicerade versionen av den klassiska chattroboten.
- Det publicerade manifestet är endast tillgängligt för klassiska chattrobotar som har publicerats minst en gång.
- Den uppdateras automatiskt för att spegla förändringar varje gång du publicerar din klassiska chattbot.
Båda färdighetsmanifesten visas på panelen Hantera tillåtslistan.
Färdighetsmanifesten visas också på chattbotens Detaljer-sida . Gå till Inställningar och välj sedan Detaljer. Sidan Detaljer visar annan metadata, inklusive miljö-ID, hyresgäst-ID och bot-app-ID.
Välj ett manifest om du vill hämta det. En .zip-fil kallad _<robotnamn>_manifest för Publicerat manifest, eller <robotnamn>test__manifest för Testmanifest laddas ned.
Anmärkning
Kunskapsmanifestet innehåller inte systemämnen. Endast ämnen som författare av chatbots skapar och avsiktliga triggers som författare lägger till i chatboten inkluderas.
Anslut till en Copilot Studio-färdighet från din bot
Använd informationen från ditt Copilot Studio-kunskapsmanifest för att skapa en kompetensanslutning i din Bot Service robot.
För mer information om färdighetsmanifestets struktur, se Färdighetsmanifest.
Avsnittet aktiviteter i kunskapsmanifestet innehåller de ämnen som är tillgängliga i din klassiska chattrobot.
Du kan implementera en kompetenskonsument i din Bot Service-bot för att anropa en klassisk chattrobot som en funktion.
Testa din klassiska chattrobot som en färdighet med en Bot Service robot
Använd Bot Service Emulator för att testa att din Bot Service-robot korrekt anropar en klassisk chattrobot som en färdighet.
Important
Du måste lägga till din Bot Service-bot i den klassiska chattrobotens tillåtelselista för att anslutningen ska fungera.
Uppdatera en flertenant Bot Service-robot till en enkeltenant-robot
Följande bild visar scenariot där en Bot Service robot anropar en klassisk chattrobot för att använda den som en färdighet.
Både Bot Service-boten och den klassiska chattroboten har en Microsoft Entra ID app-registrering, som Azure Bot-instansen refererar till. Du skapar dessa Microsoft Entra ID app-registreringar som fleranvändarlösningar. Bot Service-roboten begär en token från klientorganisationen Bot Service och använder denna token för att autentisera sig mot Copilot Studio genom Azure Bot Service. Copilot Studio använder samma mekanism för att kontakta Bot Service roboten.
Eftersom Copilot Studio-chattrobotens applikationsregistrering nu är single-tenant fungerar inte längre den här kommunikationen. Microsoft Entra ID vägrar att skapa token för programregistreringar som inte är i samma klientorganisation.
Dessutom validerar Copilot Studio den inkommande token och avvisar begäranden från klienter som den inte förväntar sig, till exempel det klient-ID där den klassiska chattrobotens programregistrering skapades.
För att lösa detta problem, följ de riktlinjer som gäller för din situation:
Klassiska chattrobotar i samma klientorganisation som den Bot Service roboten – I scenarier där chattroboten Copilot Studio redan har distribuerats i samma klientorganisation som Bot Service roboten och endast används av den här roboten uppdaterar du roboten till en konfiguration med en enda klientorganisation och distribuerar sedan om din Bot Service robot. Mer information om hur du konfigurerar en Bot Service robot för en enskild klient finns i Provision och publicera en robot.
Copilot Studio-chattrobot som inte kan uppdateras till en enda klientorganisation – I scenarier där chattroboten Copilot Studio redan har distribuerats i samma klientorganisation som Bot Service roboten, men roboten inte kan uppdateras till en enda klientorganisation, uppdaterar du koden i Bot Service-roboten för att skapa token för att kommunicera med Copilot Studio chatbot. Tokenen måste skapas till den klientorganisation där även Copilot Studio chattbotten skapades. Dessutom måste svaret accepteras, vilket förmodligen kräver att du följer stegen i Konvertera en befintlig kompetens från multitenant till single-tenant.