Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Note
Ten artykuł obejmuje tylko klasyczne czatboty. Ta funkcja nie jest dostępna dla agentów Copilot Studio opartych na standardzie ani na aparacie Microsoft Copilot.
Important
Ten artykuł zawiera informacje o umiejętnościach usługi Azure Bot Service, czyli opartym na kodzie sposobie rozszerzania możliwości agenta w standardowym zestawie. Azure Bot Service umiejętności różnią się od:
- Umiejętności agentów, czyli umiejętności oparte na instrukcjach, które dodajesz do agentów opartych na GitHub Copilot lub Customer Conversation harness. Dowiedz się więcej w przeglądzie umiejętności dla agentów.
- Umiejętności wtyczek, czyli funkcjonalność, którą wtyczka Microsoft 365 Copilot może zawierać. Dowiedz się więcej w artykule Umiejętności jako możliwości wtyczek.
Gdy używasz klasycznego chatbota jako umiejętności usługi Azure Bot Service w połączeniu z botem usługi Bot Service, bot usługi Bot Service sprawdza, czy wypowiedź użytkownika odpowiada frazom wyzwalającym klasycznego chatbota. Jeśli zostanie znalezione dopasowanie, bot Bot Service przekazuje rozmowę klasycznemu chatbotowi. Klasyczny chatbot wyodrębnia wszystkie encje i wyzwala pasujący temat.
Important
Aby korzystać z klasycznych chatbotów jako umiejętności usługi Azure Bot Service, musisz mieć licencję próbną lub pełną licencję Copilot Studio. Ta funkcja nie jest dostępna w planie Copilot Studio for Teams.
Aby skonfigurować klasycznego chatbota jako umiejętność usługi Azure Bot Service:
Dodaj bota Bot Service do listy dozwolonych dla klasycznego chatbota.
Pobierz manifest umiejętności Azure Bot Service dla klasycznego chatbota.
Połącz się z klasycznym chatbotem jako umiejętnością Azure Bot Service ze swojego bota Bot Service.
Sprawdź, czy klasyczny chatbot działa jako umiejętność usługi Azure Bot Service.
Prerequisites
- Zrozum, jak działają umiejętności usługi Azure Bot Service.
- Zdobądź identyfikator aplikacji swojego bota Bot Service.
Dodaj swojego bota Bot Service do listy dozwolonych dla klasycznego czatbota
Dodaj identyfikator aplikacji bota Bot Service do listy dozwolonych dla klasycznego czatbota, którego chcesz używać jako umiejętności. Boty muszą być w tym samym dzierżawcy.
Pobierz identyfikator aplikacji firmy Microsoft dla bota usługi Bot Services. Te informacje można znaleźć w portalu Azure lub w konfiguracjach bota.
W Copilot Studio otwórz klasycznego chatbota, którego chcesz używać jako umiejętności usługi Azure Bot Service.
Przejdź do Ustawień, wybierz Bezpieczeństwo, a następnie listę dozwolonych.
Wybierz Dodaj dozwolony obiekt wywołujący.
Wklej identyfikator aplikacji bota Bot Service, a następnie wybierz Dalej.
Caution
Klasyczny chatbot nie może działać jako umiejętność Azure Bot Service dla innych klasycznych chatbotów. Jeśli spróbujesz dodać identyfikator aplikacji należący do klasycznego chatbota do listy dozwolonych, pojawia się błąd. Identyfikator aplikacji można dodać tylko dla bota Bot Service.
Copilot Studio weryfikuje identyfikator aplikacji należący do bota usługi Bot Service i potwierdza, że należy on do bota w tej samej dzierżawie.
(Opcjonalnie) Dodaj nazwę wyświetlaną dla bota, którego dodałeś do listy zatwierdzonych.
Wybierz Zapisz.
Bot usługi Bot Service jest wyświetlany według swojej nazwy wyświetlanej, jeśli została wprowadzona, lub według identyfikatora aplikacji, jeśli nazwa wyświetlana nie została wprowadzona. Aby w dowolnym momencie usunąć lub edytować bota, wybierz ikonę obok nazwy wyświetlanej bota lub identyfikatora aplikacji.
Note
Boty Bot Service dodane do listy dozwolonych nie są eksportowane jako część zawartości bota .
Pobierz manifest umiejętności Azure Bot Service dla swojego klasycznego chatbota
Wszystkie klasyczne chatboty mają manifesty umiejętności usługi Azure Bot Service. Manifest umiejetności to pliki JSON zawierające nazwę umiejętności, interfejs i frazy wyzwalające. Bot Service boty mogą wykorzystać manifest umiejętności Azure Bot Service z klasycznego chatbota w Copilot Studio do konfiguracji połączenia z klasycznym chatbotem, który wygenerował manifest.
Bot usługi Bot Service używa manifestu umiejętności usługi Azure Bot Service, aby wiedzieć, kiedy uruchomić klasycznego chatbota (na przykład w odpowiedzi na coś, co mówi użytkownik).
Manifesty umiejętności bota usługi Azure Bot Service dla klasycznych chatbotów są zgodne z wersją 2.2 schematu manifestu umiejętności usługi Bot Service i składają się z plików intents.lu i manifest.json.
Na podstawie danych manifestu bot Bot Service może zdecydować, że klasyczny czatbot powinien obsługiwać żądanie użytkownika. Bot przekazuje wszystko, co użytkownik powiedział, do chatbota. Następnie chatbot dopasowuje to, co użytkownik powiedział, do tematu, wyodrębnia wszystkie jednostki potrzebne do wypełnienia slotu i uruchamia temat.
Copilot Studio automatycznie generuje i aktualizuje Azure Bot Service manifesty umiejętności. Klasyczny chatbot ma dwa manifesty:
Manifest testowy: Pozwala botowi Bot Service połączyć się z testową wersją klasycznego chatbota. Użyj manifestu testowego, aby zweryfikować zmiany w swoich umiejętnościach przed opublikowaniem.
- Manifest testowy jest natychmiast dostępny dla każdego nowo utworzonego klasycznego bota.
- Jest automatycznie aktualizowany, aby odzwierciedlać zmiany za każdym razem, gdy zapisujesz swój klasyczny chatbot.
Opublikowany manifest: Pozwala botowi Bot Service połączyć się z opublikowaną wersją klasycznego chatbota.
- Opublikowany manifest jest dostępny tylko dla klasycznych chatbotów, które zostały opublikowane przynajmniej raz.
- Jest automatycznie aktualizowany, aby odzwierciedlać zmiany za każdym razem, gdy publikujesz swojego klasycznego chatbota.
Oba manifesty umiejętności pojawiają się na panelu Zarządzaj listą dozwolonych .
Manifesty umiejętności pojawiają się także na stronie Szczegóły chatbota. Przejdź do Ustawień, a następnie wybierz Szczegóły. Strona Szczegóły pokazuje inne metadane, w tym Environment ID, Tenant ID oraz Bot app ID.
Aby pobrać manifest, wybierz go. Spowoduje to pobranie go jako pliku ZIP z etykietą <bot name >manifest w przypadku Opublikowany manifest lub <bot name>test__manifest w przypadku manifestu testowego.
Note
Manifest umiejętności nie zawiera tematów systemowych. Uwzględnione są tylko tematy tworzone przez autorów chatbotów oraz wyzwalacze intencji dodawane do bota.
Połącz klasyczny chatbot jako umiejętność Azure Bot Service ze swoim botem
Wykorzystaj informacje z manifestu umiejętności Azure Bot Service, aby utworzyć połączenie umiejętności w swoim Bot Service bot.
Dowiedz się więcej o strukturze manifestu umiejętności Azure Bot Service w manifest umiejętności Azure Bot Service.
Sekcja aktywności w Azure Bot Service manifestie umiejętności zawiera tematy dostępne w klasycznym chatbocie.
Możesz zaimplementować konsumenta umiejętności Azure Bot Service w swoim bocie Bot Service, aby wywołać klasycznego chatbota jako umiejętność Azure Bot Service.
Testuj swój klasyczny chatbot jako umiejętność usługi Azure Bot Service przy użyciu bota usługi Bot Service
Użyj Bot Service Emulator, aby sprawdzić, czy twój bot Bot Service poprawnie wywołuje klasycznego chatbota jako umiejętność usługi Azure Bot Service.
Important
Musisz dodać swojego bota usługi botów do listy dozwolonych dla klasycznego czatbota, aby połączenie umiejętności działało.
Aktualizowanie multitenantowego bota Bot Service na bota dedykowanego jednej dzierżawie
Poniższa ilustracja pokazuje sytuację, w której bot Bot Service wywołuje klasycznego chatbota, aby wykorzystać go jako umiejętność Azure Bot Service.
Zarówno bot usługi Bot Service, jak i klasyczny czatbot mają rejestrację aplikacji Microsoft Entra ID, na którą powołują się wystąpienia Azure Bot. Rejestracje aplikacji (App Registracje) Microsoft Entra ID są tworzone jako multitenant. Bot Service żąda tokenu od dzierżawcy Bot Service i używa go do uwierzytelnienia dla Copilot Studio za pomocą usługi Azure Bot Service. Copilot Studio używa tego samego mechanizmu, aby skontaktować się z botem Bot Service.
Ponieważ rejestracja aplikacji czatbota w Copilot Studio jest teraz jednolokatorska, ta komunikacja już nie działa. Microsoft Entra ID odmawia tworzenia tokenów dla rejestracji aplikacji jednodzierżawowych, które nie znajdują się w tej samej dzierżawie.
Ponadto program Copilot Studio weryfikuje token przychodzący i odrzuca żądania od dzierżaw, których nie oczekuje, na przykład identyfikator dzierżawy, w którym utworzono rejestrację aplikacji klasycznego czatbota.
Aby rozwiązać ten problem, postępuj zgodnie z wytycznymi dotyczącymi Twojej sytuacji:
Klasyczne chatboty w tym samym tenantzie co bot Azure Bot Service: W sytuacjach, gdy chatbot Copilot Studio jest już wdrożony w tym samym tenantzie co bot Bot Service i używany tylko przez tego bota, zaktualizuj bota Azure Bot Service do konfiguracji dla jednego tenanta, a następnie wdroż ponownie. Dowiedz się więcej w Aprowizowanie i publikowanie bota.
Copilot Studio chatbot, którego nie można zaktualizować do single-tenant: W sytuacjach, gdy chatbot Copilot Studio jest już wdrożony w tym samym tenantze co bot Bot Service, ale nie można go zaktualizować do single-tenant, zaktualizuj kod w bocie Bot Service, aby utworzyć token do komunikacji z chatbotem Copilot Studio. Token należy utworzyć dla dzierżawy, w której został również utworzony czatbot Copilot Studio. Dodatkowo odpowiedź musi zostać zaakceptowana, co prawdopodobnie wymaga wykonania kroków w sekcji Przekształcanie istniejącej umiejętności usługi Azure Bot Service z modelu wielodostępnego na model z jedną dzierżawą.