Używanie klasycznego czatbota jako umiejętności bota usługi Bot Service

Jeśli używasz klasycznego czatbota jako umiejętności bota usługi Bot Service, bot usługi Bot Service określa, czy coś, co użytkownik mówi, pasuje do fraz wyzwalacza klasycznego czatbota. Jeśli istnieje dopasowanie, bot usługi Bot Service może przekazać konwersację do klasycznego czatbota. Bot usługi wyodrębnia wszystkie encje i wyzwala pasujący temat.

Aby skonfigurować czatbora jako umiejętność:

1. Dodaj bota usługi Bot Service do listy dozwolonych dla klasycznego czatbota.

2. Pobierz manifest umiejętności dla bota.

3. Połącz się z umiejętnością copilot Studio z bota.

4. Upewnij się, że bot działa jako umiejętność.

Wymagania wstępne

• Dowiedz się, jak działają umiejętności usługi Bot Service.
• Pobierz identyfikator aplikacji bota usługi Bot Service.

Dodawanie bota usługi Bot Service do listy dozwolonych dla klasycznego czatbota

Dodaj identyfikator aplikacji bota usługi Bot Service do listy dozwolonych dla klasycznego czatbota, którego chcesz użyć jako umiejętności. Boty muszą być wdrożone w tej samej dzierżawie.

1. Pobierz identyfikator aplikacji firmy Microsoft dla bota usługi Bot Services. Te informacje można znaleźć w witrynie Azure Portal lub w konfiguracjach bota.

2. W programie Copilot Studio otwórz okno bota, który ma być użyty jako umiejętności.

3. W menu nawigacyjnym przejdź do Ustawienia, a następnie wybierz pozycję Zabezpieczenia. Następnie wybierz Lista dozwolonych.

4. Wybierz Dodaj dozwolony obiekt wywołujący.

5. Wklej identyfikator aplikacji bota usługi Bot Service i wybierz pozycję Dalej.

   Uwaga

   Klasyczny czatbot nie może działać jako umiejętność dla innych klasycznych chatbotów. Jeśli spróbujesz dodać do listy dozwolonych identyfikator aplikacji należący do bota Power Virtual Agent, zobaczysz błąd. Dla bota bota można dodać tylko identyfikator aplikacji.

   Copilot Studio weryfikuje identyfikator aplikacji bota usługi Bot Service i potwierdza, że należy do bota w tej samej dzierżawie.

6. (Opcjonalnie) Możesz dodać Nazwę wyświetlaną dla listy dozwolonych.

7. Wybierz pozycję Zapisz.

Bot usługi Bot Service jest wyświetlany według jego nazwy wyświetlanej, jeśli został wprowadzony, lub według jego identyfikatora aplikacji, jeśli nie wprowadzono nazwy wyświetlanej. Aby w dowolnym momencie usunąć lub edytować tę ikonę, wybierz ikonę po prawej stronie identyfikatora nazwy wyświetlanej aplikacji.

Pobierz manifest umiejętności dla bota

Boty usługi Bot Service mogą używać manifestu umiejętności Copilot Studio w celu skonfigurowania połączenia z klasycznym czatbotem, który wyprodukował manifest.

Wszystkie klasyczne chatboty mają manifesty umiejętności. Manifest umiejetności to pliki JSON zawierające nazwę umiejętności, interfejs i frazy wyzwalające.

Bot usługi Bot Service może użyć manifestu umiejętności, aby wiedzieć, kiedy wyzwolić klasycznego czatbota (na przykład w odpowiedzi na coś, co użytkownik mu mówi).

Manifesty umiejętności Copilot Studio są zgodne ze schematem manifestu umiejętności usługi Bot Service w wersji 2.2 i składają się z plików intents.lu i manifest.json .

Bot usługi Bot Service może zdecydować, że klasyczny czatbot powinien obsługiwać żądanie użytkownika na podstawie danych manifestu. Przekazuje wszystko, co użytkownik powiedział do klasycznego czatbota. Następnie bot dopasowuje tę wypowiedź użytkownika do tematu Copilot Studio, wyodrębnia wszystkie elementy potrzebne do wypełnienia miejsca i wywołuje temat Copilot Studio.

Manifesty umiejętności Copilot Studio są generowane i aktualizowane automatycznie. Bot klasyczny ma dwa manifesty umiejętności:

• Manifest testu: umożliwia botowi usługi Bot Service nawiązanie połączenia z testową wersją klasycznego czatbota. 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 bota .
  • Jest ona automatycznie aktualizowana w celu odzwierciedlenia zmian przy każdym zapisaniu bota.

