Implementera en färdighet för användning i Copilot Studio

  • Artikel

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-portalen inställd på robotens url för kunskapsmanifest.

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 global 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.