Atualizar agentes no SharePoint e no OneDrive

Saiba como atualizar suas experiências de agente no SharePoint e no OneDrive. A atualização permite que seus agentes aproveitem o Copilot no SharePoint e toda a funcionalidade do ecossistema de extensibilidade do Microsoft Copilot.

O que está mudando?

A Microsoft está atualizando a experiência do agente no SharePoint e no OneDrive. A atualização alinha melhor seus agentes com o ecossistema de extensibilidade do Microsoft Copilot, garantindo que seus agentes façam parte da experiência inicial do aplicativo do Microsoft Copilot e do registro de plug-in da Microsoft, o catálogo compartilhado para descobrir, publicar e governar plug-ins aprovados pela organização e personalizados em toda Experiências do Microsoft Copilot, aplicativos do Microsoft 365, OneDrive e SharePoint.

Os agentes existentes no formato de arquivo .agent continuarão a funcionar no SharePoint, no Microsoft Teams e no aplicativo Copilot até o final de março de 2027. Você pode começar a atualizar ou mover cada experiência para um caminho compatível que melhor atenda à sua finalidade agora. Após março de 2027, os arquivos .agent deixarão de responder e você terá que atualizar para continuar a usá-los.

O caminho de atualização correto depende do que cada agente ajuda os usuários a realizar hoje:

A partir de meados de novembro de 2026, você usará o Construtor de Agentes do Microsoft Copilot para criar agentes para o SharePoint e o OneDrive. Você ainda pode selecionar o conteúdo do SharePoint e do OneDrive como fontes de conhecimento e usar um prompt fornecido para começar a criar um agente de conversação. No entanto, a criação de um agente não salva mais um arquivo .agent no SharePoint ou no OneDrive. Você pode editar, compartilhar e monitorar seus agentes por meio do aplicativo Copilot e gerenciá-los por meio do Agent 365.

Os agentes do SharePoint e do OneDrive estão sendo desativados?

Não, somente o formato de arquivo .agent está sendo desativado. Você pode continuar a fornecer experiências de conversação nomeadas e tarefas de site focadas com base no conteúdo do SharePoint por meio do Copilot no SharePoint e doMicrosoft Copilot Agent Builder.

A forma como esses agentes são incorporados de volta ao SharePoint mudará com a Web Part do Agent Chat (em breve) como a experiência principal. Os agentes salvos como arquivos .agent deixarão de funcionar após março de 2027.

Por que a Microsoft está fazendo essa alteração?

O Copilot no SharePoint e o ecossistema de extensibilidade do Copilot fornecem uma base consistente para criar, descobrir, compartilhar, governar, monitorar e gerenciar agentes e plug-ins. Os agentes atualizados podem continuar a usar o conteúdo do SharePoint e do OneDrive, com mais opções de personalização, distribuição mais ampla e administração centralizada por meio do Agent 365. As habilidades adicionam recursos focados e reutilizáveis diretamente ao Copilot no SharePoint.

Quais agentes são afetados?

Essa alteração se aplica a agentes armazenados como arquivos .agent no SharePoint ou no OneDrive. No momento, você pode usar esses agentes no painel de chat do SharePoint, por meio da Web Part do Link do Agente, no visualizador imersivo do agente, em um chat ou canal do Microsoft Teams ou no aplicativo Copilot.

Você não precisa recriar agentes do Copilot Studio publicados no SharePoint devido a essa alteração. Revise sua configuração de publicação e publique-os no aplicativo Microsoft Copilot para disponibilizá-los na Web Part do Agent Chat para exibição.

Preciso tomar medidas imediatamente?

Não. Os arquivos .agent existentes continuarão a funcionar até o final de março de 2027. No entanto, você deve começar a planejar sua atualização para aproveitar ao máximo o Copilot no SharePoint, as atualizações de extensibilidade do Copilot e a governança e análise do Agent 365.

O que acontece depois de março de 2027?

