Récupérer les ID de capacité pour le manifeste de l’agent déclaratif

Cet article décrit comment récupérer les ID dont vous avez besoin pour inclure les connecteurs Copilot et les fichiers SharePoint/OneDrive dans la capabilities section de votre manifeste d’agent déclaratif. Vous pouvez utiliser Microsoft Graph Explorer ou Microsoft Graph PowerShell.

Connecteurs Copilot

Cette section décrit comment récupérer la valeur à définir dans la connection_id propriété de l’objet Connection dans l’objet connecteurs Copilot dans le manifeste.

Importante

L’interrogation des connecteurs Copilot nécessite un compte administrateur.

Afficheur Graph

1. Accédez à Microsoft Graph Explorer et connectez-vous avec votre compte administrateur.

   

2. Sélectionnez votre avatar d’utilisateur dans le coin supérieur droit, puis sélectionnez Consentement aux autorisations.

   

3. ExternalConnection.Read.All Recherchez et sélectionnez le consentement pour cette autorisation. Suivez les invites pour accorder le consentement.

   

4. Entrez https://graph.microsoft.com/v1.0/external/connections?$select=id,name dans le champ de demande et sélectionnez Exécuter la requête.

   

5. Recherchez le connecteur souhaité et copiez sa id propriété. Par exemple, pour utiliser le connecteur GitHub Repos dans la réponse suivante, copiez la githubrepos valeur.

   {
     "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#connections(id,name)",
     "value": [
       {
         "id": "applianceparts",
         "name": "Appliance Parts Inventory"
       },
       {
         "id": "githubrepos",
         "name": "GitHub Repos"
       }
     ]
   }
   

PowerShell

1. Copiez le code suivant dans un nouveau fichier nommé GetGraphConnectorIds.ps1.

   param(
       [Parameter(Mandatory = $false)]
       [Switch]
       $StayConnected = $false
   )
   
   # Requires an admin
   Connect-MgGraph -Scopes "ExternalConnection.Read.All" `
       -UseDeviceCode -ErrorAction Stop -NoWelcome
   
   Get-MgExternalConnection -Property "Name", "Id" | Format-Table "Name", "Id"
   
   if ($StayConnected -eq $false) {
       Disconnect-MgGraph | Out-Null
       Write-Host "Disconnected from Microsoft Graph"
   }
   else {
       Write-Host
       Write-Host -ForegroundColor Yellow `
           "The connection to Microsoft Graph is still active. To disconnect, use Disconnect-MgGraph"
   }
   

2. Ouvrez PowerShell 7 dans le répertoire où se trouve GetGraphConnectorIds.ps1 et exécutez le script avec la commande suivante.

   .\GetGraphConnectorIds.ps1
   

3. Ouvrez votre navigateur et accédez à https://microsoft.com/devicelogin. Entrez le code fourni par l’invite et suivez le processus de connexion et de consentement.

   To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code BQGGRREGN to authenticate.
   

4. Recherchez le connecteur souhaité et copiez sa Id propriété. Par exemple, pour utiliser le connecteur GitHub Repos dans la réponse suivante, copiez la githubrepos valeur.

   Name                      Id
   ----                      --
   Appliance Parts Inventory applianceparts
   GitHub Repos              githubrepos
   

Récupération des ID SharePoint

Cette section décrit comment récupérer la valeur à définir dans les propriétés suivantes dans la propriété de l’objetOneDriveAndSharePointitems_by_sharepoint_ids :

• site_id
• list_id
• web_id
• unique_id

Afficheur Graph

1. Accédez à Microsoft Graph Explorer et connectez-vous avec votre compte administrateur.

2. Sélectionnez votre avatar d’utilisateur dans le coin supérieur droit, puis sélectionnez Consentement aux autorisations.

3. Sites.Read.All Recherchez et sélectionnez le consentement pour cette autorisation. Suivez les invites pour accorder le consentement. Répétez cette procédure pour Files.Read.All.

   

4. Modifiez la liste déroulante de la méthode sur POST et entrez https://graph.microsoft.com/v1.0/search/query dans le champ de requête.

   

