Récupération des ID de fonctionnalités pour le manifeste de l’agent déclaratif

Cet article décrit les méthodes permettant aux développeurs de récupérer les ID nécessaires pour inclure des connecteurs Copilot et des fichiers SharePoint/OneDrive dans la capabilities section de leur manifeste d’agent déclaratif. Les développeurs peuvent utiliser Microsoft Graph Explorer ou Microsoft Graph PowerShell.

connecteurs Microsoft 365 Copilot

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

Importante

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

Afficheur Graph
PowerShell

Accédez à Microsoft Graph Explorer et connectez-vous avec votre compte administrateur.
Sélectionnez votre avatar utilisateur dans le coin supérieur droit, puis sélectionnez Consentement aux autorisations.
Recherchez ExternalConnection.Read.All et sélectionnez Consentement pour cette autorisation. Suivez les invites pour accorder votre consentement.
Entrez https://graph.microsoft.com/v1.0/external/connections?$select=id,name dans le champ de requête, puis sélectionnez Exécuter la requête.

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"
    }
  ]
}

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"
}

Ouvrez PowerShell 7 dans le répertoire où se trouveGetGraphConnectorIds.ps1 et exécutez le script avec la commande suivante.
```
.\GetGraphConnectorIds.ps1
```
Ouvrez votre navigateur et accédez à https://microsoft.com/devicelogin. Entrez le code fourni par l’invite et terminez le flux 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.
```
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 les développeurs peuvent récupérer la valeur à définir dans les propriétés suivantes dans la items_by_sharepoint_ids propriété de l’objetOneDriveAndSharePoint :

site_id
list_id
web_id
unique_id

Afficheur Graph
PowerShell

Accédez à Microsoft Graph Explorer et connectez-vous avec votre compte administrateur.
Sélectionnez votre avatar utilisateur dans le coin supérieur droit, puis sélectionnez Consentement aux autorisations.
Recherchez Sites.Read.All et sélectionnez Consentement pour cette autorisation. Suivez les invites pour accorder votre consentement. Répétez ce processus pour Files.Read.All.
Remplacez la liste déroulante de méthode par POST et entrez https://graph.microsoft.com/v1.0/search/query dans le champ de demande.

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

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

Sélectionnez Exécuter la requête.

Recherchez le fichier souhaité et copiez ses listIdpropriétés , webId, siteIdet 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
        }
      ]
    }
  ]
}

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"
}

Ouvrez PowerShell 7 dans le répertoire où se trouveGetSharePointIds.ps1 et exécutez le script avec la commande suivante, en https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx remplaçant par l’URL du fichier ou du dossier pour lequel vous souhaitez obtenir les ID.
```
.\GetSharePointIds.ps1 -FilePath "https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx"
```
Ouvrez votre navigateur et accédez à https://microsoft.com/devicelogin. Entrez le code fourni par l’invite et terminez le flux 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.
```

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}

Commentaires

Cette page a-t-elle été utile ?

Last updated on 2025-08-15

Partager via

Récupération des ID de fonctionnalités pour le manifeste de l’agent déclaratif

connecteurs Microsoft 365 Copilot

Récupération des ID SharePoint

Commentaires

Ressources supplémentaires