Os agentes no formato de arquivo .agent param de responder a prompts:

1. Os arquivos .agent que você adicionou a um chat ou canal do Teams param de responder.

2. Os arquivos .agent que você usou no aplicativo Microsoft Copilot param de responder.

3. No SharePoint e no OneDrive:

   • O acesso a um arquivo .agent (diretamente ou por meio de um link de compartilhamento) exibe uma mensagem indicando que uma atualização é necessária.
   • O agente não abre mais no visualizador imersivo, no aplicativo Copilot ou no painel de chat lateral do SharePoint.
   • O ícone de agentes na navegação do SharePoint não aparece mais.
   • O único agente principal disponível em um site do SharePoint é o Copilot, portanto, essa configuração não é mais necessária e será removida.

Caminhos de atualização

Você pode escolher entre diferentes recursos do Copilot para atualizar com base no que seu agente existente faz e onde as pessoas precisam usá-lo.

Ao atualizar um agente existente do SharePoint ou do OneDrive, considere o resultado que ele fornece hoje e escolha o caminho de atualização que melhor preserva esse resultado. Considere também revisar agentes sem uso recente ou sem proprietário claro para arquivamento ou exclusão, em vez de atualizá-los.

Agentes

Se o arquivo .agent existente fornece uma experiência de Q&R, recuperação ou análise nomeada que os usuários precisam acessar além do site atual do SharePoint, considere criar um agente com Microsoft Copilot Construtor de Agentes.

Os agentes criados por meio do Construtor de Agentes do Microsoft Copilot podem ser usados em experiências compatíveis do Microsoft 365, incluindo o aplicativo Copilot, Teams e SharePoint. Os usuários podem monitorar agentes neste construtor, e os administradores podem controlar, analisar e gerenciar agentes por meio do Microsoft Agent 365.

No SharePoint, os proprietários de sites podem levar os agentes diretamente ao seu público-alvo adicionando-os às páginas em que as pessoas precisam deles usando a Web Part do Agent Chat. Os proprietários do site controlam onde esses agentes aparecem como parte da experiência geral do site. O uso por usuários não licenciados é consolidado no PAYG (pagamento conforme o uso) do aplicativo do Copilot.

Atualizar o agente com o Construtor de Agentes do Microsoft Copilot

O agente é uma experiência personalizada de Q&R, recuperação ou análise com identidade, descrição, prompts iniciais e instruções.

Alguns exemplos:

• Um especialista no assunto nomeado que os usuários reconhecem e revisitam para obter informações

• Usado no SharePoint, Microsoft Copilot e Teams

• Agentes baseados no conteúdo do SharePoint e do OneDrive para cenários de pergunta e resposta usando Geração aumentada por recuperação (Q&A/RAG)

Antes de começar, confirme se você tem o seguinte acesso:

• Editar permissões para o arquivo .agent

• Capacidade de compartilhar esse agente

• Permissão para editar páginas para que uma Web Part do Agent Chat possa ser adicionada à página

Para atualizar:

1. Anote quem tem acesso ao agente e onde o agente é usado.

2. Edite o arquivo .agent.

   

3. Selecione Atualizar para o agente do Microsoft 365. Uma caixa de diálogo de confirmação é exibida.

1. Selecione Atualizar para o agente do Microsoft 365 para confirmar. O Teams e o aplicativo Copilot usarão automaticamente o agente atualizado.

   • Se você planeja adicionar o agente a uma Web Part do Agent Chat da página, selecione Mover arquivo para a Lixeira.

   • Se você quiser continuar usando a configuração do arquivo .agent como o agente principal do site até março de 2027, por meio de uma web part do Link do Agente aberta no painel de chat do SharePoint, não selecione Mover arquivo para a Lixeira.

2. Em uma atualização bem-sucedida, o agente usa o Construtor de Agentes do Microsoft Copilot para todas as atualizações futuras. Você não pode mais editar o arquivo .agent original e ele não será alterado pelo Construtor de Agentes do Microsoft Copilot.

