Jártasság megvalósítása a Power Virtual Agentsben való használathoz
A KÖVETKEZŐKRE VONATKOZIK: SDK v4
A képesség egy robot, amelyet egy másik robot használhat. Ily módon egyetlen felhasználóval rendelkező robotot hozhat létre, és egy vagy több szakértelemmel bővítheti azt. A készségekkel kapcsolatos általános ismereteket a Készségek áttekintése területen, valamint a képességek implementálásában való felépítését is megismerheti. Másik lehetőségként a Virtual Assistant-sablonok olyan előre elkészített készségeket tartalmaznak, amelyek testre szabhatók és üzembe helyezhetők ahelyett, hogy az alapoktól kezdve építkeznek.
Ha arra számít, hogy a jártasság egy Power Virtual Agents-robotból lesz felhasználva, további korlátozások vonatkoznak a képességére, amelyeket figyelembe kell vennie.
Jegyzékkorlátozások
A Power Virtual Agents korlátozza, hogy mit deklarálhat a készségjegyzékben.
- Legfeljebb 100 műveletet deklarálhat.
- Minden művelet legfeljebb 25 bemenetre vagy kimenetre korlátozódik.
- Bemenetekhez és kimenetekhez nem használhatja a tömbtípust.
Azonos bérlőre vonatkozó korlátozás
Annak érdekében, hogy a Power Virtual Agentsben való használatra regisztrálva legyen a megfelelőség és az egyéni készségek megfelelő szabályozása, a képességrobotnak regisztrált alkalmazásnak kell lennie a Microsoft Entra-azonosítóban. Képesség hozzáadásakor ellenőrizni fogjuk, hogy a képesség alkalmazásazonosítója a bejelentkezett felhasználó bérlőjében van-e, és a képességvégpont megegyezik-e a regisztrált alkalmazáséval Home Page URL.
Ahhoz, hogy a robotot készségként regisztrálhassa a Power Virtual Agentsben, győződjön meg arról, hogy a robot kezdőlapja az Azure Portalon a robot képzettségjegyzékének URL-címére van állítva.
Képesség regisztrálása során végrehajtott ellenőrzés
Amikor egy végfelhasználó a Power Virtual Agents robotból próbál csatlakozni a képességéhez, először importálnia kell a képességet a Power Virtual Agentsbe. A jártasság ellenőrzési ellenőrzések sorozatán megy keresztül. Ezen ellenőrzések egyikének sikertelensége hibaüzenetet eredményezhet a táblázatban leírtak szerint.
| Érvényesítési lépés | Hibakód | Hibaüzenet | Leírás vagy kockázatcsökkentés |
|---|---|---|---|
| A jegyzék URL-címe érvényes | URL_MALFORMED, URL_NOT_HTTPS |
A hivatkozás érvénytelen; A hivatkozásnak https:// | Adja meg újra a hivatkozást biztonságos URL-címként. |
| A jegyzék lekérthető | MANIFEST_FETCH_FAILED |
Problémákba ütköztünk a képességjegyzék beszerzése során. | Ellenőrizze, hogy a jegyzék URL-címe a jegyzékre mutató hivatkozás-e; próbálja meg megnyitni a jegyzék URL-címét egy webböngészőben. Ha az URL-cím 10 másodpercen belül megjeleníti a lapot, regisztrálja újra a tudását. |
| A jegyzék olvasható | MANIFEST_TOO_LARGE |
A jegyzék túl nagy. | A jegyzéknek legalább 500 KB-nak kell lennie. |
| A jegyzék olvasható | MANIFEST_MALFORMED |
A jegyzék nem kompatibilis. | Ellenőrizze, hogy a jegyzék érvényes JSON-fájl-e. Ellenőrizze, hogy a jegyzék tartalmaz-e szükséges tulajdonságokat, például name, msaAppIdstb. További információt a Jegyzékkorlátozások című témakörben talál. |
| A skill még nincs regisztrálva | MANIFEST_ALREADY_IMPORTED |
Ez a képesség már hozzá lett adva a robothoz. | Törölje a képességet, és regisztrálja újra. |
| A jegyzékvégpont és a kezdőlap tartományai egyeznek | MANIFEST_ENDPOINT_ORIGIN_MISMATCH |
A képességvégpontok nem egyeznek. | A Microsoft Entra ID alkalmazás kezdőlapjának URL-tartományának és a jegyzék URL-tartományának egyeznie kell. Lásd : Azonos bérlőre vonatkozó korlátozás |
| A skill a felhasználó bérlőjében van bejelentkezve | APPID_NOT_IN_TENANT |
Egy képesség hozzáadásához először regisztrálni kell. | A globális rendszergazdának regisztrálnia kell a képességet a bejelentkezett felhasználó szervezetében. |
| A műveletek korlátozottak | LIMITS_TOO_MANY_ACTIONS |
A képesség legfeljebb 100 műveletre korlátozódik. | Túl sok képességművelet van definiálva a készségjegyzékben. Távolítsa el a műveleteket, és próbálkozzon újra. |
| A műveletbemeneti paraméterek korlátozottak | LIMITS_TOO_MANY_INPUTS |
A műveletek legfeljebb 25 bemenetre korlátozódnak. | Túl sok képességművelet bemeneti paramétere van. Távolítsa el a paramétereket, és próbálkozzon újra. |
| A művelet kimeneti paraméterei korlátozottak | LIMITS_TOO_MANY_OUTPUTS |
A műveletek legfeljebb 25 kimenetre korlátozódnak. | Túl sok képességművelet kimeneti paramétere van. Távolítsa el a paramétert, és próbálkozzon újra. |
| A képzettségek száma korlátozott | LIMITS_TOO_MANY_SKILLS |
A robot legfeljebb 25 képességgel rendelkezhet. | Túl sok képesség van hozzáadva egy robothoz. Távolítsa el a meglévő képességet, és próbálkozzon újra. |
| A biztonsági jogkivonat érvényes | AADERROR_OTHER |
Úgy tűnik, valami hiba történt. | Előfordulhat, hogy átmeneti hiba történik a képesség aktiválásához szükséges biztonsági jogkivonat beszerzéséhez. Próbálkozzon újra a képesség importálásával. |
| A képesség kifogástalan | ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED |
Hiba történt a képesség ellenőrzése közben. | A Power Virtual Agents ismeretlen választ kapott, amikor egy EndOfConversation tevékenységet küldött a képességének. Győződjön meg arról, hogy a jártasság megfelelően működik és válaszol. |
| A szakértelem engedélyezve van | ENDPOINT_HEALTHCHECK_UNAUTHORIZED |
Ez a képesség nem teszi lehetővé a robot felsorolását. | Ellenőrizze, hogy a robot hozzá lett-e adva a képesség engedélyezési listájához. További információkért tekintse meg a Power Virtual Agents képesség konfigurálását ismertető témakört. |