5. Ajoutez ce qui suit dans le corps de la demande, en remplaçant https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx par l’URL du fichier ou dossier pour lequel vous souhaitez obtenir des ID.

   {
     "requests": [
       {
         "entityTypes": [
           "driveItem"
         ],
         "query": {
           "queryString": "Path:\"https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx\""
         },
         "fields": [
           "fileName",
           "listId",
           "webId",
           "siteId",
           "uniqueId"
         ]
       }
     ]
   }
   

6. Sélectionnez Exécuter la requête.

7. Recherchez le fichier souhaité et copiez ses listIdpropriétés , webId, siteId, et uniqueId .

   {
     "value": [
       {
         "searchTerms": [],
         "hitsContainers": [
           {
             "hits": [
               {
                 "hitId": "01AJOINAHZHINTBHPESZBISPIPSJG3D5EO",
                 "rank": 1,
                 "summary": "Reorder policy Our reorder policy for suppliers is straightforward and designed to maintain cost-efficiency and inventory control. We kindly request that no order exceeds a total",
                 "resource": {
                   "@odata.type": "#microsoft.graph.driveItem",
                   "listItem": {
                     "@odata.type": "#microsoft.graph.listItem",
                     "id": "301b3af9-e49d-4296-893d-0f924db1f48e",
                     "fields": {
                       "fileName": "YourFile.docx",
                       "listId": "12fde922-4fab-4238-8227-521829cd1099",
                       "webId": "a25fab47-f3b9-4fa3-8ed9-1acb83c12a4f",
                       "siteId": "5863dfa5-b39d-4cd1-92a6-5cf539e04971",
                       "uniqueId": "{301b3af9-e49d-4296-893d-0f924db1f48e}"
                     }
                   }
                 }
               }
             ],
             "total": 1,
             "moreResultsAvailable": false
           }
         ]
       }
     ]
   }
   

PowerShell

1. Copiez le code suivant dans un nouveau fichier nommé GetSharePointIds.ps1.

   param(
       [Parameter(Mandatory = $true,
       HelpMessage = "The URL path to the file or folder to search for")]
       [String]
       $FilePath,
   
       [Parameter(Mandatory = $false)]
       [Switch]
       $StayConnected = $false
   )
   
   Connect-MgGraph -Scopes "Sites.Read.All Files.Read.All" `
       -UseDeviceCode -ErrorAction Stop -NoWelcome
   
   $searchQuery = @{
       requests = @(
           @{
               entityTypes = @("driveItem")
               query = @{
                   queryString = "Path:""" + $FilePath +  """"
               }
               fields = @(
                   "fileName"
                   "listId"
                   "webId"
                   "siteId"
                   "uniqueId"
               )
           }
       )
   }
   
   $results = Invoke-MgQuerySearch -Body $searchQuery
   
   foreach($hitContainer in $results.HitsContainers)
   {
       foreach($hit in $hitContainer.Hits)
       {
           Write-Output $hit.Resource.AdditionalProperties["listItem"]["fields"] | Format-Table
       }
   }
   
   if ($StayConnected -eq $false) {
       Disconnect-MgGraph | Out-Null
       Write-Host "Disconnected from Microsoft Graph"
   }
   else {
       Write-Host
       Write-Host -ForegroundColor Yellow `
           "The connection to Microsoft Graph is still active. To disconnect, use Disconnect-MgGraph"
   }
   

2. Ouvrez PowerShell 7 dans le répertoire où se trouve GetSharePointIds.ps1 et exécutez le script avec la commande suivante, en remplaçant https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx par l’URL du fichier ou dossier pour lequel vous souhaitez obtenir des ID.

   .\GetSharePointIds.ps1 -FilePath "https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx"
   

3. Ouvrez votre navigateur et accédez à https://microsoft.com/devicelogin. Entrez le code fourni par l’invite et suivez le processus de connexion et de consentement.

   To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code BQGGRREGN to authenticate.
   

4. Recherchez le fichier souhaité et copiez ses valeurs.

   Key      Value
   ---      -----
   fileName YourFile.docx
   listId   12fde922-4fab-4238-8227-521829cd1099
   webId    a25fab47-f3b9-4fa3-8ed9-1acb83c12a4f
   siteId   5863dfa5-b39d-4cd1-92a6-5cf539e04971
   uniqueId {301b3af9-e49d-4296-893d-0f924db1f48e}