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

Usługa Copilot Studio rozszerza agenta 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 agencie Copilot Studio.

Notatka

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 w agencie usługi Copilot Studio autorzy mogą bezproblemowo wyzwalać akcje dotyczące 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

Agent Copilot Studio obsługuje tylko umiejętności zbudowane przy użyciu 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. Jeśli chcesz użyć istniejącego agenta Composer 1.x, najpierw zmigruj go do Composer 2.x, zanim użyjesz go jako umiejętności.

Aby skonfigurować umiejętność, skojarzona rejestracja aplikacji w Microsoft Entra ID umiejętności powinna być ustawiona na konfigurację wielodostępową.

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 agentów mogą kompilować przepływy z możliwością ponownego użycia do osadzania w dowolnej konwersacji agenta.	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 agenta. Na przykład wyświetlanie spersonalizowanej wiadomość lub wbudowanych obrazów.	Korzystanie z umiejętności w celu wysyłania wszystkich obsługiwanych odpowiedzi agenta. 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 agenta.

Konfigurowanie umiejętności

Najpierw Copilot Studio utwórz agenta usługi i utwórz oraz uruchom umiejętność, korzystając z profesjonalnych narzędzi do kodowania w organizacji.

Przed zarejestrowaniem umiejętności podaj identyfikator agenta deweloperowi umiejętności, aby autoryzować agenta do wywoływania akcji w umiejętności. Dowiedz się więcej na temat listy dozwolonych umiejętności. Identyfikator agenta możesz uzyskać w oknie Dodaj umiejętność.

Dodaj umiejętności do swojego agenta:

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 swój identyfikator agenta i podaj go deweloperowi umiejętności.

4. Wprowadź adres URL do manifestu umiejętności. Manifest umiejętności zawiera informację o tym, że agent będzie musiał wyzwalać akcje w ramach umiejętności.

5. Wybierz przycisk Dalej, aby rozpocząć proces walidacji. Gdy weryfikacja zakończy się pomyślnie, Twoja umiejętność zostanie dodana do Twojego agenta AI. 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 kontrole zapewniają zgodność, ład i użyteczność umiejętności dodawanej do agenta. 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 agenta. (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.
Agent może mieć maksymalnie 100 umiejętności. (LIMITS_TOO_MANY_SKILLS)	Do agenta 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 agenta (ENDPOINT_HEALTHCHECK_UNAUTHORIZED)	Sprawdź, czy agent został dodany do listy dozwolonych umiejętności.