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.
Este artigo fornece informações sobre problemas conhecidos relacionados à extensibilidade do Microsoft 365 Copilot e possíveis soluções alternativas.
Agentes declarativos
Os problemas conhecidos a seguir se aplicam a agentes declarativos.
Os fluxos do Power Automate não têm suporte total como ações em agentes declarativos
Os fluxos do Power Automate como ações em agentes declarativos podem não ser executados de forma confiável e podem não retornar resultados. Em alguns casos, os fluxos recém-criados podem não aparecer na interface Adicionar Ação no Copilot Studio, mesmo que o contador de ação reflita sua presença.
Solução alternativa: Atualmente, nenhuma solução alternativa está disponível para o problema de que os fluxos podem não retornar resultados. Você pode melhorar o sucesso do gatilho para o fluxo editando a descrição na página de detalhes do fluxo fora do Copilot Studio.
Esse problema se aplica a links de qualquer fonte de conteúdo, incluindo SharePoint, conectores do Microsoft 365 Copilot e plug-ins.
Não há suporte para Prompts obter uma lista com base em metadados personalizados
Não há suporte para Prompts obter uma lista de itens com base em metadados personalizados. Por exemplo, o prompt "Obter uma lista de tíquetes do ServiceNow atribuídos a mim", em que Atribuído a é baseado em metadados personalizados, não funciona porque os metadados não são mapeados para propriedades de rótulo de esquema de conexão.
Solução alternativa: Esse problema atualmente não tem uma solução alternativa. Você pode obter itens com base em correspondências com o título ou a descrição do item do conector.
Os arquivos do SharePoint com caracteres nulos no nome do arquivo não retornam resultados
Se um arquivo do SharePoint usado como uma fonte de conhecimento contiver caracteres nulos no nome do arquivo, o agente não retornará nenhum resultado com base nessa fonte de conhecimento.
As fontes de conhecimento do SharePoint podem falhar nas respostas do agente
Agentes declarativos baseados em fontes de conhecimento do SharePoint podem ser provisionados com êxito, mas falhar em tempo de execução com a seguinte mensagem:
"Desculpe, não consegui responder."
Esse problema pode ocorrer quando o usuário conectado não tiver uma licença do Microsoft 365 Copilot. As fontes de conhecimento do SharePoint e do OneDrive exigem uma licença ativa do Copilot.
As contas de locatário de demonstração da Experiência Digital do Cliente (CDX) sem uma licença do Copilot podem criar e publicar agentes, mas a recuperação fundamentada falha silenciosamente e dispara o erro genérico de tempo de execução. Os desenvolvedores que testam o fundamento do SharePoint em locatários que não são de produção devem usar a Licença de Desenvolvedor do Microsoft 365 Copilot, que inclui o acesso necessário ao Graph e ao SharePoint.
Se a licença correta for atribuída, mas o aterramento ainda falhar, verifique se:
- O usuário conectado pode acessar a URL do site do SharePoint definida no
items_by_url. - A conexão do agente usa autenticação de usuário. Não há suporte para entidades de serviço em cenários de aterramento do SharePoint.
- O usuário tem pelo menos permissões de Leitura no site do SharePoint de destino.
Falhas de aterramento silencioso geralmente ocorrem quando as configurações de licenciamento, permissões ou autenticação estão incompletas.
As URLs retornadas por um agente declarativo desaparecem nas @mention respostas no Microsoft 365 Copilot
Ao invocar um agente declarativo por meio de um @mention no Microsoft 365 Copilot, você pode ver URLs removidas, ocultas ou rebaixadas para texto sem formatação. Esse problema ocorre porque o @mention pipeline aplica uma limpeza de saída mais rigorosa para bloquear links não seguros ou não verificados em contextos compartilhados, como Word, Excel, PowerPoint, Outlook e Teams.
Solução alternativa:
Tente uma das seguintes abordagens:
Evite retornar URLs simples, pois é mais provável que elas sejam removidas. Forneça texto de navegação quando o link for opcional. Por exemplo, acesse Painel Mensalde Relatórios> do Portal>da Contoso.
Retorne URLs dentro de campos JSON estruturados em respostas de plug-in de API. Esses campos são higienizados de forma menos agressiva que o texto em linguagem natural.
Use a formatação
(https://contoso.com/dashboard)de link Markdown ou a notação de colchete(<https://contoso.com/dashboard>)angular.
Agentes de compartilhamento de dentro do Microsoft 365 Copilot podem falhar
Quando você compartilha um agente por meio do Microsoft 365 Copilot usando a opção Usuários específicos em sua organização, os resultados da pesquisa podem incluir grupos de distribuição. Compartilhar um agente com um grupo de distribuição pode fazer com que o compartilhamento falhe.
Alguns recursos não têm suporte em locatários do Microsoft 365 Government
Atualmente, não há suporte para os seguintes recursos em locatários do Microsoft 365 Government :
- Ações personalizadas autenticadas.
- Suporte para cobrança de uso para recursos de extensibilidade. Para obter detalhes sobre recursos que exigem faturamento de uso, consulte Recursos do agente e modelos de licenciamento.
- Suporte para agentes de publicação por meio do Kit de ferramentas de agentes do Microsoft 365.
Conectores do Copilot
Os seguintes problemas conhecidos se aplicam aos conectores do Copilot.
Não há suporte para Prompts obter itens com base em metadados personalizados
Não há suporte para Prompts obter uma lista de itens com base em metadados personalizados. Por exemplo, o prompt "Obter uma lista de tíquetes do ServiceNow atribuídos a mim" não funciona quando "Atribuído a" é um metadados personalizados porque o campo não é mapeado para propriedades de rótulo do esquema de conexão.
Plug-ins de API
Os problemas conhecidos a seguir se aplicam a plug-ins de API.
Não há suporte para alguns recursos do OpenAPI
Os seguintes recursos do OpenAPI não têm suporte para plug-ins de API:
- Objetos aninhados em corpos de solicitação de método de API ou parâmetros.
- Referências polimórficas (
oneOf,allOf,anyOf) e referências circulares. Como alternativa, use um esquema nivelado. - Chaves de API em cabeçalhos personalizados, parâmetros de consulta ou cookies.
- Fluxos de concessão OAuth diferentes do Authcode básico e do PKCE Authcode.
- Fluxos de autenticação dupla (OAuth/SSO do Entra + token de portador HTTP) para um único ponto de extremidade de API.
- Configurações da interface do usuário para redefinir sempre permitir estados. Como solução alternativa, desinstale o aplicativo para redefinir o estado de permissão.
- Interface do usuário de configurações para sair. Como solução alternativa, desinstale o aplicativo para redefinir o estado de permissão ou implemente uma função que o usuário possa invocar usando linguagem natural.
- Semântica de várias respostas para uma única função.
- Ações de card adaptativo OpenURL e ToggleVisibility na semântica de resposta.
- Módulos de tarefas e exibições de estágio na semântica de resposta.
Agentes de mecanismo personalizados
A tabela a seguir lista os recursos que atualmente não têm suporte para agentes de mecanismo personalizado executados no Microsoft 365 Copilot. Esses problemas se aplicam a agentes de mecanismo personalizados criados usando o Microsoft 365 Agents Toolkit e o SDK de Agentes do Microsoft 365.
| Recurso | Problema |
|---|---|
| Comentários | Os comentários dos usuários sobre as respostas do agente não são compartilhados com o desenvolvedor. |
| Contexto da conversa | Os agentes de mecanismos personalizados não conseguem acessar o histórico de conversas do Copilot que ocorreu antes de o usuário acessar o agente por meio do @mention. |
| Mensagens de chat | Os usuários não podem editar mensagens de chat enviadas ou retornadas pelo agente. As mensagens de resposta do agente não dão suporte a HTML. As mensagens no Microsoft 365 Copilot são imutáveis e não há suporte para a updateActivity API. |
| Anexos de arquivo | Os agentes de mecanismo personalizado não dão suporte a anexos de arquivo ou imagem em chats de agente. As imagens carregadas no chat não são passadas ao agente para processamento. Não há suporte para cenários que exigem que os usuários carreguem imagens para um agente de mecanismo personalizado, como extrair texto de uma imagem carregada. |
| Downloads de arquivos | Não há suporte para downloads de arquivos para agentes de mecanismos personalizados no Microsoft 365 Copilot. Um agente de mecanismo personalizado que gera um arquivo, como uma pasta de trabalho do Excel, não renderiza um arquivo clicável e para download no Microsoft 365 Copilot; o arquivo aparece como um texto não interativo ou como uma área de download vazia. O mesmo agente renderiza o arquivo corretamente no Microsoft Teams e no painel de teste do Copilot Studio, portanto, esse comportamento é específico do canal do Microsoft 365 Copilot, em vez de uma falha na geração de arquivos ou na renderização downstream. |
| Cartões ricos | Não há suporte para os seguintes elementos de rich cards:
|
| Notificações proativas | Não há suporte para notificações proativas. |
| Citações | Os seguintes tipos de citação não são suportados:
|
| Cartões Adaptáveis | Os Cartões Adaptáveis atualizados usando Action.Execute não persistem o conteúdo atualizado quando o chat é reaberto; O card original é mostrado. Os fluxos de trabalho dos agentes no Copilot Chat devem usar mensagens de acompanhamento em vez de depender de edições de mensagens. Não há suporte para os seguintes elementos de Cartões Adaptáveis:
|
| Rótulos de confidencialidade | Não há suporte para rótulos de confidencialidade. |
| Suporte ao aplicativo Microsoft 365 | Os agentes de mecanismo personalizado não têm suporte no Outlook, no Word, no Excel, no PowerPoint e no navegador Microsoft Edge. |
Agentes do Copilot Studio
Os problemas conhecidos a seguir se aplicam a agentes criados com o Copilot Studio e adicionados ao Microsoft 365 Copilot ou ao Microsoft Teams.
Os agentes que usam um modelo de terceiros retornam um erro "Agente Bloqueado"
Um agente que você adiciona ao Microsoft 365 Copilot ou ao Microsoft Teams retorna um erro "Agente Bloqueado" em resposta a prompts. A mensagem de erro na tela sugere atualizar o agente para usar outro modelo de linguagem grande (LLM) disponível para você.
Esse problema ocorre quando o agente é configurado para usar um modelo de terceiros, como o Claude Sonnet 4.6, que é um modelo da Anthropic. Os modelos Anthropic são fornecidos por um provedor de IA que opera como um subprocessador da Microsoft. Um administrador deve habilitar o acesso a esses modelos e concedê-lo aos usuários. Na UE, o acesso está desativado por padrão. Os usuários que não têm acesso ao modelo recebem o erro "Agente Bloqueado".
Solução alternativa: Escolha uma das opções a seguir.
Opção A: manter o modelo atual e conceder acesso. Um Administrador de IA ou Administrador Global executa as seguintes etapas:
- No Centro de administração do Microsoft 365, acesseConfigurações> do Copilot>Exibir tudo.
- Abra provedores de IA operando como subprocessadores da Microsoft.
- Selecione o provedor de IA para seu modelo.
- Em Escolha quem pode acessar..., adicione os usuários afetados ou, preferencialmente, o grupo de segurança do Microsoft Entra ao qual os usuários pertencem e selecione Salvar. As atribuições dão suporte a usuários individuais, grupos de segurança e grupos aninhados.
- Aguarde de 10 a 15 minutos para que a atribuição seja propagada e, em seguida, faça com que um usuário afetado tente executar o agente novamente.
Opção B: Mude o agente para um modelo diferente para um desbloqueio imediato. No Copilot Studio, edite a configuração do modelo do agente (IA generativa) e altere-a do modelo de terceiros para o modelo padrão da Microsoft. Essa alteração disponibiliza o agente para todos os usuários atribuídos imediatamente, sem uma atribuição de acesso da Anthropic.
Os agentes respondem lentamente ou retornam um "Falhou. Mensagem "Repetir"
Um agente do Copilot Studio publicado no SharePoint ou no Microsoft Teams responde de forma lenta e inconsistente. Às vezes, o indicador Envio é substituído por Falha. Tentar novamente; selecionar Tentar novamente reenvia o prompt.
Vários fatores contribuem para quanto tempo uma resposta leva e quanto tempo ela parece para o usuário, incluindo o modelo que o agente usa, o número de fontes de conhecimento que o agente pesquisa e como o canal host entrega mensagens.
Solução alternativa:
Tente uma ou mais das seguintes abordagens:
Alterne o agente para um modelo marcado como Geral em vez de Profundo. Os modelos gerais são otimizados para menor latência nas tarefas diárias. Para obter mais informações, consulte Selecionar um modelo de IA primário para seu agente. Os modelos de terceiros exigem um administrador para conceder acesso. Para obter mais informações, consulte Agentes que usam um modelo de terceiros retornam um erro "Agente bloqueado".
Se o agente usar fontes de conhecimento do SharePoint, reduza o número de fontes. Menos fontes produzem um contexto menor de resultados de pesquisa, que o modelo processa mais rapidamente.
Se os usuários acessarem o agente pelo SharePoint, use um canal do Microsoft Teams. O Teams dá suporte a indicadores de digitação e entrega progressiva de mensagens, o que reduz a latência percebida. O SharePoint não transmite respostas e entrega a mensagem em um único lote.
Os agentes no Microsoft Teams retornam uma mensagem "Você não tem acesso para falar com este bot"
Os usuários podem encontrar e instalar um agente na loja do Microsoft Teams, mas quando enviam um prompt, o agente responde com "Você não tem acesso para falar com este bot, entre em contato com o proprietário". Os usuários não recebem outras respostas.
Esse problema pode ocorrer quando o agente é instalável, mas não está autorizado para o usuário, pois as configurações do aplicativo de locatário ou o compartilhamento do agente não concederam acesso ao usuário.
Resolução: Conclua as etapas a seguir.
- No Centro de administração do Microsoft Teams, acesse Aplicativos> do TeamsGerenciar aplicativos>Ações>Configurações do aplicativo para toda a organização. Em Aplicativos personalizados, ative Permitir que os usuários instalem e usem aplicativos disponíveis por padrão e Permitir que os usuários interajam com aplicativos personalizados na visualização. Para obter mais informações, consulte Gerenciar configurações de aplicativos em toda a organização e Permitir que os usuários carreguem aplicativos personalizados.
- No Centro de administração do Teams, acesse Aplicativos> do Teams,Gerenciar aplicativos e permitir o aplicativo Power Apps Compartilhado. Este aplicativo da Microsoft disponibiliza o conteúdo compartilhado do Power Platform no Teams, incluindo agentes do Copilot Studio em Compilado com Power Platform. Para obter mais informações, consulte Permitir ou bloquear aplicativos.
- No Copilot Studio, compartilhe o agente com os usuários afetados. Para obter mais informações, consulte Agentes de compartilhamento.
- Se o agente usar um agente conectado, confirme se os usuários também têm permissão para acessar o agente conectado. Para obter mais informações, consulte Agentes de compartilhamento.
Os agentes no Microsoft Teams não respondem quando o registro do aplicativo Microsoft Entra está ausente
Um agente que você implanta no Microsoft Teams não responde. Esse problema pode ocorrer quando o registro do aplicativo Microsoft Entra do agente, que é a identidade do agente no Microsoft Entra ID, está ausente no diretório de locatários.
Resolução: Escolha uma das opções a seguir.
Opção A: Republicar o agente no canal do Microsoft Teams. No Copilot Studio, abra o agente, vá para Canais> doMicrosoft Teams, desconecte o canal do Teams, aguarde de um a dois minutos, reconecte o canal e publique o agente novamente. A republicação deve disparar o fluxo de provisionamento de identidade para detectar o registro de aplicativo ausente e recriá-lo.
Opção B: Se a Opção A não restaurar o agente, recrie o agente. No Copilot Studio, crie um novo agente, migre os tópicos e a configuração do agente original e publique o novo agente no Microsoft Teams.
Os agentes que trabalham no Copilot Studio não respondem no Microsoft Teams
Um agente responde no Copilot Studio, mas não responde aos usuários no Microsoft Teams. Esse problema pode ocorrer quando a política do aplicativo de locatário bloqueia a interação dos usuários com aplicativos personalizados.
Resolução: No Centro de administração do Teams, acesse Aplicativos> do TeamsGerenciar aplicativos>Ações>Configurações de aplicativos em toda a organização e defina Permitir que os usuários interajam com aplicativos personalizados na visualização comoAtivado. Para obter mais informações, consulte Permitir que os usuários carreguem aplicativos personalizados.