Jártasság megvalósítása a Copilot Studióban 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 összeállított 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 készségeit egy Copilot Studio-társpilóta fogja használni, bizonyos egyéb korlátozások vonatkoznak a képességére, amelyeket figyelembe kell vennie.
Jegyzékkorlátozások
A Copilot Studio korlátozásokat helyez el arra, 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 Copilot Studióban való használatra regisztrálva legyen az egyéni készségek megfelelősége és 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 Copilot Studióban, 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ó megpróbál csatlakozni a képességéhez a társpilóta alapján, először importálnia kell a képességet a Copilot Studióba. 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:// | A hivatkozás újraküldése 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 , msaAppId stb. 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 Copilot Studio 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 engedélyezi a robot felsorolását. | Ellenőrizze, hogy a robot szerepel-e a képesség engedélyezési listájában. További információkért tekintse meg a Copilot Studiót, hogy miként konfigurálhat egy készséget. |