Abrufen von Funktions-IDs für das Manifest des deklarativen Agents

In diesem Artikel wird beschrieben, wie Sie die IDs abrufen, die Sie benötigen, um Copilot-Connectors und SharePoint-/OneDrive-Dateien in den capabilities Abschnitt Ihres deklarativen Agentmanifests einzuschließen. Sie können Microsoft Graph Explorer oder Microsoft Graph PowerShell verwenden.

Copilot-Connectors

In diesem Abschnitt wird beschrieben, wie Sie den Wert abrufen, der in der connection_id Eigenschaft des Connection-Objekts im Copilot connectors-Objekt im Manifest festgelegt werden soll.

Wichtig

Für die Abfrage von Copilot-Connectors ist ein Administratorkonto erforderlich.

Graph-Tester

1. Navigieren Sie zum Microsoft Graph-Explorer, und melden Sie sich mit Ihrem Administratorkonto an.

   

2. Wählen Sie Ihren Benutzeravatar in der oberen rechten Ecke und dann Berechtigungen zustimmen aus.

   

3. Suchen Sie nach ExternalConnection.Read.All dieser Berechtigung und wählen Sie sie aus . Folgen Sie den Anweisungen, um die Zustimmung zu erteilen.

   

4. Geben Sie in das Anforderungsfeld ein https://graph.microsoft.com/v1.0/external/connections?$select=id,name , und wählen Sie Abfrage ausführen aus.

   

5. Suchen Sie den gewünschten Verbinder, und kopieren Sie seine id Eigenschaft. Um beispielsweise den GitHub Repos-Connector in der folgenden Antwort zu verwenden, kopieren Sie den githubrepos Wert.

   {
     "@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. Kopieren Sie den folgenden Code in eine neue Datei mit dem Namen 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. Öffnen Sie PowerShell 7 in dem Verzeichnis, in dem sichGetGraphConnectorIds.ps1 befindet, und führen Sie das Skript mit dem folgenden Befehl aus.

   .\GetGraphConnectorIds.ps1
   

3. Öffnen Sie Ihren Browser, und navigieren Sie zu https://microsoft.com/devicelogin. Geben Sie den Code ein, der von der Eingabeaufforderung bereitgestellt wird, und schließen Sie den Anmelde- und Zustimmungsfluss ab.

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

4. Suchen Sie den gewünschten Verbinder, und kopieren Sie seine Id Eigenschaft. Um beispielsweise den GitHub Repos-Connector in der folgenden Antwort zu verwenden, kopieren Sie den githubrepos Wert.

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

Abrufen von SharePoint-IDs

In diesem Abschnitt wird beschrieben, wie Sie den Wert abrufen, der in den folgenden Eigenschaften innerhalb items_by_sharepoint_ids der Eigenschaft des OneDriveAndSharePoint Objekts festgelegt werden soll:

• site_id
• list_id
• web_id
• unique_id

Graph-Tester

1. Navigieren Sie zum Microsoft Graph-Explorer, und melden Sie sich mit Ihrem Administratorkonto an.

2. Wählen Sie Ihren Benutzeravatar in der oberen rechten Ecke und dann Berechtigungen zustimmen aus.

3. Suchen Sie nach Sites.Read.All dieser Berechtigung und wählen Sie sie aus . Folgen Sie den Anweisungen, um die Zustimmung zu erteilen. Wiederholen Sie diesen Vorgang für Files.Read.All.

   

4. Ändern Sie das Methodendropdownmenü in POST und geben Sie es in das Anforderungsfeld ein https://graph.microsoft.com/v1.0/search/query .

   

5. Fügen Sie im Anforderungstext Folgendes hinzu, und ersetzen https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx Sie ihn durch die URL zu der Datei oder dem Ordner, für die bzw. den Sie IDs abrufen möchten.

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

6. Wählen Sie Abfrage ausführen aus.

7. Suchen Sie die gewünschte Datei, und kopieren Sie ihre listId, webId, siteId, und uniqueId Eigenschaften.

   {
     "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. Kopieren Sie den folgenden Code in eine neue Datei mit dem Namen 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. Öffnen Sie PowerShell 7 in dem Verzeichnis, in dem sichGetSharePointIds.ps1 befindet, und führen Sie das Skript mit dem folgenden Befehl aus. Ersetzen https://yoursharepointsite.com/sites/YourSite/Shared%20Documents/YourFile.docx Sie dabei die URL zu der Datei oder dem Ordner, für die/den Sie IDs abrufen möchten.

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

3. Öffnen Sie Ihren Browser, und navigieren Sie zu https://microsoft.com/devicelogin. Geben Sie den Code ein, der von der Eingabeaufforderung bereitgestellt wird, und schließen Sie den Anmelde- und Zustimmungsfluss ab.

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

4. Suchen Sie die gewünschte Datei, und kopieren Sie ihre Werte.

   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}