Share via

Implementowanie umiejętności do użycia w agentach wirtualnych usługi Power Virtual

  • 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żesz utworzyć jednego bota dostępnego dla użytkownika i rozszerzyć go o co najmniej jedną umiejętności. 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 oczekujesz, że twoje umiejętności będą używane z bota usługi Power Virtual Agents , istnieją pewne dodatkowe ograniczenia dotyczące umiejętności, które należy uwzględnić.

Ograniczenia manifestu

Agenci usługi Power Virtual Nakładają ograniczenia dotyczące tego, co można zadeklarować w manifeście umiejętności.

  • Możesz 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 ramach agentów usługi Power Virtual Agents, 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 jest w dzierżawie zalogowanego użytkownika, a punkt końcowy umiejętności pasuje do zarejestrowanej aplikacji Home Page URL.

Aby móc zarejestrować bota jako umiejętności w ramach agentów usługi Power Virtual Agents, upewnij 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 bota usługi Power Virtual Agents, najpierw będzie musiał zaimportować umiejętności do agentów usługi Power Virtual Agents. Twoje umiejętności przejdą 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 w postaci bezpiecznego adresu 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 globalny 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. Agenci usługi Power Virtual odebrali 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 dozwolonej listy bota. Sprawdź, czy bot został dodany do listy dozwolonych umiejętności. Aby uzyskać więcej informacji, zobacz Power Virtual Agents how to Configure a Skill (Jak skonfigurować umiejętności).