Używanie klasycznego czatbota jako umiejętności w bocie Bot Framework

Artykuł
12/09/2024

Uwaga

Ten artykuł zawiera informacje dotyczące Copilot Studio tylko klasycznych chatbotów. Ta funkcja nie jest dostępna w nowym Copilot Studio środowisku.

Kiedy używasz klasycznego chatbota jako umiejętności Bot Framework z botem, bot określa, czy wszystko, co mówi użytkownik, Bot Framework pasuje do fraz wyzwalających klasycznego chatbota. Jeśli istnieje dopasowanie, Bot Framework bot przekazuje rozmowę do klasycznego chatbota. Klasyczny chatbot wyodrębnia dowolne encje i uruchamia pasujący temat.

Możesz również przekazać zmienną do a Copilot Studio umiejętność temat jako dane wejściowe z Bot Framework Composera i użyć zwracanych przez nią danych wyjściowych.

Ważne

Musisz mieć wersję próbną lub pełną Copilot Studio licencję, aby używać klasycznych chatbotów jako umiejętności. Ta funkcja nie jest dostępna w przypadku licencji Copilot Studio usługi Teams.

Aby skonfigurować klasycznego chatbota jako umiejętność:

Bot Framework Dodaj bota do listy dozwolonych dla klasycznego chatbota.
Pobierz manifest umiejętności dla klasycznego czatbota.
Użyj pobranego manifestu umiejętności w Bot Framework aplikacji Composer, aby utworzyć połączenie między botami.
Użyj emulatora Bot Framework , aby potwierdzić, że bot działa jako umiejętność.

Wymagania wstępne

Dodaj swojego Bot Framework bota do listy dozwolonych dla klasycznego chatbota

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

W Bot Framework Composer otwórz okno, które będzie używać umiejętności. Wybierz opcję Skonfiguruj, a następnie wybierz Zasoby projektowania. Skopiuj identyfikator za pomocą Identyfikatora aplikacji Microsoft.
Otwórz Copilot Studio klasycznego chatbota, którego chcesz używać jako umiejętności.
W menu nawigacyjnym przejdź do Ustawienia, a następnie wybierz pozycję Zabezpieczenia. Następnie wybierz Lista dozwolonych.
Wybierz Dodaj dozwolony obiekt wywołujący.
Wklej Bot Framework identyfikator aplikacji i wybierz przycisk Dalej.

Uwaga

Klasyczny chatbot 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. Możesz dodać tylko identyfikator aplikacji dla bota Bot Framework.

Copilot Studio weryfikuje Bot Framework identyfikator aplikacji bota i potwierdza, że należy on do bota w tej samej dzierżawie.
(Opcjonalnie) Możesz dodać Nazwę wyświetlaną dla listy dozwolonych.
Wybierz pozycję Zapisz.

Bot Bot Framework jest wyświetlany za pomocą swojej nazwy wyświetlanej, jeśli został wprowadzony, lub przez identyfikator 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.

Uwaga

Boty Bot Framework dodane do listy dozwolonych nie są eksportowane jako część zawartości bota.

Pobierz klasyczny manifest umiejętności chatbota dla swojego klasycznego chatbota

Bot Framework Boty mogą używać Copilot Studio manifestu umiejętności do konfigurowania połączenia z klasycznym chatbotem, który wygenerował manifest.

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

Abot Bot Framework może użyć manifestu umiejętności, aby wiedzieć, kiedy uruchomić klasycznego chatbota (na przykład w odpowiedzi na coś, co mówi do niego użytkownik).

Copilot Studio umiejętność manifesty są zgodne z Bot Framework wersją 2.2 umiejętność schematu manifestu i składają się z plików intents.lu i manifest.json .

Abot Bot Framework może zdecydować, że klasyczny chatbot powinien obsłużyć żądanie użytkownika, na podstawie danych manifestu. Przekazuje klasycznemu chatbotowi wszystko, co powiedział użytkownik. Następnie klasyczny chatbot dopasowuje to, co użytkownik powiedział do Copilot Studio tematu, wyodrębnia wszelkie jednostki potrzebne do wypełnienia slotu i uruchamia Copilot Studio temat.

Copilot Studio Manifesty umiejętności są generowane i aktualizowane automatycznie. Klasyczny chatbot ma dwie manifestacje umiejętności:

Manifest testowy: umożliwia Bot Framework botowi 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 klasycznego chatbota.
- Jest on automatycznie aktualizowany, aby odzwierciedlić zmiany za każdym razem, gdy zapiszesz klasycznego chatbota.
Opublikowany manifest: umożliwia Bot Framework botowi łączenie się z opublikowaną wersją klasycznego czatbota.
- Opublikowany manifest jest dostępny tylko dla klasycznych czatbotów, które zostały opublikowane co najmniej raz.
- Jest on automatycznie aktualizowany, aby odzwierciedlić zmiany za każdym razem, gdy publikujesz swój agent.

