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.

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 sytuacji, możesz przekształcić te boty w umiejętności i zarejestrować je w agencie Copilot Studio.

Note

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

Ten artykuł jest przeznaczony dla administratorów systemu lub specjalistów IT, którzy znają umiejętności.

Po zarejestrowaniu umiejętności za pomocą agenta programu Copilot Studio możesz bezproblemowo wywołać akcje umiejętności w konwersacji.

Wymagania wstępne

Ważne

agenci programu Copilot Studio obsługują tylko umiejętności utworzone przy użyciu zestawu SDK Legacy Bot Framework w wersji 4.12.0 lub nowszej oraz Zestaw SDK agentów usługi Microsoft 365 1.0.0 lub nowszej wersji . Nowe umiejętności powinny być tworzone przy użyciu Zestaw SDK agentów usługi Microsoft 365.

Aby skonfigurować umiejętność, ustaw skojarzoną rejestrację aplikacji w usłudze Microsoft Entra ID dla swojej umiejętności na konfigurację z jedną dzierżawą.

Kiedy używać przepływów agentów albo umiejętności

Poniższa tabela ułatwi Ci określenie, kiedy używać przepływów agentów, a kiedy umiejętności na potrzeby konwersacji.

Czynnik Kiedy stosować przepływy agentów Kiedy używać 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ć, 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 w operacjach złożonych i 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. Korzystaj z umiejętności, aby emitować dowolną wspieraną odpowiedź agenta. Na przykład wyświetlanie karty adaptacyjnej lub wysyłanie odpowiedzi losowych.
Czynności 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. 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 użyj programu Copilot Studio, aby utworzyć agenta oraz stworzyć i wdrożyć umiejętność przy użyciu narzędzi pro-code w Twojej organizacji. Zapoznaj się z następującymi przykładami:

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 o liście dozwolonych dla danej umiejętności. Identyfikator agenta możesz uzyskać w oknie Dodaj umiejętność.

Aby dodać umiejętność do swojego agenta, wykonaj następujące kroki:

  1. Przejdź do agenta.

  2. Wybierz kolejno pozycje Ustawienia>Umiejętności, aby przejść do strony umiejętności.

  3. Wybierz Dodaj umiejętność.

  4. Skopiuj identyfikator agenta. Identyfikator agenta trzeba podać deweloperowi umiejętności.

  5. Wprowadź adres URL do manifestu umiejętności. Manifest umiejętności zawiera informacje potrzebne agentowi do wyzwalania akcji w ramach umiejętności.

  6. 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, umiejętności należy rejestrować jako aplikację w dzierżawie usługi tożsamości Microsoft Entra ID zalogowanego użytkownika.

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

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

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 umiejętność nie znajduje się na liście dozwolonych dla agenta
(ENDPOINT_HEALTHCHECK_UNAUTHORIZED)		 Sprawdź, czy agent został dodany do listy dozwolonych dla umiejętności.
  • Last updated on