Rozszerzanie bota przy użyciu funkcji umiejętności Bot Framework
Wybierz wersję usługi Power Virtual Agents, której używasz, w tym miejscu:
Usługa Power Virtual Agents rozszerza bota przy użyciu umiejętności Bot Framework. Jeśli masz już zbudowane i wdrożone boty w swojej organizacji (korzystając z Bot Framework SDK i narzędzi do profesjonalnego tworzenia kodu) w określonych scenariuszach można przekształcić te boty w umiejętność i zarejestrować tę umiejętność w bocie Power Virtual Agents.
Ten artykuł jest przeznaczony dla administratorów systemów lub specjalistów branży IT zaznajomionych z umiejętnościami Bot Framework. Po zarejestrowaniu umiejętności w bocie usługi Power Virtual Agents autorzy mogą bezproblemowo wyzwalać akcje dotyczące umiejętności w konwersacji.
Wymagania wstępne
- Dowiedz się więcej o tym, co możesz zrobić za pomocą aplikacji Power Virtual Agents.
- Przeglądanie ograniczeń i walidacja umiejętności używanych w usłudze Power Virtual Agents
Porównanie korzystania z akcji dotyczących przepływów i umiejętności
Poniższa tabela ułatwi określenie, kiedy należy używać umiejętności na potrzeby konwersacji.
| Akcje przepływu | Akcje umiejętności | |
|---|---|---|
| Osoba | Autorzy botów mogą kompilować przepływy z możliwością ponownego użycia do osadzania w dowolnej konwersacji bota | Deweloperzy mogą tworzyć, rozmieszczać i hostować umiejętności niestandardowe we własnym środowisku |
| Konwersacja | Korzystanie z przepływów w prostych operacjach obejmujących jeden krok. Na przykład składanie zamówienia lub uzyskiwanie stanu zamówienia. | Korzystanie z umiejętności w operacjach złożonych i obejmujących wiele kroków. Na przykład planowanie spotkania lub rezerwowanie lotu. |
| Response | Korzystanie z przepływów do wysyłania odpowiedzi bota. Na przykład wyświetlanie spersonalizowanej wiadomość lub wbudowanych obrazów. | Korzystanie z umiejętności w celu wysyłania wszystkich obsługiwanych odpowiedzi bota. Na przykład wyświetlanie karty adaptacyjnej lub wysyłanie odpowiedzi losowych. |
| Akcje | Korzystanie z przepływów do wyzwalania pojedynczych akcji po stronie serwera. Na przykład wywoływanie interfejsu API HTTP lub wyzwalanie łącznika niestandardowego. | Korzystanie z umiejętności do wyzwalania zdarzeń i akcji na stronie serwera i po stronie klienta. Na przykład przechodzenie do strony po odpowiedzi bota. |
Konfigurowanie umiejętności do użycia w usłudze Power Virtual Agents
Najpierw utwórz bota usługi Power Virtual Agents i utwórz oraz wdróż umiejętność, korzystając z profesjonalnych narzędzi do kodowania w organizacji.
Uwaga
Power Virtual Agents obsługuje tylko umiejętności utworzone przy użyciu zestawu SDK Bot Framework w wersji 4.7 lub nowszej.
Przed zarejestrowaniem umiejętności podaj identyfikator bota deweloperowi umiejętności, aby autoryzować bota do wywoływania akcji w umiejętności. Dowiedz się więcej na temat listy dozwolonych umiejętności.
Dodawanie bota do listy dozwolonych umiejętności:
W portalu usługi Power Virtual Agents w bocznym okienku nawigacji rozwiń menu Zarządzaj i wybierz pozycję Umiejętności.
W górnej części strony umiejętności wybierz pozycję Podaj identyfikator dla listy dozwolonych.
Zostanie wyświetlone okno z unikatowym identyfikatorem. Skopiuj ten identyfikator i przekaż go deweloperowi umiejętności.
Wprowadzanie adresu URL manifestu umiejętności w celu dodania umiejętności do bota:
W portalu usługi Power Virtual Agents w bocznym okienku nawigacji rozwiń menu Zarządzaj i wybierz pozycję umiejętności.
W górnej części strony umiejętności wybierz pozycję Dodaj umiejętność.
Wprowadź adres URL do manifestu umiejętności. Manifest umiejętności zawiera informację o tym, że bot będzie musiał wyzwalać akcje w ramach umiejętności.
Wybierz przycisk Dalej, aby rozpocząć proces walidacji. Po pomyślnym zakończeniu umiejętność jest dodawana do bota użytkownika. Teraz możesz korzystać z tej umiejętności w swoich tematach.
Zagadnienia dotyczące zgodności
Aby chronić prywatność użytkowników, umiejętności należy rejestrować jako aplikację w dzierżawcy usługi Azure Active Directory zalogowanego użytkownika.
Rozwiązywanie problemów dotyczących błędów podczas rejestracji umiejętności
Seria procedur weryfikacyjnych jest przeprowadzana względem adresu URL. Te kontrole zapewniają zgodność, ład i użyteczność umiejętności dodawanej do bota. Przed zarejestrowaniem umiejętności konieczne będzie usunięcie błędów.
| Komunikat o błędzie | Rozwiązywanie problemów/ograniczenie ryzyka |
|---|---|
| Wystąpiły problemy z pobieraniem manifestu kwalifikacji. ( MANIFEST_FETCH_FAILED) |
Spróbuj otworzyć adres URL manifestu w przeglądarce internetowej. Jeśli adres URL powoduje renderowanie strony w ciągu 10 sekund, należy ponownie zarejestrować umiejętność. |
| Manifest jest niezgodny. ( MANIFEST_MALFORMED) |
(a) Sprawdź, czy manifest jest prawidłowym plikiem JSON. (b) Sprawdź, czy manifest zawiera wymagane właściwości Na przykład ( name, msaAppId, pojedyncza właściwość endpoint, activities/id, activities/description, activities/type (tylko obsługiwana właściwość event lub message)). |
| Brak zgodności punktów końcowych ( MANIFEST_ENDPOINT_ORIGIN_MISMATCH) |
Sprawdź, czy punkt końcowy umiejętności odpowiada rejestracji aplikacji Azure AD w zakresie wartości pola Publisher domain (preferowane) lub Home page URL. Dowiedz się więcej o ustawianiu strony głównej dla punktów końcowych. |
| Aby dodać umiejętność, należy ją najpierw zarejestrować ( APPID_NOT_IN_TENANT) |
Sprawdź, czy identyfikator aplikacji dla Twojej umiejętności jest zarejestrowany w dzierżawie usługi Azure AD w organizacji. |
| Link jest nieprawidłowy; link musi zaczynać się od https:// ( URL_MALFORMED, URL_NOT_HTTPS) |
Wprowadź ponownie link w postaci bezpiecznego adresu URL. |
| Manifest jest zbyt duży; ( MANIFEST_TOO_LARGE) |
Sprawdź rozmiar manifestu. Musi być on mniejszy lub równy 500 KB. |
| Ta umiejętność została już dodana do bota. ( MANIFEST_ALREADY_IMPORTED) |
Usuń umiejętność i spróbuj zarejestrować się ponownie. |
| Umiejętność jest ograniczona do 25 akcji. ( LIMITS_TOO_MANY_ACTIONS) |
W manifeście umiejętności zdefiniowano zbyt wiele akcji umiejętności. Należy usunąć te akcje i spróbować ponownie. |
| Akcje nie mogą przekraczać 25 składników wejściowych. ( LIMITS_TOO_MANY_INPUTS) |
Istnieje zbyt wiele parametrów wejściowych akcji umiejętności. Należy usunąć parametry i spróbować ponownie. |
| Akcje nie mogą przekraczać 25 składników wyjściowych. ( LIMITS_TOO_MANY_OUTPUTS) |
Istnieje zbyt wiele parametrów wyjściowych akcji umiejętności. Należy usunąć parametry i spróbować ponownie. |
| Bot może mieć maksymalnie 25 umiejętności. ( LIMITS_TOO_MANY_SKILLS) |
Do bota dodano zbyt wiele umiejętności. Usuń istniejącą umiejętność i spróbuj ponownie. |
| Prawdopodobnie wystąpił błąd. ( AADERROR_OTHER) |
Wystąpił przejściowy błąd podczas walidacji umiejętności. Ponów próbę. |
| Wystąpił błąd podczas sprawdzania umiejętności. ( ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED) |
Sprawdź, czy punkt końcowy umiejętności jest w trybie online i czy odpowiadasz na wiadomości. |
| Ta umiejętność nie znajduje się na liście dozwolonych dla bota ( ENDPOINT_HEALTHCHECK_UNAUTHORIZED) |
Sprawdź, czy bot został dodany do listy dozwolonych umiejętności. Dowiedz się więcej o dodawaniu umiejętności do listy dozwolonych. |
Uwaga
Can you tell us about your documentation language preferences? Take a short survey.
The survey will take about seven minutes. No personal data is collected (privacy statement).