3. Se o agente original foi compartilhado com todos na organização, esse acesso continua no agente atualizado. Caso contrário, o agente será privado para você e você poderá compartilhá-lo com os grupos necessários do Microsoft 365. Verifique se os usuários que precisam do agente podem acessar o agente e as fontes de conhecimento selecionadas.

1. O agente agora está disponível por meio do repositório de plug-ins no aplicativo Copilot, de acordo com as políticas administrativas e de compartilhamento. Nem todo agente atualizado é publicado automaticamente de forma ampla.

Você controla o agente que seu público usa durante o período de transição:

1. Se você não excluir o arquivo .agent original, poderá abri-lo no painel de chat do SharePoint. Se você vincular a ele a partir da Web Part do Link do Agente, defini-lo como o agente principal ou abrir o arquivo diretamente no painel lateral, a configuração original será carregada e os usuários poderão interagir com ele.

   Para direcionar os usuários para o agente atualizado:

• Se o agente original estiver em uma página do SharePoint por meio de um link ou da Web Part do Link do Agente, atualize a página para usar a Web Part do Agent Chat.

• Agentes atualizados não podem ser usados no painel de chat do site, portanto, você não poderá definir um como o agente principal do site. Em vez disso, adicione a Web Part do Agent Chat a uma página, para que ela fique em destaque no site e defina o agente principal como Copilot.

1. No aplicativo Copilot, o agente atualizado é carregado automaticamente quando solicitado.

2. Em um chat ou canal do Teams, o agente é atualizado, mas precisa ser adicionado novamente ao chat ou canal. Remova o agente que está no chat ou canal agora e adicione o agente novamente copiando o link de compartilhamento e postando-o no chat ou canal.

Aqui estão algumas diferenças importantes entre o arquivo .agent e o agente do Microsoft 365:

• Você não gerencia permissões de agente do Microsoft 365 por meio de permissões de site do SharePoint. Definir o acesso de compartilhamento por meio do Construtor de Agentes do Microsoft Copilot. Se você compartilhou o arquivo .agent com todos na organização, pode transferir esse acesso para toda a organização durante a atualização. Caso contrário, o agente atualizado é privado e o criador precisa compartilhá-lo com as pessoas, grupos e endereços de email que precisam acessá-lo no site do SharePoint.

• Os dados de uso começam a ser coletados para o agente atualizado.

Agentes de mecanismo personalizados

Se você tiver um arquivo .agent resultante da publicação de um agente de mecanismo personalizado criado no Copilot Studio no canal do SharePoint, não será necessário recriá-lo como um agente do Construtor de Agentes do Microsoft Copilot.

Para adicionar esses agentes à Web Part do Agent Chat, você precisa disponibilizá-los para o aplicativo Microsoft Copilot e para o canal do Teams. Para obter mais informações sobre publicação, consulte Principais conceitos – Publicar e implantar seu agente – Microsoft Copilot Studio.

Você pode excluir o arquivo .agent depois de adicioná-lo a uma página do SharePoint usando a Web Part do Agent Chat.

Copilot no SharePoint

O Copilot no SharePoint ajuda as pessoas a trabalhar diretamente com o conteúdo em um site do SharePoint.

Se o seu arquivo .agent ajuda principalmente as pessoas a fazer perguntas ou entender o conteúdo do site atual, talvez você não precise manter um agente nomeado separado. Você pode usar o Copilot diretamente no SharePoint.

O Copilot no SharePoint responde a perguntas sobre o conteúdo no site atual do SharePoint. Ele não inclui instruções especiais além de responder com autoridade.

Alguns exemplos:

• Acompanhe-me as alterações mais recentes

• Conte-me mais sobre esse [tópico] neste site

Os usuários precisam de uma licença do Microsoft Copilot para usar o Copilot no SharePoint. Verifique se o Copilot está disponível no site.