• Opublikowany manifest: umożliwia botowi usługi Bot Service nawiązanie połączenia z opublikowaną wersją klasycznego czatbota.

  • Opublikowany manifest jest dostępny tylko dla botów, które zostały opublikowane przynajmniej raz.
  • Jest ona automatycznie aktualizowana w celu odzwierciedlenia zmian przy każdym publikowaniu agenta.

Oba panele umiejętności są ukazane w panelu Zarządzanie listą zezwalań.

Manifesty umiejętności są również widoczne na stronie Szczegóły chatbota. W menu nawigacyjnym wybierz Ustawienia, a następnie wybierz Szczegóły. Na stronie Szczegóły są widać inne metadane, takie jak Identyfikator środowiska, Identyfikator dzierżawy i Identyfikator aplikacji bota.

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.

Nawiązywanie połączenia z umiejętnością copilot Studio z bota

Możesz użyć informacji z manifestu umiejętności copilot Studio, aby utworzyć połączenie umiejętności w bota usługi Bot Service.

Aby dowiedzieć się więcej o strukturze manifestu umiejętności, zobacz Manifest umiejętności.

Sekcja działań manifestu umiejętności zawiera tematy, które są dostępne w klasycznym czatbotze.

Możesz zaimplementować użytkownika umiejętności w bota usługi Bot Service, aby wywołać klasycznego czatbota jako umiejętności.

Przetestuj klasycznego czatbota jako umiejętności za pomocą bota usługi Bot Service

Możesz uruchomić emulator usługi Bot Service , aby przetestować, czy bot usługi Bot Service prawidłowo wywołuje klasycznego czatbota jako umiejętności.

Aktualizowanie wielodostępnego bota usługi Bot Service do bota z jedną dzierżawą

Na poniższej ilustracji przedstawiono scenariusz, w którym bot usługi Bot Service wywołuje klasycznego czatbota, aby użyć go jako umiejętności.

Zarówno bot usługi Bot Service, jak i klasyczny czatbot mają rejestrację aplikacji Microsoft Entra ID, do której odwołuje się wystąpienie bota platformy Azure. Te rejestracje aplikacji z identyfikatorem Microsoft Entra zostały utworzone jako wielomandatowe. Bot usługi Bot Service żąda tokenu z dzierżawy usługi Bot Service i używa tego tokenu do uwierzytelniania w aplikacji Copilot Studio przy użyciu usługi Azure Bot Service. Copilot Studio używa tego samego mechanizmu, aby skontaktować się z botem usługi Bot Service.

Rejestracja aplikacji Copilot Studio czatbot jest teraz tworzona jako pojedyncza dzierżawa, więc ta komunikacja już nie działa. Microsoft Entra Identyfikator odmawia tworzenia tokenów dla rejestracji aplikacji z jedną dzierżawą, które nie znajdują się w tej samej dzierżawie.

Ponadto, Copilot Studio weryfikuje token przychodzący i odrzuca żądania od dzierżaw, których się nie spodziewa, takich jak identyfikator dzierżawy, w którym została utworzona rejestracja aplikacji klasycznej czatbot.

Aby rozwiązać ten problem, istnieją dwie możliwe poprawki.

Klasyczne czatboty w tej samej dzierżawie co bot usługi Bot Service

W scenariuszach, w których czatbot Copilot Studio jest już wdrożony w tej samej dzierżawie co bot usługi Bot Service i jest używany tylko przez tego bota, zaktualizuj bota do konfiguracji z jedną dzierżawą, a następnie ponownie wdróż bota usługi Bot Service. Aby uzyskać więcej informacji na temat konfigurowania bota usługi Bot Service dla pojedynczej dzierżawy, zobacz Aprowizuj i opublikuj bota.

Copilot Studio czatbot, którego nie można zaktualizować do jednej dzierżawy

W scenariuszach, w których czatbot Copilot Studio został już wdrożony w tej samej dzierżawie co bot usługi Bot Service, ale bot nie może zostać zaktualizowany tak z jedną dzierżawą, należy zaktualizować kod bota usługi Bot Service, aby utworzyć token do komunikacji z czatbotem Copilot Studio. Token należy utworzyć dla dzierżawy, w której Copilot Studio czatbot również został utworzony. Ponadto odpowiedź musi zostać zaakceptowana, co prawdopodobnie wymaga wykonania kroków opisanych w temacie Konwertowanie istniejącej umiejętności z wielodostępnej na jednodostępną.

Dowiedz się więcej

• Omówienie umiejętności
• Manifest umiejętności
• Sprawdź umiejętność w emulatorze