Konfiguruj umiejętności usługi Azure Bot Service do użycia w agentach usługi Copilot Studio

Note

W tym artykule opisano funkcje używane w agentach lub przepływach agentów obsługiwanych przez standardowe środowisko uruchomieniowe.

Important

W niniejszym artykule przedstawiono informacje na temat umiejętności usługi Azure Bot Service – opartego na kodzie sposobu rozszerzania możliwości agenta w standardowym środowisku testowym. Umiejętności te nie powinny być mylone z umiejętnościami agentycznymi w środowisku GitHub Copilot. Dowiedz się więcej o tym, jak wykorzystać umiejętności agentyczne w przeglądzie umiejętności dla agentów.

Copilot Studio pozwala rozszerzyć swojego agenta dzięki Azure Bot Service umiejętnościom. Jeśli masz już agentów zbudowanych i wdrożonych w organizacji (korzystając z Zestaw SDK agentów usługi Microsoft 365 lub innych narzędzi pro-code) dla konkretnych scenariuszy, możesz przekształcić te boty w umiejętności Azure Bot Service i zarejestrować je w agencie Copilot Studio.

Note

Aby dodać umiejętność Azure Bot Service w 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 Azure Bot Service.

Po zarejestrowaniu umiejętności Azure Bot Framework w agencie Copilot Studio możesz bezproblemowo wywoływać akcje umiejętności usługi Azure Bot Service w rozmowie.

Prerequisites

Important

Agenci Copilot Studio obsługują tylko umiejętności Azure Bot Service utworzone przy użyciu starszego zestawu SDK platformy Bot Framework w wersji 4.12.0+ i zestawu SDK agentów usługi Microsoft 365 w wersji 1.0.0+. Nowe umiejętności usługi Azure Bot Service powinny być tworzone przy użyciu zestawu SDK Microsoft 365 Agents.

Aby skonfigurować umiejętność Azure Bot Service, ustaw powiązaną rejestrację aplikacji w Microsoft Entra ID dla swojej umiejętności na konfigurację pojedynczego tenanta.

Kiedy używać przepływów agentów lub umiejętności usługi Azure Bot Service

Poniższa tabela pomaga określić, kiedy wykorzystać przepływy agentów lub umiejętności usługi Azure Bot Service w rozmowie.

Czynnik Kiedy stosować przepływy agentów Kiedy używać umiejętności usługi Azure Bot Service
Osoba Autorzy agentów mogą kompilować przepływy z możliwością ponownego użycia do osadzania w dowolnej konwersacji agenta. Deweloperzy mogą tworzyć, wdrażać i zarządzać umiejętnościami niestandardowymi we własnym środowisku.
Typ konwersacji Używaj przepływów do prostych, jednokrotnych operacji. Na przykład składanie zamówienia lub uzyskiwanie stanu zamówienia. Korzystanie z umiejętności Azure Bot Service w operacjach złożonych i obejmujących wiele kroków. Na przykład planowanie spotkania lub rezerwowanie lotu.
Odpowiedź Korzystaj z przepływów, aby generować odpowiedź agenta. Na przykład wyświetlanie spersonalizowanej wiadomości lub obrazów w tekście. Korzystanie z umiejętności Azure Bot Service w celu wysyłania wszystkich obsługiwanych odpowiedzi agenta. Na przykład wyświetlanie karty adaptacyjnej lub wysyłanie odpowiedzi losowych.
Actions Użyj przepływów do wyzwalania akcji odbywających się po stronie serwera w jednym cyklu. Na przykład wywoływanie interfejsu API HTTP lub wyzwalanie łącznika niestandardowego. Wykorzystaj umiejętności usługi Azure Bot Service, aby wywołać zdarzenia i działania po stronie serwera i klienta. Na przykład przechodzenie do strony po odpowiedzi agenta.

Skonfiguruj umiejętność usługi Azure Bot Service

Po pierwsze, wykorzystaj Copilot Studio, aby utworzyć agenta oraz utworzyć i wdrożyć skilla Azure Bot Service z wykorzystaniem narzędzi pro-code w swojej organizacji. Zapoznaj się z następującymi przykładami:

Przed rejestracją umiejętności Azure Bot Service podaj identyfikator agenta swojemu programistowi umiejętności, aby mógł upoważnić agenta do wywoływania akcji w tej umiejętności. Dowiedz się więcej na temat listy dozwolonych umiejętności Azure Bot Service. Możesz uzyskać identyfikator agenta z okna Dodaj umiejętność.

Aby dodać umiejętność Azure Bot Service do swojego agenta:

  1. Przejdź do agenta.

  2. Wybierz Ustawienia>Umiejętności.

  3. Wybierz Dodaj umiejętność.

  4. Skopiuj identyfikator agenta. Musisz podać identyfikator agenta swojemu programistowi umiejętności.

  5. Wpisz adres URL do manifestu umiejętności Azure Bot Service. Manifest umiejętności zawiera informacje, których agent potrzebuje do wywołania akcji w ramach umiejętności.

  6. Wybierz przycisk Dalej, aby rozpocząć proces walidacji. Gdy weryfikacja zakończy się powodzeniem, Twoja umiejętność zostanie dodana do Twojego agenta. 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 Azure Bot Service należy rejestrować jako aplikację w dzierżawie Microsoft Entra ID zalogowanego użytkownika.

Rozwiązywanie problemów podczas rejestracji umiejętności Azure Bot Service

System uruchamia serię kontroli poprawności względem adresu URL. Te kontrole zapewniają zgodność, zarządzanie i użyteczność skilla, który dodajesz do swojego agenta. Te błędy należy poprawić przed zarejestrowaniem umiejętności Azure Bot Service.

Komunikat o błędzie Rozwiązywanie problemów/ograniczenie ryzyka
Mieliśmy problemy z uzyskaniem 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 manifest jest prawidłowym plikiem JSON.
(b) Sprawdzić, czy manifest zawiera wymagane właściwości
Na przykład (name, msaAppId, pojedynczy endpoint, activities/id, activities/description (activities/type tylko event lub message wspierany)).
Brak zgodności punktów końcowych
(MANIFEST_ENDPOINT_ORIGIN_MISMATCH)		 Sprawdź, czy punkt końcowy umiejętności jest zgodny z polem Publisher domain (preferowane) lub Home page URL rejestracji aplikacji tożsamość Microsoft Entra ID. Dowiedz się więcej o ustawianiu strony głównej dla punktów końcowych.
Aby dodać umiejętność, trzeba ją najpierw 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 ID.
Link nie jest poprawny; Link musi zaczynać się od https://
(URL_MALFORMED, URL_NOT_HTTPS)		 Popraw link, aby dodać bezpieczny adres 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 twojego agenta.
(MANIFEST_ALREADY_IMPORTED)		 Usuń umiejętność i spróbuj zarejestrować się ponownie.
Umiejętność jest ograniczona do 100 działań.
(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.
Działania są ograniczone do 25 wyjść.
(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.
Wygląda na to, że coś poszło nie tak.
(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. Sprawdź również, czy rejestracja aplikacji umiejętności pojedynczej dzierżawy została wdrożona w tej samej dzierżawie.
Ta funkcja nie umieściła Twojego agenta na liście zablokowanych
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 Sprawdź, czy Twój agent znajduje się na liście dozwolonych użytkowników tej umiejętności.
  • Ostatnia aktualizacja o