Para garantir que os usuários descubram o Copilot no SharePoint, defina o Copilot como o agente principal do site por meio das configurações de IA do site. Ao concluir esta etapa, você pode excluir o arquivo .agent.

Habilidades para Copilot no SharePoint

As habilidades personalizam o que o Copilot no SharePoint pode fazer para obter resultados de negócios específicos.

Um arquivo .agent poderá ser um bom candidato para uma habilidade se executar uma ação, um fluxo de trabalho ou uma tarefa repetível no contexto de um site do SharePoint, em vez de fornecer principalmente uma experiência de P&R. A habilidade deve ser executada somente neste contexto de site e deve ser detectável e executável por meio de interações com o Copilot no SharePoint.

Uma maneira simples de distinguir entre os dois é:

• Use uma habilidade quando o Copilot precisar executar uma tarefa focada e repetível ou um fluxo de trabalho de várias etapas no site do SharePoint.

• Use um agente quando os usuários precisarem de uma experiência personalizada do Copilot para perguntas&respostas, recuperação, análise ou outros cenários.

Alguns exemplos:

• Redigindo um documento do conteúdo do SharePoint neste site.

• Revisando um documento para recomendar atualizações.

• Organizando arquivos para um resultado comercial.

• Aplicar instruções focadas ou proteções a uma tarefa restrita.

Converter o agente em uma habilidade

Antes de começar, verifique se você tem o seguinte:

• Confirme se os usuários pretendidos têm uma licença do Microsoft Copilot. Somente usuários licenciados do Microsoft Copilot podem acessar o Copilot no SharePoint e seus serviços.

• Confirme se o Copilot no SharePoint está disponível no site.

• Confirme se as ações deste agente não precisam estar acessíveis no aplicativo Copilot ou no Teams.

Para converter o agente em uma habilidade:

1. Solicite o uso da habilidade, convert-agent-file-to-skill, com o arquivo de agente .agent ou .copilot. Você terá a opção de criar um site ou uma habilidade pessoal.

2. Para ajudar os usuários a descobrir uma habilidade do site, adicione uma Web Part de botão à página para abrir o Copilot no SharePoint e executar um prompt com a habilidade. Essa etapa é opcional.

3. Você pode excluir o arquivo .agent após a conversão.

Diretrizes de atualização

Quem pode atualizar um agente?

O proprietário do agente, o criador ou o proprietário do site é o mais adequado para decidir o caminho de atualização para o agente. Eles podem tomar a decisão com base em como os usuários descobrem e se envolvem com o agente.

Para atualizar o agente, você precisa:

• Editar permissões para o arquivo .agent

• Capacidade de compartilhar esse agente

• Permissão para editar páginas para que a Web Part do chat do agente possa ser adicionada à página

Para converter em uma habilidade, você precisa do Copilot no SharePoint disponível no site.

Como fazer para encontrar agentes que precisam ser atualizados?

Pessoas com agentes do OneDrive podem priorizar aqueles que usam com mais frequência. Em sites do SharePoint, priorize agentes com alto uso, públicos amplos, cenários comercialmente críticos, instruções personalizadas, dependências pagas conforme o uso, distribuição do Teams ou posicionamento proeminente do SharePoint.

No OneDrive, você pode encontrar seus agentes por meio dos filtros nas pastas Página Inicial, Compartilhado ou Favoritos e no local de salvamento Meus Files>Agentes de Documentos>.

No SharePoint, você tem algumas opções para encontrar seus agentes:

• Como proprietário do agente, visite a seção Agentes de sua propriedade do Build no SharePoint para ver os agentes que você possui e são candidatos à atualização.

  

• Use os relatórios de agentes no Gerenciamento Avançado do SharePoint para inventariar agentes.

• Use o registro de agentes para ver os agentes do "SharePoint".

• Use a pesquisa para encontrar seus agentes no site.

O que devo fazer se eu usar um agente criado por outra pessoa?

