Udostępnij przez

Konfigurowanie umiejętności do używania w agentach programu Copilot Studio

Program Copilot Studio umożliwia rozszerzenie agenta przy użyciu umiejętności. Jeśli masz już w swojej organizacji utworzonych i wdrożonych agentów (przy użyciu zestawu SDK agentów usługi Microsoft 365 lub narzędzi pro-code) dla określonych scenariuszy, możesz przekonwertować takie boty na umiejętność, po czym 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 .

Po zarejestrowaniu umiejętności w agencie Copilot Studio możesz bezproblemowo wyzwalać akcje umiejętności w konwersacji.

Wymagania wstępne

Ważne

Agenci Copilot Studio obsługują tylko umiejętności 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 należy tworzyć przy użyciu zestawu SDK agentów usługi Microsoft 365.

Aby skonfigurować umiejętność, ustaw skojarzoną rejestrację aplikacji w usłudze Tożsamość Microsoft Entra dla swojej umiejętności na konfigurację jedno-dzierżawową.

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

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

Czynnik Kiedy używać przepływów 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ć, rozmieszczać i hostować umiejętności niestandardowe we własnym środowisku.
Typ konwersacji 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.
Odpowiedź 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 użyj narzędzia Copilot Studio, aby utworzyć agenta i utworzyć i wdrożyć umiejętności przy użyciu narzędzi profesjonalnego kodowania 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 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. 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 informację o tym, że bot będzie musiał wyzwalać akcje 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 zalogowanego użytkownika.

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. Te błędy należy poprawić przed zarejestrowaniem umiejętności.

Wiadomość z błędem 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 manifest jest prawidłowym plikiem JSON.
(b) Sprawdź, czy manifest zawiera wymagane właściwości
, na przykład (name, msaAppId, pojedyncze endpoint, activities/id, activities/descriptionactivities/type tylko event lub message obsługiwane).
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. 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)		 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 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. 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