Notatka

Opublikowany manifest nie jest dostępny dla klasycznych czatbotów, które nigdy nie zostały opublikowane.

Aby wygenerować opublikowany manifest bota,opublikuj klasycznego czatbota.

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

Manifesty umiejętności są także wyświetlane na stronie Szczegóły pomocnika. 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. Jest on pobierany jako plik .zip oznaczony etykietą manifestu nazwy _<bot> dla opublikowanego manifestu lub < bot nazwę>test__manifest dla manifestu testowego.

Notatka

Manifest umiejętności nie zawiera tematów systemowych i okien dialogowych kompozytora, które są dodawane do klasycznego chatbota. Uwzględniane są tylko tematy utworzone przez autorów pomocnika i wyzwalacze zamiaru Composer, które tworzą uwzględnione dodatki do bota.

Nawiązywanie połączenia z umiejętnością Copilot Studio w aplikacji Composer

Użyj Copilot Studio umiejętność manifestów, aby utworzyć połączenie umiejętność w bot Bot Framework w Composerze.

W projekcie Bot Framework Composer wybierz opcję Dodaj, a następnie wybierz Połącz z umiejętnością.
Przejdź do manifestu .zip archiwum i wybierz go, a Copilot Studio następnie wybierz przycisk Dalej.
Wybierz tematy lub intencje w klasycznym czatbocie, który chcesz dodać do swojego Bot Framework bota, a następnie wybierz przycisk Dalej.
Przejrzyj i edytuj frazy wyzwalające klasycznego czatbota, a następnie wybierz pozycję Dalej.
Upewnij się , że jest zaznaczone użycie przycisku Użyj plików Plików do wielu projektów, a następnie wybierz opcję Kontynuuj.
Sprawdź, czy Copilot Studio umiejętność została poprawnie dodana do Twojego Bot Framework bota i czy nowy wyzwalacz z nazwą klasycznego chatbota pojawia się w projekcie w Composerze.

Znajdowanie tematu w manifeście umiejętności

Użyj zdarzenia, aby wyzwolić Copilot Studio temat w umiejętności. Aby wywołać określony temat z aplikacji Composer, odwołaj się do nazwy powiązanego zdarzenia w manifeście umiejętności.

Wybierz akcję Połącz z umiejętnością.
W obszarze Nazwa sesji dialogowej umiejętności wybierz pozycję Wyświetl manifest umiejętności.
Znajdowanie działań w manifeście. Ta właściwość zawiera zagnieżdżone właściwości, które reprezentują tematy dostępne w klasycznym czatbocie.
Znajdź temat, do której chcesz wywołać i sprawdzić właściwość jego nazwy. Copilot Studio Gdy umiejętność otrzyma zdarzenie o tej nazwie, wyzwala temat.

W tym przykładzie nazwa działania zdarzenia to dispatchTo_new_topic_87609dabd86049f7bc6507c6f7263aba_33d.

Zadzwoń a Copilot Studio umiejętność temat

Zamiast polegać na tym, co mówi użytkownik, aby wyzwolić umiejętność temat, możesz wywołać go bezpośrednio Copilot Studio . Można wywoływać Copilot Studio tylko tematy wymienione w manifeście umiejętności.

Na kanwie tworzenia Composer wybierz opcję Dodaj, a następnie wybierz opcję Dostęp do zasobów zewnętrznych, a następnie wybierz opcję Połącz z umiejętnością.
Na liście Nazwa okna dialogowego umiejętności wybierz klasycznego chatbota.
Znajdź nazwę działania wydarzenia dla klasycznego tematu czatbota, do którego chcesz zadzwonić. Skopiuj wartość, pomiń cudzysłowy i zapisz ją w celu użycia w następnych krokach.
Wybierz Zamknij.
W obszarze Działanie wybierz Pokaż kod.
Wpisz lub wklej następujący kod. Zastąp element TOPIC_ACTIVITY_NAME nazwą działania zdarzenia dla tematu. Upewnij się, że we właściwości name nie ma cudzysłowów.
```
[Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]
```

Przekaż zmienną wejściową do a Copilot Studio umiejętność temat

Bot Framework Composer może przekazać zmienną do a Copilot Studio umiejętność temat jako dane wejściowe. Aby dowiedzieć się, jak tworzyć Copilot Studio tematy akceptujące zmienne wejściowe, zobacz Praca ze zmiennymi.

Copilot Studio Jeśli temat, który może otrzymać zmienną wejściową, jest wymieniony w manifeście umiejętności, możesz przekazać do niego zmienną Composer.

Na kanwie tworzenia Composer wybierz opcję Dodaj, a następnie wybierz opcję Dostęp do zasobów zewnętrznych, a następnie wybierz opcję Połącz z umiejętnością.
Na liście Nazwa okna dialogowego umiejętności wybierz klasycznego chatbota.
Znajdź nazwę działania wydarzenia dla klasycznego tematu czatbota, do którego chcesz zadzwonić. Skopiuj wartość, pomiń cudzysłowy i zapisz ją w celu użycia w następnych krokach.
Znajdź właściwość value tematu. Właściwość value zawiera właściwość $ref. Skopiuj tę wartość (bez cudzysłowów) i zapisz ją w następnym kroku.