Entre em contato com o proprietário do agente ou com o proprietário do site do SharePoint e pergunte se uma substituição está planejada. A permissão para usar um agente não fornece necessariamente as permissões de edição e criação necessárias para atualizá-lo. Confirme se você pode acessar e usar a substituição antes que a experiência do .agent pare de funcionar.

Permissões, compartilhamento e dados

As permissões e o compartilhamento existentes são transferidos automaticamente?

Não. O compartilhamento de um agente do Construtor de Agentes do Microsoft Copilot é separado do compartilhamento de arquivos em um site do SharePoint.

Um arquivo .agent usa permissões de arquivo do SharePoint e pode herdar o acesso de seu site ou biblioteca. Após a atualização, o agente do Construtor de Agentes do Microsoft Copilot usa o compartilhamento em nível de agente para compartilhar com pessoas, grupos e endereços de email, mas não com grupos do SharePoint. Se você compartilhou o arquivo .agent com todos na organização, esse acesso em toda a organização poderá ser transferido durante a atualização. Caso contrário, o agente atualizado será privado até que o proprietário o compartilhe.

Criadores e proprietários devem revisar e compartilhar o agente atualizado ou novo com as pessoas e grupos que verão o agente no site do SharePoint.

O acesso a um agente não concede acesso ao conteúdo subjacente do SharePoint ou do OneDrive. Os usuários devem ter permissão para o agente e as fontes de conhecimento que ele usa.

O que acontece com o histórico de uso e as análises existentes?

O histórico de uso do .agent existente não é transferido para a substituição. A análise da habilidade ou do agente atualizado começa como uma nova experiência. Capture todos os relatórios herdados necessários para registros ou análise de adoção antes de concluir a transição.

O que acontece com os links e posicionamentos existentes?

No SharePoint, atualize a página para usar a Web Part do Agent Chat. Observe que o agente atualizado não pode ser usado no painel de bate-papo do site, portanto, você não poderá defini-lo como o agente principal do site. Defina o agente principal como Copilot depois de adicionar o agente atualizado a uma página.

No aplicativo Copilot, o agente atualizado é carregado automaticamente quando solicitado. Os usuários do OneDrive devem usar o aplicativo Copilot para usar seus agentes.

Em um chat ou canal do Teams, o agente é atualizado, mas precisa ser adicionado novamente ao chat ou canal. Remova o agente que está no chat ou canal agora e, em seguida, adicione o agente atualizado pegando um link para ele e adicionando-o a uma mensagem no chat ou canal.

Como fazer saber se um agente é atualizado?

Excluir o arquivo .agent depois de escolher um caminho de atualização é a maneira mais fácil de rastrear quais agentes ainda precisam ser atualizados.

Se o agente foi convertido em uma habilidade para o site do SharePoint, não há nenhuma indicação no arquivo .agent de que uma conversão ocorreu, mas o arquivo é movido para o local da habilidade como backup.

Se o arquivo .agent foi atualizado para um agente declarativo do Construtor de Agentes do Microsoft Copilot, o construtor de agentes do SharePoint mostrará uma faixa indicando que o agente é atualizado e não é mais editável.

Tempo e preparação

Meu agente existente já se foi?

Não. Você pode usar arquivos .agent existentes durante a transição. O comunicado fornece tempo para inventariar, avaliar, atualizar e testar experiências antes que os arquivos .agent parem de responder aos prompts após março de 2027.

Quando a experiência mudará?

Espere as seguintes alterações a partir de meados de novembro de 2026:

1. Ao criar um agente no SharePoint ou no OneDrive, você usa o Construtor de Agentes do Microsoft Copilot e não cria mais arquivos .agent.

2. O botão Atualizar para o Microsoft 365 Agent aparece no construtor.

3. A habilidade converter arquivo de agente em habilidade fica disponível no Copilot no SharePoint.

Quando os arquivos .agent existentes param de funcionar?

