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

Note

Ten artykuł opisuje cechy stosowane w przepływach agentów lub przepływach agentów zasilanych standardową wiązką.

Important

Ten artykuł zawiera informacje o umiejętnościach usługi Azure Bot Service, czyli opartym na kodzie sposobie rozszerzania możliwości agenta w standardowej infrastrukturze. Tych umiejętności nie należy mylić z agentic skills w harnessie 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 IT, którzy znają umiejętności usługi 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 usługi Azure Bot Service utworzone przy użyciu Legacy Bot Framework SDK w wersji 4.12.0+ oraz Zestaw SDK agentów usługi Microsoft 365 v1.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ą tworzyć scenariusze do ponownego użycia, które można osadzić 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. Wykorzystaj umiejętności usługi Azure Bot Service do złożonych operacji wieloetapowych. 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. Wykorzystaj umiejętności usługi Azure Bot Service, aby generować każdą obsługiwaną odpowiedź 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 o liście dozwolonych elementów dla umiejętności usługi 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 się powiedzie, 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żytkownika, musisz zarejestrować umiejętność usługi Azure Bot Service jako aplikację w dzierżawcy 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. Musisz naprawić te błędy przed zarejestrowaniem składnika Skill usługi 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)).
Jest rozbieżność w punktach końcowych
(MANIFEST_ENDPOINT_ORIGIN_MISMATCH)		 Sprawdź, czy punkt końcowy umiejętności jest zgodny z rejestracją aplikacji w Microsoft Entra ID w polu Publisher domain (preferowanym) lub Home page URL. 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)		 Sprawdź, czy identyfikator aplikacji twojej umiejętności jest zarejestrowany w dzierżawie środowiska Microsoft Entra ID w twojej organizacji.
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 funkcji. 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. Upewnij się również, że rejestracja aplikacji umiejętności dla pojedynczego dzierżawcy została wdrożona w tym samym dzierżawcy.
Ta umiejętność nie dodała Twojego agenta do listy dozwolonych
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 Sprawdź, czy Twój agent został dodany do listy dozwolonych dla umiejętności.
  • Ostatnia aktualizacja o