Prise en main de l’Agent de connaissances (préversion)

L’Agent de connaissances est une fonctionnalité SharePoint intégrée conçue pour aider votre organization à préparer du contenu pour l’IA. Il enrichit, organise et gère le contenu SharePoint dans un format structuré et faisant autorité, optimisé pour les agents Microsoft 365 Copilot.

Pour les locataires éligibles, un bouton nouvel agent s’affiche dans le coin inférieur droit des surfaces SharePoint, ce qui permet aux utilisateurs éligibles d’accéder aux fonctionnalités d’IA avancées. Il s’agit notamment de l’enrichissement de contenu automatisé, de l’optimisation des métadonnées et du résumé intelligent des pages.

Configuration requise

• Un administrateur SharePoint (ou administrateur général) doit d’abord activer l’Agent de connaissances (préversion) .

  Importante

  Microsoft vous recommande d’utiliser des rôles disposant du moins d’autorisations. L’utilisation de comptes avec autorisation inférieure permet d’améliorer la sécurité de vos organization. Le rôle d’administrateur général dispose de privilèges élevés. Il doit être limité aux scénarios d’urgence lorsque vous ne pouvez pas utiliser un rôle existant. Pour en savoir plus, consultez À propos des rôles d’administrateur dans le Centre d’administration Microsoft 365.

• Pour utiliser la fonctionnalité, les utilisateurs doivent disposer d’une licence Microsoft 365 Copilot et être propriétaires de site ou membres pour voir le bouton de l’agent. L’utilisation est incluse dans Microsoft 365 Copilot.

Définitions de rôles pour l’accès au site

• Propriétaire du site : utilisateur disposant des autorisations de propriétaire de site complètes.
• Gestionnaire de contenu : utilisateur disposant d’autorisations de lecture, d’écriture et de liste.
• Créateur de contenu : utilisateur disposant d’autorisations de lecture et d’écriture sur le contenu du site ou au moins l’accès au groupe Membres du site.
• Consommateur de contenu : tout utilisateur disposant au moins d’autorisations de lecture sur le contenu du site ou au moins d’un accès au groupe Visiteurs du site.

Activer l’agent de connaissances

Pour la préversion, vous configurez la disponibilité à l’aide de PowerShell. Vous utilisez les KnowledgeAgent paramètres dans Set-SPOTenant pour activer l’Agent de connaissances sur tous les sites, inclure des sites de manière sélective ou exclure de manière sélective des sites.

Pour les locataires multigéographiques, le script PowerShell doit être exécuté dans chaque zone géographique pour activer l’Agent de connaissances dans cette région.

Le processus d’activation va changer pour la disponibilité générale.

Utilisez le SharePoint Online Management Shell version 16.0.26615.12013 ou ultérieure pour gérer l’accès à la préversion de l’Agent de connaissances pour les utilisateurs disposant de licences Copilot. Pour obtenir des instructions d’installation, consultez Bien démarrer avec SharePoint Online Management Shell.

Si le SharePoint Online Management Shell est déjà installé, vérifiez que vous exécutez la dernière version en exécutant la commande suivante en mode administratif : Update-Module -Name Microsoft.Online.SharePoint.PowerShell.

Pour résoudre les erreurs de gestion de version

Si vous obtenez l’erreur suivante, cela peut indiquer que plusieurs versions de l’SharePoint Online Management Shell ou en conflit sont installées :

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

Pour résoudre ce problème, procédez comme suit :

1. Supprimez les modules SharePoint en conflit en ouvrant Ajouter ou supprimer des programmes, puis en recherchant SharePoint. Désinstallez tous les modules d’administration SharePoint que vous trouvez.

2. Vérifiez les modules installés en exécutant la commande suivante :

   Get-Module -Name *SharePoint* -ListAvailable

   Si plusieurs versions sont répertoriées, supprimez-les à l’aide de :

   Uninstall-Module -Name <ModuleName>

3. Supprimez manuellement les modules restants. Si vous rencontrez des exceptions lors de la désinstallation, utilisez cette commande pour localiser le chemin du module :

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

   Accédez au dossier parent et supprimez-le manuellement.

4. Redémarrez PowerShell. Fermez le terminal et rouvrez-le pour effacer tous les modules chargés en mémoire.

5. Répétez le nettoyage. Répétez les étapes 2 et 3 jusqu’à ce qu’aucun module PowerShell SharePoint Online ne reste.

6. Pour installer le dernier module PowerShell SharePoint Online, exécutez :

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

   Remarque

   Pour vérifier la version installée, utilisez la commande suivante :

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

   Si plusieurs versions apparaissent, répétez les étapes de nettoyage précédentes.

KnowledgeAgentScope

• Description : Permet aux administrateurs de contrôler les sites SharePoint sur lesquels la fonctionnalité Agent de connaissances est disponible.

• Valeurs valides :

  • AllSites: l’agent de connaissances est disponible sur tous les sites.

  • IncludeSelectedSites: l’Agent de connaissances est disponible uniquement sur les sites spécifiés dans KnowledgeAgentSelectedSitesList

  • ExcludeSelectedSites: l’Agent de connaissances est disponible sur tous les sites, à l’exception de ceux spécifiés dans KnowledgeAgentSelectedSitesList.

  • NoSites: l’agent de connaissances n’est disponible sur aucun site. (Il s’agit de la valeur par défaut.)

• Remarque : nécessite Microsoft 365 Copilot licence.

KnowledgeAgentSelectedSitesList

• Description : permet aux administrateurs de transmettre une liste d’URL de site SharePoint à inclure ou exclure de la fonctionnalité Agent de connaissances.

• Quand KnowledgeAgentScope = ExcludeSelectedSites : la liste est traitée comme des sites à EXCLUDE (liste d’exclusion de site).

  • Quand KnowledgeAgentScope = IncludeSelectedSites : la liste est traitée comme des sites à INCLUDE (liste d’inscription de site).

• Par défaut, cette opération remplace toute liste existante par la liste fournie.

• Ce paramètre ne peut être appelé que lorsque KnowledgeAgentScope est défini sur IncludeSelectedSites ou ExcludeSelectedSites.

• La liste des URL de site ne peut pas dépasser 100 éléments.

• Remarque : nécessite Microsoft 365 Copilot licence.

KnowledgeAgentSelectedSitesListOperation

• Description : spécifie l’opération à effectuer sur la liste des sites actuels de la fonctionnalité Agent de connaissances.

• Valeurs valides :

  • Overwrite: remplacer la liste des sites existantes (par défaut).

  • Append: ajoutez la liste d’entrée des sites à la liste des sites existants.

  • Remove: supprimez la liste d’entrée des sites de la liste des sites existants.

• Remarque : L’appel de ce paramètre sans KnowledgeAgentSelectedSitesList n’a aucun effet.

Exemple d’utilisation

Activer l’agent de connaissances sur tous les 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

Activer l’Agent de connaissances sur les sites spécifiés

# 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 

Activer l’Agent de connaissances sur tous les sites à l’exception des sites spécifiés

# 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

Désactiver l’agent de connaissances

# 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