Os arquivos .agent existentes deixarão de responder aos prompts após março de 2027. Após esse período, eles não responderão mais no painel lateral do chat do SharePoint, no Teams ou no aplicativo Copilot. A Web Part do Link do Agente e o visualizador imersivo atual também não fornecerão mais acesso a esses agentes.

Preciso agir agora?

Você não precisa fazer nada agora, mas deve começar a se preparar. Comece com os agentes essenciais para os negócios, usados ativamente, amplamente compartilhados, incorporados em páginas do Microsoft Office SharePoint Online, adicionados ao Teams ou dependentes do consumo pago conforme o uso.

1. Faça o inventário de arquivos .agent no SharePoint e no OneDrive.

2. Identifique o proprietário, o público, a finalidade, as fontes de conhecimento e os pontos de acesso atuais de cada agente.

3. Escolha o caminho de atualização mais adequado.

4. Atualize ou recrie a experiência e configure o compartilhamento e o posicionamento.

5. Teste com usuários representativos e prompts familiares antes de alternar.

6. Arquivo ou exclua o arquivo .agent original após validar a substituição.

A Microsoft atualizará meus agentes automaticamente?

Não. Não há atualização automática. Um proprietário de agente ou proprietário de site deve revisar arquivos .agent e escolher os caminhos de atualização apropriados. Essa abordagem garante que uma experiência de chat nomeada não seja convertida em uma habilidade ou uma tarefa focada no site em um agente mais amplo sem considerar o resultado comercial original. Em alguns casos, o melhor a fazer é excluir o arquivo .agent porque ele não é mais usado. Os arquivos excluídos aparecem na lixeira.

Essas alterações estão disponíveis na Nuvem do Microsoft Government?

Todas essas alterações futuras se aplicam ao Microsoft Government Cloud.

A extensibilidade do Copilot está disponível na Nuvem do Microsoft Government, portanto, a atualização para os agentes declarativos do Construtor de Agentes do Microsoft Copilot preserva as funcionalidades dos agentes.

A conversão em uma habilidade no Copilot no SharePoint estará disponível quando o Copilot no SharePoint estiver disponível na Nuvem do Microsoft Government (em breve).

Diretrizes para administradores

Como os administradores devem se preparar?

Saiba mais sobre o Microsoft Agent 365.

1. Certifique-se de que os criadores do seu agente possam compartilhar esse agente.

2. Identifique arquivos .agent ativos e comercialmente críticos.

3. Engage proprietários de sites e criadores de agentes para atribuir propriedade e escolher um caminho de atualização.

4. Confirme a configuração de licenciamento e consumo de cada destino.

5. Atualize as diretrizes internas, os processos de suporte, o treinamento e as comunicações antes que a experiência de criação mude.

6. Reserve tempo para testar o compartilhamento, o acesso ao conteúdo, o posicionamento do Teams, o posicionamento do SharePoint e os prompts representativos.

Onde os usuários encontrarão agentes atualizados?

Os usuários podem descobrir agentes declarativos e agentes do Copilot Studio por meio de experiências compatíveis do Microsoft 365, incluindo o repositório de plug-ins, o aplicativo Microsoft Copilot e o Teams.

Os proprietários de sites do SharePoint podem colocar agentes relevantes diretamente nas páginas por meio da Web Part do Agent Chat (em breve).

Os usuários descobrem e usam habilidades por meio do Copilot no SharePoint e podem realçá-las com Etapas Rápidas, Web Part de botão ou outros pontos de entrada do site.

O que está acontecendo com o pagamento conforme o uso dos Agentes do SharePoint?

O pagamento conforme o uso dos Agentes do SharePoint só se aplica a arquivos .agent. Os agentes atualizados seguem os recursos e o modelo de licenciamento para agentes no aplicativo Microsoft Copilot.

O pagamento conforme o uso dos Agentes do SharePoint não se aplica ao Copilot no SharePoint.