Introdução ao Agente de Conhecimento (pré-visualização)

Observação

Este artigo aplica-se à versão de pré-visualização do Agente de Conhecimento no SharePoint.

O Agente de Conhecimento não é atualmente suportado no Microsoft 365 Government – GCC, GCC High, DoD ou Office 365 ambientes de cloud com disponibilidade aérea.

O Agente de Conhecimento é uma capacidade incorporada do SharePoint concebida para ajudar a sua organização a preparar conteúdos para IA. Melhora, organiza e mantém os conteúdos do SharePoint num formato estruturado e autoritativo, otimizado para Microsoft 365 Copilot agentes.

Para inquilinos elegíveis, é apresentado um novo botão de agente no canto inferior direito das superfícies do SharePoint, o que dá aos utilizadores elegíveis acesso a funcionalidades avançadas de IA. Estes incluem o melhoramento automatizado de conteúdo, a otimização de metadados e o resumo inteligente de páginas.

Pré-requisitos

• Um Administrador do SharePoint (ou Administrador Global) tem primeiro de ativar o Agente de Conhecimento (pré-visualização).

  Importante

  A Microsoft recomenda que você use funções com o menor número de permissões. Usar contas com menos permissões ajuda a melhorar a segurança da sua organização. O Administrador Global é uma função altamente privilegiada que deve ser limitada a cenários de emergência quando não for possível usar uma função existente. Para saber mais, veja Acerca das funções de administrador no Centro de administração do Microsoft 365.

• Para utilizar a funcionalidade, os utilizadores têm de ter uma licença de Microsoft 365 Copilot atribuída e ser proprietários ou membros do site para ver o botão do agente. A utilização está incluída no Microsoft 365 Copilot.

Definições de função para acesso ao site

• Proprietário do Site: um utilizador com permissões completas de Proprietário do Site.
• Gestor de Conteúdos: um utilizador com permissões de leitura, escrita e lista.
• Criador de Conteúdos: um utilizador com permissões de leitura e escrita para conteúdos do site ou, pelo menos, acesso a grupos de Membros do Site.
• Consumidor de Conteúdos: qualquer utilizador com, pelo menos, permissões de Leitura para conteúdos do site ou, pelo menos, acesso ao grupo Visitantes do Site.

Ativar Agente de Conhecimento

Para pré-visualizar, configure a disponibilidade com o PowerShell. KnowledgeAgent Utilize parâmetros no Set-SPOTenant para ativar o Agente de Conhecimento em todos os sites, incluir sites seletivamente ou excluir sites seletivamente.

Para inquilinos multigeográficos, o script do PowerShell tem de ser executado em cada área geográfica para ativar o Agente de Conhecimento nessa região.

O processo de ativação será alterado para disponibilidade geral.

Utilize o Shell de Gerenciamento do SharePoint Online versão 16.0.26615.12013 ou posterior para gerir o acesso à pré-visualização do Agente de Conhecimento para utilizadores com licenças copilot. Para obter instruções de configuração, consulte Introdução ao Shell de Gerenciamento do SharePoint Online.

Se já tiver o Shell de Gerenciamento do SharePoint Online instalado, certifique-se de que está a executar a versão mais recente ao executar o seguinte comando no modo administrativo: Update-Module -Name Microsoft.Online.SharePoint.PowerShell.

Para resolve erros de controlo de versões

Se receber o seguinte erro, poderá indicar que tem várias versões em conflito do Shell de Gerenciamento do SharePoint Online instaladas:

Set-SPOTenant : A parameter cannot be found that matches parameter name 'KnowledgeAgentScope'

Para resolver este problema, siga estas etapas:

1. Remova os módulos do SharePoint em conflito ao abrir Adicionar ou remover programas e ao procurar o SharePoint. Desinstale quaisquer módulos de administração do SharePoint que encontrar.

2. Verifique os módulos instalados ao executar o seguinte comando:

   Get-Module -Name *SharePoint* -ListAvailable

   Se estiverem listadas várias versões, remova-as com:

   Uninstall-Module -Name <ModuleName>

3. Elimine manualmente os restantes módulos. Se encontrar exceções durante a desinstalação, utilize este comando para localizar o caminho do módulo:

   (Get-Module -Name *SharePoint* -ListAvailable).Path

   Navegue para a pasta principal e elimine-a manualmente.

4. Reinicie o PowerShell. Feche o terminal e reabra-o para limpar quaisquer módulos carregados na memória.

5. Repita a limpeza. Repita os passos 2 e 3 até não existirem módulos do PowerShell do SharePoint Online.

