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

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:

  1. W portalu usługi Power Virtual Agents w bocznym okienku nawigacji rozwiń menu Zarządzaj i wybierz pozycję Umiejętności.

    Wybieranie kolejno pozycji Zarządzaj i Umiejętności

  2. W górnej części strony umiejętności wybierz pozycję Podaj identyfikator dla listy dozwolonych.

    Wybieranie przycisku Podaj identyfikator dla listy dozwolonych

  3. Zostanie wyświetlone okno z unikatowym identyfikatorem. Skopiuj ten identyfikator i przekaż go deweloperowi umiejętności.

    Okna z unikatowym identyfikatorem

Wprowadzanie adresu URL manifestu umiejętności w celu dodania umiejętności do bota:

  1. W portalu usługi Power Virtual Agents w bocznym okienku nawigacji rozwiń menu Zarządzaj i wybierz pozycję umiejętności.

    Wybieranie kolejno pozycji Zarządzaj i umiejętności

  2. W górnej części strony umiejętności wybierz pozycję Dodaj umiejętność.

    Wybieranie przycisku Dodaj umiejętność

  3. 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.

  4. 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).