Você usa o Copilot no Word para redigir, reescrever e resumir documentos. Ao mudar para o Word para a Web, alguns suplementos podem parar de funcionar ou se comportar de forma diferente. Este artigo lista quais tipos de suplementos são compatíveis quando o Copilot está ativo no Word para a Web. Também explica os motivos técnicos por trás das limitações de compatibilidade e oferece etapas de configuração para administradores.
Os suplementos estendem a funcionalidade do Word por meio de painéis de tarefas, controles de conteúdo e faixas de opções personalizadas. O Copilot no Word para a Web é executado em uma plataforma isolada (sandbox) que restringe certas capacidades dos suplementos. Entender essas restrições ajuda você a planejar seus fluxos de trabalho de documentos e evitar erros inesperados.
Esta referência aborda categorias de suplementos, requisitos de versão e limitações conhecidas. Também inclui uma tabela de comparação para tomada de decisão rápida e dicas de solução de problemas para falhas comuns.
Principais Conclusões: Compatibilidade do Copilot e Suplementos no Word para a Web
- Esquema de manifesto de suplemento v1.1 para Word para a Web: Apenas suplementos que usam esta versão de esquema são compatíveis quando o Copilot está habilitado.
- Suplementos de painel de tarefas com modo somente leitura: Funcionam junto com o Copilot, mas não podem modificar o documento enquanto o Copilot está gerando conteúdo.
- Suplementos de conteúdo que incorporam objetos externos: São bloqueados quando o Copilot está processando ativamente um comando para evitar conflitos de dados.
Por que a Compatibilidade de Suplementos Difere entre Desktop e Web
O Copilot no Word para a Web é executado em um ambiente baseado em navegador que impõe limites de segurança rigorosos. A plataforma Web usa um runtime JavaScript em sandbox que limita o acesso direto ao modelo de objeto do documento. Suplementos que dependem da biblioteca Office.js versão 1.2 ou anterior não conseguem se comunicar com o Copilot porque o Copilot usa uma superfície de API mais recente para colaboração em tempo real.
Restrições da Sandbox
O Word para a Web isola cada suplemento em seu próprio iframe. O Copilot opera em um iframe separado com privilégios elevados para processamento de IA. Quando um suplemento tenta ler ou gravar o documento enquanto o Copilot está executando uma tarefa de geração, a plataforma enfileira a solicitação e retorna um erro se o tempo limite exceder 500 milissegundos. Isso afeta suplementos que realizam verificação ortográfica contínua, sugestões gramaticais ou funções de salvamento automático.
Requisitos de Versão da API
Os suplementos devem ter como alvo o Office.js versão 1.3 ou superior para registrar manipuladores de eventos que coexistam com o Copilot. Suplementos criados na versão 1.1 ou 1.2 não podem assinar o evento Document.ActiveViewChanged, que o Copilot usa para pausar suas próprias operações. Como resultado, esses suplementos mais antigos podem fazer com que o Copilot congele ou produza saída parcial.
Etapas para Verificar e Configurar a Compatibilidade de Suplementos
Siga estas etapas para verificar se um suplemento funcionará quando o Copilot estiver ativo no Word para a Web. Execute estas ações no centro de administração do Microsoft 365 ou diretamente no navegador.
- Abra o arquivo de manifesto do suplemento
Localize o arquivo de manifesto XML do suplemento. O arquivo geralmente é nomeadomanifest.xmle é carregado no centro de administração do Microsoft 365 ou distribuído pelo AppSource. - Verifique a versão do esquema
Procure o atributoxmlnsno elemento raizOfficeApp. O valor deve serhttp://schemas.microsoft.com/office/appforoffice/1.1ou posterior. Se a versão for 1.0, o suplemento não é compatível. - Verifique o nível de permissões
No manifesto, encontre o elementoPermissions. O valor deve serReadWriteDocumentouReadAllDocument. Suplementos com permissãoRestrictednão podem interagir com o Copilot. - Teste no Word para a Web com o Copilot desativado
Abra um documento no Word para a Web. Desative o Copilot clicando no ícone do Copilot na faixa de opções e selecionando Desativar. Insira o suplemento pelo menu Inserir > Suplementos. Se o suplemento carregar sem erros, prossiga para a próxima etapa. - Ative o Copilot e execute um comando
Reative o Copilot. Digite um prompt como Resumir este documento. Aguarde a saída. Se o suplemento continuar funcionando, ele é compatível. Se o painel do suplemento mostrar um ícone de carregamento ou uma mensagem de erro, o suplemento não é compatível.
Se o Copilot e um Suplemento Entrarem em Conflito no Word para a Web
O Copilot gera conteúdo, mas o painel do suplemento exibe uma tela em branco
Isso ocorre quando o suplemento usa o método Office.context.document.getFileAsync para recuperar o documento. O Copilot bloqueia o fluxo do documento durante a geração. O suplemento deve aguardar a conclusão do Copilot. Para corrigir, desative o suplemento ao usar o Copilot ou atualize o suplemento para usar o método Office.context.document.getSelectedDataAsync.
Botões do suplemento na faixa de opções ficam esmaecidos após o Copilot ser executado
O Copilot eleva temporariamente sua própria prioridade na faixa de opções. Suplementos que não declaram um elemento RibbonTab no manifesto perdem seu estado ativo. Verifique o manifesto do suplemento em busca de um elemento RibbonTab com um atributo StartupBehavior definido como Load. Se o elemento estiver ausente, entre em contato com o fornecedor do suplemento para obter uma atualização.
O Copilot retorna saída genérica em vez de dados específicos do locatário
Alguns suplementos modificam os metadados ou cabeçalhos do documento. O Copilot lê o contexto do documento a partir das propriedades do arquivo. Se um suplemento alterar os campos Assunto ou Marcadores, o Copilot pode perder a base. Remova o suplemento, salve o documento e execute o Copilot novamente. Se o problema for resolvido, o suplemento está interferindo nas propriedades do documento.
Copilot no Word para a Web vs Desktop: Diferenças de Compatibilidade de Suplementos
| Item | Word para a Web com Copilot | Word Desktop com Copilot |
|---|---|---|
| Esquema de manifesto do suplemento | v1.1 ou posterior necessário | v1.0 ou posterior compatível |
| Suplementos de painel de tarefas | Somente leitura durante a geração do Copilot | Acesso total de leitura/gravação |
| Suplementos de conteúdo | Bloqueados quando o Copilot está ativo | Permitidos com operações em fila |
| Suplementos de email | Não compatível | Não compatível |
| Guias personalizadas da faixa de opções | Desabilitadas durante comandos do Copilot | Habilitadas durante todo o tempo |
| Versão mínima do Office.js | 1.3 | 1.1 |
| Manipuladores de eventos compatíveis | Apenas Document.ActiveViewChanged | Todos os eventos de documento |
Agora você pode identificar quais suplementos funcionam com o Copilot no Word para a Web e quais não funcionam. Verifique o manifesto de cada suplemento em relação aos requisitos de esquema e permissões listados acima. Para suplementos que falham no teste de compatibilidade, solicite ao fornecedor uma atualização que tenha como alvo o Office.js versão 1.3 ou posterior. Como etapa avançada, use o centro de administração do Microsoft 365 para implantar suplementos com uma política de lançamento direcionada, para que você possa testar novas versões antes de distribuí-las a todos os usuários.