6. Para instalar o módulo mais recente do PowerShell do SharePoint Online, execute:

   Install-Module -Name Microsoft.Online.SharePoint.PowerShell

   Observação

   Para verificar a versão instalada, utilize o seguinte comando:

   (Get-Module -Name Microsoft.Online.SharePoint.PowerShell -ListAvailable).Version

   Se forem apresentadas várias versões, repita os passos de limpeza anteriores.

KnowledgeAgentScope

• Descrição: permite que os administradores controlem em que sites do SharePoint a funcionalidade Agente de Conhecimento está disponível.

• Valores válidos:

  • AllSites: O Agente de Conhecimento está disponível em todos os sites.

  • IncludeSelectedSites: O Agente de Conhecimento só está disponível em sites especificados em KnowledgeAgentSelectedSitesList

  • ExcludeSelectedSites: O Agente de Conhecimento está disponível em todos os sites, exceto os especificados em KnowledgeAgentSelectedSitesList.

  • NoSites: O Agente de Conhecimento não está disponível em nenhum site. (Este é o valor Predefinido.)

• Nota: requer Microsoft 365 Copilot licença.

KnowledgeAgentSelectedSitesList

• Descrição: permite que os administradores transmitam uma lista de URLs de sites do SharePoint para incluir ou excluir da funcionalidade Agente de conhecimento.

• When KnowledgeAgentScope = ExcludeSelectedSites: the list is treated as sites to EXCLUDE (site opt-out list).

  • When KnowledgeAgentScope = IncludeSelectedSites: the list is treated as sites to INCLUDE (site opt-in list).

• Por predefinição, esta ação substitui qualquer lista existente pela lista fornecida.

• Este parâmetro só pode ser chamado quando KnowledgeAgentScope está definido como IncludeSelectedSites ou ExcludeSelectedSites.

• A lista de URLs do site não pode exceder os 100 itens.

• Nota: requer Microsoft 365 Copilot licença.

KnowledgeAgentSelectedSitesListOperation

• Descrição: especifica a operação a executar na lista de sites atuais da funcionalidade Agente de Conhecimento.

• Valores válidos:

  • Overwrite: substitua a lista de sites existentes (predefinição).

  • Append: acrescente a lista de entrada de sites à lista de sites existentes.

  • Remove: remova a lista de entrada de sites da lista de sites existentes.

• Nota: chamar este parâmetro sem KnowledgeAgentSelectedSitesList não tem qualquer efeito.

Exemplo de uso

Ativar o Agente de Conhecimento em todos os sites

# Connect to SharePoint Online admin center
Connect-SPOService https://yourtenant-admin.sharepoint.com

# Enable Knowledge Agent for all sites in the tenant
Set-SPOTenant -KnowledgeAgentScope AllSites

# Verify the configuration
Get-SPOTenant | Select-Object KnowledgeAgentScope

Ativar o Agente de Conhecimento em sites especificados

# Connect to SharePoint Online admin center 
Connect-SPOService https://yourtenant-admin.sharepoint.com 

# Set Knowledge Agent to be available only on the included sites 
Set-SPOTenant -KnowledgeAgentScope IncludeSelectedSites 

# Specify sites to enable Knowledge Agent (initial inclusion list) 
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site5", "https://yourtenant.sharepoint.com/sites/site7") 

# Add additional sites to the existing inclusion list (if needed) 
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site3") -KnowledgeAgentSelectedSitesListOperation Append 

# Verify the inclusion configuration 
Get-SPOTenant | Select-Object KnowledgeAgentScope, KnowledgeAgentSelectedSitesList 

Ativar o Agente de Conhecimento em todos os sites, exceto nos sites especificados

# Connect to SharePoint Online admin center
Connect-SPOService https://yourtenant-admin.sharepoint.com

# Set Knowledge Agent to be available on all sites except selected sites
Set-SPOTenant -KnowledgeAgentScope ExcludeSelectedSites

# Specify sites to exclude from Knowledge Agent (initial exclusion list)
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site1", "https://yourtenant.sharepoint.com/sites/site2")

# Add additional sites to the existing exclusion list (if needed)
Set-SPOTenant -KnowledgeAgentSelectedSitesList @("https://yourtenant.sharepoint.com/sites/site3") -KnowledgeAgentSelectedSitesListOperation Append

# Verify the exclusion configuration
Get-SPOTenant | Select-Object KnowledgeAgentScope, KnowledgeAgentSelectedSitesList

Desativar o Agente de Conhecimento

# Connect to SharePoint Online admin center
Connect-SPOService https://yourtenant-admin.sharepoint.com

# Disable Knowledge Agent for all sites in the tenant
Set-SPOTenant -KnowledgeAgentScope NoSites

# Verify Knowledge Agent is disabled
Get-SPOTenant | Select-Object KnowledgeAgentScope