Udostępnij za pośrednictwem

Implementowanie umiejętności do użycia w copilot Studio

  • Artykuł

DOTYCZY: ZESTAW SDK w wersji 4

Umiejętność to bot, który może być używany przez innego bota. W ten sposób można utworzyć pojedynczego bota dostępnego dla użytkownika i rozszerzyć go o co najmniej jedną umiejętność. Więcej informacji na temat umiejętności można znaleźć w temacie Omówienie umiejętności i sposobie ich tworzenia w temacie Implementowanie umiejętności. Alternatywnie szablony Asystent wirtualny zawierają zestaw wstępnie utworzonych umiejętności, które można dostosować i wdrożyć zamiast tworzyć je od podstaw.

Jeśli spodziewasz się, że twoje umiejętności zostaną zużyte z copilot Studio Copilot Studio , istnieją pewne inne ograniczenia nałożone na umiejętności musisz uwzględnić.

Ograniczenia manifestu

Copilot Studio nakłada ograniczenia na to, co można zadeklarować w manifeście umiejętności.

  • Można zadeklarować tylko 100 lub mniej akcji.
  • Każda akcja jest ograniczona do 25 lub mniej danych wejściowych lub wyjściowych.
  • Nie można użyć typu tablicy dla danych wejściowych lub wyjściowych.

Ograniczenie tej samej dzierżawy

Aby zapewnić zgodność i odpowiedni nadzór nad umiejętnościami niestandardowymi zarejestrowanymi do użytku w programie Copilot Studio, bot umiejętności musi być zarejestrowaną aplikacją w usłudze Microsoft Entra ID. Po dodaniu umiejętności sprawdzamy, czy identyfikator aplikacji umiejętności znajduje się w dzierżawie zalogowanego użytkownika, a punkt końcowy umiejętności pasuje do zarejestrowanej aplikacji Home Page URL.

Przed zarejestrowaniem bota jako umiejętności w programie Copilot Studio należy upewnić się, że dla bota strona główna w witrynie Azure Portal jest ustawiona na adres URL manifestu umiejętności bota.

Walidacja wykonywana podczas rejestrowania umiejętności

Gdy użytkownik końcowy spróbuje nawiązać połączenie z twoją umiejętnością z poziomu swojego narzędzia copilot, najpierw będzie musiał zaimportować umiejętności do aplikacji Copilot Studio. Twoja umiejętność przechodzi przez serię kontroli poprawności. Niepowodzenie jednego z tych testów może spowodować wyświetlenie komunikatu o błędzie zgodnie z opisem w tej tabeli.

Krok weryfikacji Kod błędu Komunikat o błędzie Opis lub środki zaradcze
Adres URL manifestu jest prawidłowy URL_MALFORMED, URL_NOT_HTTPS Link jest nieprawidłowy; Łącze musi zaczynać się od https:// Wprowadź ponownie link jako bezpieczny adres URL.
Manifest jest pobierany MANIFEST_FETCH_FAILED Napotkaliśmy problemy z uzyskaniem manifestu umiejętności. Sprawdź, czy adres URL manifestu jest linkiem do manifestu; 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 czytelny MANIFEST_TOO_LARGE Manifest jest zbyt duży. Manifest musi mieć co najmniej 500 KB.
Manifest jest czytelny MANIFEST_MALFORMED Manifest jest niezgodny. Sprawdź, czy manifest jest prawidłowym plikiem JSON. Sprawdź, czy manifest zawiera wymagane właściwości, takie jak name, msaAppIdi tak dalej. Aby uzyskać więcej informacji, zobacz Ograniczenia manifestu.
Umiejętność nie została jeszcze zarejestrowana MANIFEST_ALREADY_IMPORTED Ta umiejętność została już dodana do bota. Usuń umiejętności i zarejestruj ją ponownie.
Dopasowanie punktów końcowych manifestu i domen strony głównej MANIFEST_ENDPOINT_ORIGIN_MISMATCH W punktach końcowych umiejętności występuje niezgodność. Domena adresu URL strony głównej aplikacji Entra ID firmy Microsoft i domena adresu URL manifestu musi być zgodna. Zobacz Ograniczenia dotyczące tej samej dzierżawy
Umiejętność jest hostowana w dzierżawie zalogowanych użytkowników APPID_NOT_IN_TENANT Aby dodać umiejętność, należy najpierw ją zarejestrować. Administrator musi zarejestrować umiejętności w organizacji zalogowanego użytkownika.
Akcje są ograniczone LIMITS_TOO_MANY_ACTIONS Umiejętność jest ograniczona do 100 akcji. W manifeście umiejętności zdefiniowano zbyt wiele akcji umiejętności. Należy usunąć te akcje i spróbować ponownie.
Parametry wejściowe akcji są ograniczone LIMITS_TOO_MANY_INPUTS Akcje nie mogą przekraczać 25 składników wejściowych. Istnieje zbyt wiele parametrów wejściowych akcji umiejętności. Należy usunąć parametry i spróbować ponownie.
Parametry wyjściowe akcji są ograniczone LIMITS_TOO_MANY_OUTPUTS Akcje nie mogą przekraczać 25 składników wyjściowych. Istnieje zbyt wiele parametrów wyjściowych akcji umiejętności. Usuń parametr i spróbuj ponownie.
Liczba umiejętności jest ograniczona LIMITS_TOO_MANY_SKILLS Bot może mieć maksymalnie 25 umiejętności. Do bota dodano zbyt wiele umiejętności. Usuń istniejącą umiejętność i spróbuj ponownie.
Token zabezpieczający jest prawidłowy AADERROR_OTHER Wygląda na to, że coś poszło nie tak. Może wystąpić błąd przejściowy w celu uzyskania tokenu zabezpieczającego w celu wyzwolenia umiejętności. Ponów próbę zaimportowania umiejętności.
Umiejętność jest zdrowa ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED Wystąpił błąd podczas sprawdzania umiejętności. Copilot Studio otrzymał nieznaną odpowiedź podczas wysyłania EndOfConversation działania do umiejętności. Upewnij się, że twoje umiejętności działają i odpowiadają prawidłowo.
Umiejętność jest autoryzowana ENDPOINT_HEALTHCHECK_UNAUTHORIZED Ta umiejętność nie ma na liście dozwolonych bota. Sprawdź, czy bot jest na liście dozwolonych umiejętności. Aby uzyskać więcej informacji, zobacz Copilot Studio, jak skonfigurować umiejętności.