Partilhar via

Implementar uma habilidade para uso no Copilot Studio

APLICA-SE A: SDK v4

Uma habilidade é um bot que pode ser usado por outro bot. Dessa forma, você pode criar um único bot voltado para o usuário e estendê-lo com uma ou mais habilidades. Você pode aprender mais sobre habilidades em geral em Visão geral de habilidades e como criá-las em Implementar uma habilidade. Como alternativa, os modelos de Assistente Virtual contêm um conjunto de habilidades pré-criadas que você pode personalizar e implantar em vez de criar uma do zero.

Se você espera que sua habilidade seja consumida de um copiloto do Copilot Studio , existem algumas outras restrições colocadas em sua habilidade que você deve considerar.

Restrições de manifesto

O Copilot Studio coloca restrições sobre o que você pode declarar em seu manifesto de habilidade.

  • Você pode declarar apenas 100 ou menos ações.
  • Cada ação é limitada a 25 ou menos entradas ou saídas.
  • Não é possível usar o tipo de matriz para entradas ou saídas.

Restrição do mesmo inquilino

Para garantir a conformidade e a governança adequada das habilidades personalizadas que estão sendo registradas para uso no Copilot Studio, seu bot de habilidades deve ser um aplicativo registrado no Microsoft Entra ID. Ao adicionar uma habilidade, validamos se o ID do aplicativo da habilidade está no locatário do usuário conectado e se o ponto de extremidade de habilidades corresponde ao do aplicativo Home Page URLregistrado.

Antes de registrar seu bot como uma habilidade no Copilot Studio, você deve garantir que, para o bot, a home page no portal do Azure esteja definida como a URL do manifesto de habilidades do bot.

Restrição de inquilino único e multilocatário

O Copilot Studio criou anteriormente aplicativos Entra ID multilocatário. No entanto, agora está criando aplicativos Entra ID de locatário único. Para que as habilidades funcionem corretamente com os agentes com base em novos aplicativos Entra ID de locatário único, as habilidades precisam ser configuradas para uma instância de locatário único. Para obter mais informações, consulte Converter uma habilidade existente de multilocatário para de locatário único ou Atualizar uma habilidade multilocatário para uma habilidade de locatário único.

Validação realizada ao registar uma Habilidade

Quando um usuário final tenta se conectar à sua habilidade a partir de seu copiloto, ele primeiro precisará importar a habilidade para o Copilot Studio. Sua habilidade passa por uma série de verificações de validação. Uma falha de uma dessas verificações pode resultar em uma mensagem de erro, conforme descrito nesta tabela.

Etapa de validação Código de erro Mensagem de Erro Descrição ou atenuação
URL de manifesto é válido URL_MALFORMED, URL_NOT_HTTPS O link não é válido; O link deve começar com https:// Reinsira o link como um URL seguro.
O manifesto é recuperável MANIFEST_FETCH_FAILED Tivemos problemas para obter o manifesto de habilidade. Verifique se o URL do manifesto é um link para o manifesto; tente abrir o URL do manifesto em um navegador da Web. Se o URL renderizar a página em 10 segundos, registre novamente sua habilidade.
O manifesto é legível MANIFEST_TOO_LARGE O manifesto é demasiado grande. Seu manifesto deve ter 500 KB ou menos.
O manifesto é legível MANIFEST_MALFORMED O manifesto é incompatível. Verifique se o manifesto é um arquivo JSON válido. Verifique se o manifesto contém as propriedades necessárias, como name, msaAppIde assim por diante. Consulte Restrições de manifesto para obter mais informações.
A competência ainda não está registada MANIFEST_ALREADY_IMPORTED Essa habilidade já foi adicionada ao seu bot. Exclua a habilidade e registre-a novamente.
Os domínios de ponto de extremidade de manifesto e de página inicial correspondem MANIFEST_ENDPOINT_ORIGIN_MISMATCH Há uma incompatibilidade em seus endpoints de habilidade. O domínio de URL da página inicial do aplicativo Microsoft Entra ID e o domínio de URL de manifesto devem corresponder. Consulte Restrição de mesmo locatário
A habilidade é hospedada no locatário do usuário conectado APPID_NOT_IN_TENANT Para adicionar uma habilidade, ela deve primeiro ser registrada. Um administrador deve registrar a habilidade na organização do usuário conectado.
As ações são limitadas LIMITS_TOO_MANY_ACTIONS A habilidade é limitada a 100 ações. Há muitas ações de habilidade definidas no manifesto de habilidades. Remova as ações e tente novamente.
Os parâmetros de entrada de ação são limitados LIMITS_TOO_MANY_INPUTS As ações estão limitadas a 25 entradas. Há muitos parâmetros de entrada de ação de habilidade. Remova os parâmetros e tente novamente.
Os parâmetros de saída da ação são limitados LIMITS_TOO_MANY_OUTPUTS As ações estão limitadas a 25 realizações. Há muitos parâmetros de saída de ação de habilidade. Remova o parâmetro e tente novamente.
A contagem de habilidades é limitada LIMITS_TOO_MANY_SKILLS Seu bot pode ter um máximo de 25 habilidades. Há muitas habilidades adicionadas a um bot. Remova uma habilidade existente e tente novamente.
O token de segurança é válido AADERROR_OTHER Parece que algo correu mal. Pode haver um erro transitório para adquirir um token de segurança para acionar a habilidade. Tente importar novamente a habilidade.
A habilidade é saudável ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED Algo deu errado ao verificar sua habilidade. O Copilot Studio recebeu uma resposta desconhecida ao enviar uma EndOfConversation atividade para sua habilidade. Certifique-se de que o registro do aplicativo de uma habilidade de locatário único foi implantado no mesmo locatário no qual o agente foi criado.
A habilidade é autorizada ENDPOINT_HEALTHCHECK_UNAUTHORIZED Essa habilidade não permitiu listar seu bot. Verifique se o seu bot está na lista de permissões da habilidade. Para obter mais informações, consulte o Copilot Studio como configurar uma habilidade.
  • Last updated on