Recuperar identificadores de funcionalidad para el manifiesto de agente declarativo

En este artículo se describe cómo recuperar los identificadores que necesita para incluir conectores de Copilot y archivos SharePoint/OneDrive en la capabilities sección del manifiesto del agente declarativo. Puede usar Microsoft Graph Explorer o Microsoft Graph PowerShell.

Conectores de Copilot

En esta sección se describe cómo recuperar el valor que se va a establecer en la connection_id propiedad del objeto Connection en el objeto Conectores de Copilot en el manifiesto.

Importante

La consulta de conectores de Copilot requiere una cuenta de administrador.

Explorador de Graph
PowerShell

Vaya a Microsoft Graph Explorer e inicie sesión con su cuenta de administrador.
Seleccione su avatar de usuario en la esquina superior derecha y seleccione Consentimiento para permisos.
ExternalConnection.Read.All Busque y seleccione Consentimiento para ese permiso. Sigue las indicaciones para conceder el consentimiento.
Ingrese https://graph.microsoft.com/v1.0/external/connections?$select=id,name en el campo de solicitud y seleccione Ejecutar consulta.

Busque el conector que desee y copie su id propiedad. Por ejemplo, para usar el conector de GitHub Repos en la siguiente respuesta, copie el githubrepos valor.

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

Copie el código siguiente en un archivo nuevo denominado 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"
}

Abra PowerShell 7 en el directorio donde se encuentra GetGraphConnectorIds.ps1 y ejecute el script con el siguiente comando.
```
.\GetGraphConnectorIds.ps1
```
Abre el explorador y ve a https://microsoft.com/devicelogin. Escriba el código proporcionado por la solicitud y complete el flujo de inicio de sesión y consentimiento.
```
To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code BQGGRREGN to authenticate.
```
Busque el conector que desee y copie su Id propiedad. Por ejemplo, para usar el conector de GitHub Repos en la siguiente respuesta, copie el githubrepos valor.
```
Name                      Id
----                      --
Appliance Parts Inventory applianceparts
GitHub Repos              githubrepos
```

Recuperación de identificadores de SharePoint

En esta sección se describe cómo recuperar los valores que se establecerán en las propiedades siguientes dentro de la items_by_sharepoint_ids propiedad del OneDriveAndSharePoint objeto:

site_id
list_id
web_id
unique_id

Explorador de Graph
PowerShell

Vaya a Microsoft Graph Explorer e inicie sesión con su cuenta de administrador.
Seleccione su avatar de usuario en la esquina superior derecha y seleccione Consentimiento para permisos.
Sites.Read.All Busque y seleccione Consentimiento para ese permiso. Sigue las indicaciones para conceder el consentimiento. Repita este proceso para Files.Read.All.
Cambie el menú desplegable del método a POST y escríbalo https://graph.microsoft.com/v1.0/search/query en el campo de solicitud.

Agregue lo siguiente en el cuerpo de la solicitud, reemplazándolo https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx por la dirección URL del archivo o carpeta para el que desea obtener identificadores.

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

Seleccione Ejecutar consulta.

Busque el archivo que quiera usar y copie sus listIdpropiedades y webIdsiteIduniqueId propiedades.

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

Copie el código siguiente en un archivo nuevo denominado 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"
}

Abra PowerShell 7 en el directorio donde se encuentra GetSharePointIds.ps1 y ejecute el script con el siguiente comando, reemplazándolo https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx por la dirección URL del archivo o carpeta para el que desea obtener identificadores.
```
.\GetSharePointIds.ps1 -FilePath "https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx"
```
Abre el explorador y ve a https://microsoft.com/devicelogin. Escriba el código proporcionado por la solicitud y complete el flujo de inicio de sesión y consentimiento.
```
To sign in, use a web browser to open the page https://microsoft.com/devicelogin and enter the code BQGGRREGN to authenticate.
```

Busque el archivo que desee y copie sus valores.

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}

Comentarios

¿Le ha resultado útil esta página?

Se actualizó por última vez el 2026-10-23

Recuperar identificadores de funcionalidad para el manifiesto de agente declarativo

Conectores de Copilot

Recuperación de identificadores de SharePoint

Comentarios

Recursos adicionales