Konfigurowanie umiejętności Bot Framework do użycia w aplikacji Copilot Studio

Copilot Studio umożliwia rozszerzanie pomocnika 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 pomocniku Copilot Studio.

Uwaga

Aby dodać umiejętności z poziomu aplikacji Copilot Studio w Microsoft Teams, musisz mieć autonomiczną subskrypcję Microsoft Copilot Studio.

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 przy użyciu pomocnika Copilot Studio autorzy mogą łatwo wywołać akcje umiejętności w konwersacji.

Wymagania wstępne

• Przeglądanie ograniczeń i walidacja umiejętności używanych w usłudze Copilot Studio

Ważne

Pomocnicy Copilot Studio obsługują tylko umiejętności zbudowane przy użyciu zestawu Bot Framework SDK w wersji 4.12.0+.

Klasyczne czatboty obsługują tylko umiejętności zbudowane przy użyciu zestawu Bot Framework SDK w wersji 4.7+.

Jeśli używasz Bot Framework Composer, zdecydowanie zalecane jest używanie Composer 2.x. Aby użyć istniejącego pomocnika z wersji Composer 1.x, należy najpierw przeprowadzić migrację do wersji Composer 2.x, a dopiero potem użyć go jako umiejętności.

Aby skonfigurować umiejętności, skojarzoną z nią konfigurację w Microsoft Entra ID dla tej umiejętności należy ustawić w konfiguracji z wieloma dzierżawcami.

Przepływy akcji i akcji 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 pomocników mogą tworzyć możliwe do ponownego użycia przepływy w celu osadzenia ich w dowolnej konwersacji pomocnika	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	Użyj przepływów do podania odpowiedzi pomocnika. Na przykład wyświetlanie spersonalizowanej wiadomość lub wbudowanych obrazów.	Użyj umiejętności do podawania odpowiedzi każdego obsługiwanego pomocnika. 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 przejście do jakiejś strony po otrzymaniu odpowiedzi pomocnika.

Konfigurowanie umiejętności

Najpierw użyj programu Copilot Studio do utworzenia pomocnika i utworzenia i wdrożenia umiejętności przy użyciu narzędzi do tworzenia profesjonalnego kodu w organizacji.

Przed zarejestrowaniem umiejętności należy przekazać deweloperowi umiejętności identyfikator pomocnika w celu autoryzowania pomocnika do wywołania akcji w ramach umiejętności. Dowiedz się więcej na temat listy dozwolonych umiejętności. Identyfikator pomocnika można znaleźć w oknie dodawania umiejętności.

Aby dodać umiejętność do pomocnika:

1. W okienku nawigacji rozwiń pozycję Ustawienia i wybierz opcję Umiejętności.

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

3. Skopiuj identyfikator pomocnika i podaj go deweloperowi umiejętności.

   

4. Wprowadź adres URL do manifestu umiejętności. Manifest umiejętności zawiera informacje potrzebne pomocnikowi do wyzwolenia akcji w ramach umiejętności.

5. Wybierz przycisk Dalej, aby rozpocząć proces walidacji. Po pomyślnej weryfikacji umiejętność jest dodawana do pomocnika. Teraz możesz korzystać z tej umiejętności w swoich tematach.

Zagadnienia dotyczące zgodności

Aby chronić prywatność użytkowników, wymagane są umiejętności, aby zarejestrować się jako aplikacja w dzierżawie Tożsamości Microsoft Entra.

Rozwiązywanie problemów dotyczących błędów podczas rejestracji umiejętności

Seria procedur weryfikacyjnych jest przeprowadzana względem adresu URL. Te testy zapewniają zgodność, ład i użyteczność umiejętności dodanej do pomocnika. 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ł problem podczas pobierania manifestu umiejętności. (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 ten plik jest prawidłowym plikiem JSON. (b) Sprawdź, czy ten manifest zawiera wymagane właściwości, na przykład (name, msaAppId, pojedynczy endpoint, activities/id, activities/description, activities/type (tylko obsługiwane event lub message)).
Brak zgodności punktów końcowych (MANIFEST_ENDPOINT_ORIGIN_MISMATCH)	Upewnij się, że punkt końcowy umiejętności jest dopasowany do rejestracji aplikacji Tożsamości Microsoft Entra 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 najpierw ją zarejestrować (APPID_NOT_IN_TENANT)	Należy sprawdzić, czy identyfikator aplikacji twojej umiejętności jest zarejestrowany w dzierżawie organizacji Tożsamości Microsoft Entra.
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 pomocnika. (MANIFEST_ALREADY_IMPORTED)	Usuń umiejętność i spróbuj zarejestrować się ponownie.
Umiejętność jest ograniczona do 100 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.
Pomocnik może mieć maksymalnie 100 umiejętności. (LIMITS_TOO_MANY_SKILLS)	Jest zbyt wiele umiejętności dodanych do pomocnika. 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 pomocnika (ENDPOINT_HEALTHCHECK_UNAUTHORIZED)	Upewnij się, że pomocnik został dodany do listy dozwolonych w ramach umiejętności.