Ostrzeżenie

Copilot Studio Jeśli temat nie ma danych wejściowych, nie będzie miał właściwości value .
Znajdź właściwość definitions, a następnie wyszukaj zagnieżdżoną właściwość odpowiadającą wartości $ref znalezioną w poprzednim kroku. Zwróć uwagę na nazwy i typy Copilot Studio danych wejściowych tematu. Użyjesz ich w następnych krokach.
Wybierz Zamknij.
W obszarze Działanie wybierz Pokaż kod.
Wpisz lub wklej następujący kod. Zastępuje te wartości:
1. Zastąp element TOPIC_ACTIVITY_NAME nazwą działania zdarzenia dla tematu.
2. Zastąp element PVA_INPUT_VARIABLE zmienną wejściową z tematu.
3. Zastąp element COMPOSER_INPUT_VARIABLE zmienną aplikacji Composer, która określi wartość.
```
[Activity
    Type = event
    Name = TOPIC_ACTIVITY_NAME
    Value = ${addProperty(json("{}"), 'PVA_INPUT_VARIABLE', COMPOSER_INPUT_VARIABLE)}
]
```
W tym przykładzie zmienna dialog.storeLocation Composer dostarcza wartość zmiennej pva_StoreLocation wejściowej w klasycznym temacie dispatchTo_new_topic_127cdcdbbb4a480ea113c5101f309089_21a34f16 chatbota.

Odbieranie zmiennej wyjściowej z Copilot Studio umiejętność temat

Możliwe jest odbieranie danych wyjściowych z Copilot Studio umiejętność temat w Composerze. Aby dowiedzieć się, jak tworzyć Copilot Studio tematy zwracające dane wyjściowe, zobacz Praca ze zmiennymi.

Na kanwie tworzenia Composer wybierz opcję Dodaj, a następnie wybierz opcję Dostęp do zasobów zewnętrznych, a następnie wybierz opcję Połącz z umiejętnością.
Na liście Nazwa okna dialogowego umiejętności wybierz klasycznego chatbota.
Znajdź nazwę działania wydarzenia dla klasycznego tematu chatbota, do którego chcesz zadzwonić. Skopiuj wartość, pomiń cudzysłowy i zapisz ją w celu użycia w następnych krokach.
Znajdź właściwość resultValue tematu. Właściwość resultValue zawiera właściwość $ref. Skopiuj tę wartość (bez cudzysłowów) i zapisz ją w następnym kroku.

Ostrzeżenie

Copilot Studio Jeśli temat nie ma danych wyjściowych, nie będzie miał właściwości resultValue .
Znajdź właściwość definitions, a następnie wyszukaj zagnieżdżoną właściwość odpowiadającą wartości $ref znalezioną w poprzednim kroku. Zwróć uwagę na nazwy i typy Copilot Studio zmiennych wyjściowych tematu. Użyjesz ich w następnych krokach.

W tym przykładzie the Copilot Studio temat zwraca dwie dane wyjściowe typu String,pva_State i pva_Item.
Wybierz Zamknij.
W obszarze Działanie wybierz Pokaż kod.
Wpisz lub wklej następujący kod. Zastąp element TOPIC_ACTIVITY_NAME nazwą działania zdarzenia dla tematu. Upewnij się, że we właściwości name nie ma cudzysłowów.
```
[Activity
    type = event
    name = TOPIC_ACTIVITY_NAME
]
```
W obszarze kodu ustaw właściwość na zmienną Composer, aby odbierać i przechowywać wartości wyjściowe z umiejętność temat Copilot Studio .
Na kanwie tworzenia Composer wybierz opcję Dodaj, a następnie wybierz opcję Zarządzaj właściwościami, a następnie wybierz opcję Ustaw właściwości.
Ustaw Właściwość na wartość aplikacji Composer, która powinna przechowywać wyodrębnioną wartość. Następnie ustaw Wartość na zmienną aplikacji Composer, w której przechowywano dane wyjściowe tematu.

W tym przykładzie wartości wyjściowe z dialog.skillResult.pvaState i dialog.skillResult.pvaItem są wyodrębniane do nowego okna dialogowego zmiennych Composer. Stan i dialog. Pozycja.

Przetestuj swojego klasycznego chatbota jako umiejętność z abotem Bot Framework

Użyj emulatora Bot Framework , aby sprawdzić, czy Twój Bot Framework bot prawidłowo wywołuje klasycznego chatbota jako umiejętność.

Ważne

Yourbot Bot Framework musi zostać dodany do listy dozwolonych klasycznego chatbota, aby połączenie z umiejętnościami działało.

Udostępnij za pośrednictwem