Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Note
Este artigo descreve recursos usados em agentes ou fluxos de agentes baseados no harness padrão.
Important
Este artigo inclui informações sobre Azure Serviço de Bot skills, uma forma baseada em código de expandir as capacidades de um agente no harness padrão. As habilidades do Azure Serviço de Bot são diferentes de:
- Habilidades de agentes, habilidades baseadas em instruções que você adiciona aos agentes impulsionados pelo GitHub Copilot ou pelo arcabouço de Conversas com Clientes. Saiba mais na visão geral de Habilidades para agentes.
- Habilidades em plugins, uma funcionalidade que um plugin do Microsoft 365 Copilot pode incluir. Saiba mais em Habilidades como recursos de plug-in.
Copilot Studio permite que você expanda seu agente usando Azure Serviço de Bot habilidades. Se você já tem agentes construídos e implantados na sua organização (usando o SDK de Agentes do Microsoft 365 ou outras ferramentas de código profissional) para cenários específicos, pode converter esses bots em habilidades do Azure Serviço de Bot e registrar as habilidades em um agente do Copilot Studio.
Note
Para adicionar uma habilidade do Azure Serviço de Bot dentro do aplicativo Copilot Studio em Microsoft Teams, você precisa ter uma assinatura independente do Microsoft Copilot Studio.
Este artigo é destinado a administradores de sistemas ou profissionais de TI familiarizados com habilidades do Azure Serviço de Bot.
Depois de registrar uma habilidade do Azure Serviço de Bot com um agente do Copilot Studio, você pode acionar as ações da habilidade do Azure Serviço de Bot na conversa sem problemas.
Prerequisites
Important
Os agentes do Copilot Studio suportam apenas habilidades do Azure Serviço de Bot construídas usando o Legacy Bot Framework SDK versão 4.12.0+ e SDK de Agentes do Microsoft 365 v1.0.0+. Novas habilidades Azure Serviço de Bot devem ser desenvolvidas usando SDK de Agentes do Microsoft 365.
Para configurar uma habilidade Azure Serviço de Bot, defina o registro associado do aplicativo em Microsoft Entra ID para sua habilidade na configuração de inquilino único.
Quando usar fluxos de agentes ou habilidades do Azure Serviço de Bot
A tabela a seguir ajuda você a determinar quando usar fluxos de agentes ou skills do Azure Serviço de Bot para uma conversa.
| Fator | Quando usar fluxos de agentes | Quando usar as habilidades do Azure Serviço de Bot |
|---|---|---|
| Persona | Os criadores de agente podem criar fluxos reutilizáveis para inseri-los em qualquer conversa do agente. | Desenvolvedores podem criar, implantar e hospedar habilidades de Azure Serviço de Bot personalizadas em seu próprio ambiente. |
| Tipo de conversação | Use fluxos para operações simples de um turno. Por exemplo, fazer um pedido ou obter o status do pedido. | Use habilidades do Azure Serviço de Bot para operações complexas de vários turnos. Por exemplo, agendar uma reunião ou reservar um voo. |
| Resposta | Use fluxos para emitir uma resposta do agente. Por exemplo, mostrar uma mensagem personalizada ou imagens integradas. | Use habilidades do Azure Serviço de Bot para gerar qualquer resposta de agente compatível. Por exemplo, mostre um cartão adaptável ou envie respostas aleatórias. |
| Ações | Use fluxos para disparar ações de turno único no servidor. Por exemplo, chame uma API HTTP ou dispare um conector personalizado. | Use as habilidades do Azure Serviço de Bot para acionar eventos e ações no lado do servidor e no lado do cliente. Por exemplo, acesse uma página após a resposta do agente. |
Configure uma habilidade do Azure Serviço de Bot
Primeiro, use Copilot Studio para criar um agente e criar e implantar uma habilidade Azure Serviço de Bot usando ferramentas pro-code na sua organização. Consulte estes exemplos:
Antes de registrar a habilidade do Azure Serviço de Bot, dê o ID do agente ao seu desenvolvedor da habilidade para que ele possa autorizar o agente a chamar ações na habilidade. Saiba mais sobre a lista de permissão para uma habilidade Azure Serviço de Bot. Você pode obter seu ID de agente na janela Adicionar uma habilidade .
Para adicionar uma habilidade do Azure Serviço de Bot ao seu agente:
Vá para o seu agente.
Selecione Configurações>.
Selecione Adicionar uma habilidade.
Copie o ID do agente. Você precisa fornecer o ID do agente ao seu desenvolvedor de habilidades.
Insira a URL do manifesto de habilidade do Azure Serviço de Bot. O manifest de uma habilidade contém as informações que seu agente precisa para acionar ações dentro da habilidade.
Selecione Avançar para iniciar o processo de validação. Quando a validação é bem-sucedida, sua habilidade é adicionada ao seu agente. Agora você pode usar essa habilidade em seus tópicos.
Considerações de conformidade
Para proteger a privacidade do usuário, você deve registrar uma habilidade Azure Serviço de Bot como app no Microsoft Entra ID do usuário logado.
Solucionar erros durante o registro de habilidade do Azure Serviço de Bot
O sistema executa uma série de verificações de validação na URL. Essas verificações garantem conformidade, governança e usabilidade da habilidade que você adiciona ao seu agente. Você deve corrigir esses erros antes de registrar uma habilidade do Azure Serviço de Bot.
| Mensagem de erro | Solucionar problemas/mitigação |
|---|---|
| Tivemos problemas para conseguir o manifesto de habilidades. ( MANIFEST_FETCH_FAILED) |
Tente abrir a URL do seu manifesto em um navegador da Web. Se o URL renderizar a página em 10 segundos, registre novamente a habilidade. |
| O manifesto é incompatível. ( MANIFEST_MALFORMED) |
(a) Verifique se o manifesto é um arquivo JSON válido. (b) Verificar se o manifesto contém propriedades exigidas Por exemplo, ( name, msaAppId, single endpoint, activities/id, activities/description,activities/type (apenas event ou message suportado)). |
| Há um descompasso nos seus endpoints ( MANIFEST_ENDPOINT_ORIGIN_MISMATCH) |
Verifique se o endpoint da sua habilidade corresponde ao campo Publisher domain (preferencial) ou Home page URL no registro do aplicativo Microsoft Entra ID.
Saiba mais sobre como definir a página inicial para endpoints. |
| Para adicionar uma habilidade, ela deve primeiro ser registrada ( APPID_NOT_IN_TENANT) |
Verifique se o ID do aplicativo da sua habilidade está registrado no tenant Microsoft Entra ID da sua organização. |
| O link não é válido; O link deve começar com https:// ( URL_MALFORMED, URL_NOT_HTTPS) |
Revise o link para adicionar uma URL segura. |
| O manifesto é grande demais; ( MANIFEST_TOO_LARGE) |
Verifique o tamanho do manifesto. Ele deve ser menor ou igual a 500 KB. |
| Esta habilidade já foi adicionada ao seu agente. ( MANIFEST_ALREADY_IMPORTED) |
Exclua a habilidade e tente registrá-la novamente. |
| A habilidade está limitada a 100 ações. ( LIMITS_TOO_MANY_ACTIONS) |
Existem muitas ações de habilidade definidas no manifesto da habilidade. Remova as ações e tente novamente. |
| As ações são limitadas a 25 entradas. ( LIMITS_TOO_MANY_INPUTS) |
Existem muitos parâmetros de entrada de ação da habilidade. Remova os parâmetros e tente novamente. |
| As ações são limitadas a 25 resultados. ( LIMITS_TOO_MANY_OUTPUTS) |
Existem muitos parâmetros de saída de ação de habilidade. Remova os parâmetros e tente novamente. |
| Seu agente pode ter, no máximo, 100 habilidades. ( LIMITS_TOO_MANY_SKILLS) |
Existem demasiadas habilidades atribuídas a um agente. Remova uma habilidade existente e tente novamente. |
| Parece que algo deu errado. ( AADERROR_OTHER) |
Ocorreu um erro transitório ao validar sua habilidade. Tente novamente. |
| Ocorreu um erro ao verificar sua habilidade. ( ENDPOINT_HEALTHCHECK_FAILED, HEALTH_PING_FAILED) |
Verifique se o ponto de extremidade de sua habilidade está online e respondendo a mensagens. Verifique também se o registro do aplicativo da habilidade de locatário único tenha sido implantado no mesmo locatário. |
| Esta habilidade não adicionou seu agente à lista de permissões ( ENDPOINT_HEALTHCHECK_UNAUTHORIZED) |
Verifique se seu agente foi adicionado à lista de permissão da habilidade. |