Implementera en färdighet för användning i Copilot Studio
GÄLLER FÖR: SDK v4
En färdighet är en robot som kan användas av en annan robot. På så sätt kan du skapa en enda användarriktad robot och utöka den med en eller flera kunskaper. Du kan lära dig mer om kunskaper i allmänhet i Kunskapsöversikt och hur du skapar dem i Implementera en färdighet. Alternativt innehåller mallarna för virtuella assistenter en uppsättning fördefinierade kunskaper som du kan anpassa och distribuera i stället för att skapa en från grunden.
Om du förväntar dig att din skicklighet kommer att förbrukas från en Copilot Studio-andrepilot , finns det några andra begränsningar för din kompetens som du måste ta hänsyn till.
Manifestbegränsningar
Copilot Studio begränsar vad du kan deklarera i ditt kunskapsmanifest.
- Du kan bara deklarera 100 eller färre åtgärder.
- Varje åtgärd är begränsad till 25 eller färre indata eller utdata.
- Du kan inte använda matristypen för indata eller utdata.
Begränsning för samma klientorganisation
För att säkerställa efterlevnad och lämplig styrning av anpassade färdigheter som registreras för användning i Copilot Studio måste din kunskapsrobot vara ett registrerat program i Microsoft Entra-ID. När du lägger till en färdighet kontrollerar vi om färdighetens program-ID finns i klienten för den inloggade användaren och kompetensslutpunkten matchar det registrerade programmets Home Page URL.
Innan du kan registrera din robot som en färdighet i Copilot Studio måste du se till att för roboten är startsidan i Azure Portal inställd på robotens url för kunskapsmanifest.
Begränsning för en klientorganisation och flera klientorganisationer
Copilot Studio skapade tidigare multitenanta Entra-ID-program. Nu skapar den dock entra-ID-program med en klientorganisation. För att färdigheter ska fungera korrekt med agenterna baserat på nya Entra-ID-program med en enda klientorganisation måste färdigheterna konfigureras för en instans med en enda klientorganisation.
Konvertera en befintlig färdighet från multitenant till en klientorganisation
Du kan konvertera befintliga kunskaper från stöd för flera klienter till stöd för en klientorganisation. Om du vill konvertera en kompetens för flera klienter till en enskild klientorganisation måste du utföra följande ändringar:
- Skapa en ny entra-ID-appregistrering för en klientorganisation
- Uppdatera kunskapskonfigurationen så att den använder en klientorganisation
- Distribuera kunskapen
- (Valfritt) uppdatera källkoden
Följande värden krävs för färdigheter med en enda klientorganisation:
| Egenskap | Värde |
|---|---|
MicrosoftAppType |
SingleTenant |
MicrosoftAppId |
Robotens app-ID |
MicrosoftAppPassword |
Robotens applösenord |
MicrosoftAppTenantId |
Robotens klientorganisations-ID för appen |
Som referens användes följande värden för multitenantkunskaper:
| Egenskap | Värde |
|---|---|
MicrosoftAppType |
MultiTenant |
MicrosoftAppId |
Robotens app-ID |
MicrosoftAppPassword |
Robotens applösenord |
MicrosoftAppTenantId |
Ej tillämpligt; tomt för robotar med flera klientorganisationer |
När du har konverterat värdena importerar du kunskapen till en instans av din agent som skapats som en instans av en enda klientorganisation. Du kan också visa entra-ID-appregistreringen för att se hur den skapades. Gå till Hantera>-autentisering>kontotyper som stöds.
Koduppdatering för flera klientorganisationer till en enda klientorganisation
När du har konverterat värdena kan du också behöva uppdatera koden för att tillåta anslutning av den angivna klientorganisationen till kunskapen. Mer information finns i BotBuilder-Samples.
Validering som utfördes under registreringen av en färdighet
När en slutanvändare försöker ansluta till din kompetens från sin andrepilot måste de först importera kunskapen till Copilot Studio. Dina kunskaper genomgår en rad valideringskontroller. Ett fel vid en av dessa kontroller kan resultera i ett felmeddelande enligt beskrivningen i den här tabellen.
| Verifieringssteg | Felkod | Felmeddelande | Beskrivning eller åtgärd |
|---|---|---|---|
| Manifest-URL:en är giltig |
URL_MALFORMED, URL_NOT_HTTPS |
Länken är inte giltig. Länken måste börja med https:// | Ange länken igen som en säker URL. |
| Manifestet kan hämtas | MANIFEST_FETCH_FAILED |
Vi stötte på problem med att få kunskapsmanifestet. | Kontrollera att manifest-URL:en är en länk till manifestet. försök att öppna manifest-URL:en i en webbläsare. Om URL:en återger sidan inom 10 sekunder omregistrerar du din färdighet. |
| Manifestet kan läsas | MANIFEST_TOO_LARGE |
Manifestet är för stort. | Manifestet måste vara 500 KB eller mindre. |
| Manifestet kan läsas | MANIFEST_MALFORMED |
Manifestet är inte kompatibelt. | Kontrollera om manifestet är en giltig JSON-fil. Kontrollera om manifestet innehåller nödvändiga egenskaper, till exempel name, msaAppIdoch så vidare. Mer information finns i Manifestbegränsningar . |
| Kunskap har ännu inte registrerats | MANIFEST_ALREADY_IMPORTED |
Den här färdigheten har redan lagts till i robot. | Ta bort färdigheten och registrera den igen. |
| Domäner för manifestslutpunkt och startsida matchar | MANIFEST_ENDPOINT_ORIGIN_MISMATCH |
Det finns ett matchningsfel i dina kunskapsslutpunkter. | Microsoft Entra ID-appens URL-domän för startsidan och manifest-URL-domänen måste matcha. Se Begränsning för samma klientorganisation |
| Kunskapen finns i den inloggade användarens klientorganisation | APPID_NOT_IN_TENANT |
Om du vill lägga till en färdighet måste den först registreras. | En administratör måste registrera kompetensen i den inloggade användarens organisation. |
| Åtgärderna är begränsade | LIMITS_TOO_MANY_ACTIONS |
Färdigheten är begränsad till 100 åtgärder. | Det finns för många färdighetsåtgärder definierade i färdighetsmanifest. Ta bort åtgärderna och försök igen. |
| Parametrar för åtgärdsindata är begränsade | LIMITS_TOO_MANY_INPUTS |
Åtgärderna är begränsade till 25 ingångar. | Det finns för många indataparametrar för färdighetsåtgärder. Ta bort parametrar och försök igen. |
| Åtgärdsutdataparametrar är begränsade | LIMITS_TOO_MANY_OUTPUTS |
Åtgärderna är begränsade till 25 utgångar. | Det finns för många utdataparametrar för färdighetsåtgärder. Ta bort parametern och försök igen. |
| Antalet färdigheter är begränsat | LIMITS_TOO_MANY_SKILLS |
Din robot kan ha högst 25 kunskaper. | För många färdigheter har lagts till i en robot. Ta bort en befintlig färdighet och försök igen. |
| Säkerhetstoken är giltig | AADERROR_OTHER |
Det verkar som om något gick fel. | Det kan finnas ett tillfälligt fel för att hämta en säkerhetstoken för att utlösa färdigheten. Försök importera färdigheten igen. |
| Skicklighet är hälsosam |
ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED |
Det gick inte att kontrollera färdigheten. | Copilot Studio fick ett okänt svar när du skickade en EndOfConversation aktivitet till din kompetens. Kontrollera att dina kunskaper körs och svarar korrekt. |
| Kompetens är auktoriserad | ENDPOINT_HEALTHCHECK_UNAUTHORIZED |
Den här färdigheten har inte tillåter att din robot visas. | Kontrollera om roboten är i listan över tillåtna kunskaper. Mer information finns i Copilot Studio hur du konfigurerar en färdighet. |