Απογραφή αντιπροσώπων Microsoft Copilot Studio

Η απογραφή Copilot Studio αντιπροσώπων παρέχει στους διαχειριστές IT και ασφάλειας μια κεντρική προβολή όλων των παραγόντων που δημιουργήθηκαν με χρήση του Copilot Studio ή του Agent Builder στον μισθωτή. Η απογραφή καλύπτει τόσο τις μη δημοσιευμένες (πρόχειρες) όσο και τις δημοσιευμένες εταιρείες. Για κάθε παράγοντα, η απογραφή εμφανίζει βασικά μετα-δεδομένα, όπως ποιος δημιούργησε τον παράγοντα, πότε δημοσιεύτηκε τελευταία φορά, σε ποια κανάλια έχει αναπτυχθεί, πώς ελέγχει την ταυτότητα των χρηστών, τις δυνατότητές του και πολλά άλλα. Τα δεδομένα αποθέματος ανανεώνονται αυτόματα και οι αλλαγές σε έναν παράγοντα εμφανίζονται συνήθως εντός 20 λεπτών.

Οι διαχειριστές μπορούν να χρησιμοποιήσουν τα δεδομένα αποθέματος μέσω πολλών μεθόδων, όπως το κέντρο διαχείρισης Power Platform, το API Power Platform και Γράφημα πόρου του Azure. Για την πλήρη λίστα των μεθόδων πρόσβασης και των απαιτούμενων ρόλων, ανατρέξτε στο θέμα Απογραφή Power Platform.

Αυτό το άρθρο περιγράφει τα πεδία που αφορούν ειδικά τους πράκτορες του Copilot Studio (microsoft.copilotstudio/agents) στην απογραφή του Power Platform. Για κοινόχρηστα πεδία που είναι διαθέσιμα σε όλους τους τύπους πόρων, ανατρέξτε στο θέμα Αναφορά σχήματος αποθέματος Power Platform.

Note

Το απόθεμα δεν περιλαμβάνει υπαλλήλους που έχουν δημιουργηθεί με V1 από Copilot Studio (γνωστά και ως Κλασικά bot ή Power Virtual Agents). Ωστόσο, μπορείτε να μεταβείτε στο κέντρο διαχείρισης του Power Platform και να επιλέξετε Διαχείριση>Copilot Studio>Κλασικά chatbot για να δείτε αυτούς τους πράκτορες.

Σημαντικό

Αυτό το άρθρο περιέχει τεκμηρίωση προεπισκόπησης του Microsoft Copilot Studio και υπόκειται σε αλλαγές.

Οι δυνατότητες προεπισκόπησης δεν προορίζονται για χρήση παραγωγής και ενδέχεται να έχουν περιορισμένη λειτουργικότητα. Αυτές οι δυνατότητες διατίθενται πριν από μια επίσημη κυκλοφορία, ώστε να αποκτήσετε πρώιμη πρόσβαση και να υποβάλετε σχόλια.

Εάν δημιουργείτε έναν agent έτοιμο για παραγωγή, ανατρέξτε στο Microsoft Copilot Studio Overview.

Ιδιότητες παράγοντα

Η απογραφή παρέχει τις παρακάτω ιδιότητες για κάθε παράγοντα.

Note

  • Η απογραφή αντικατοπτρίζει τη δομή της δημοσιευμένης έκδοσης κάθε παράγοντα. Εάν ένας αντιπρόσωπος έχει μη δημοσιευμένες αλλαγές (ένα νεότερο πρόχειρο), η απογραφή δεν εμφανίζει αυτές τις αλλαγές μέχρι να δημοσιευτεί ο παράγοντας.

  • Η ρύθμιση παραμέτρων ενός παράγοντα επηρεάζει τα πεδία που συμπληρώνονται. Ορισμένες ιδιότητες μπορεί να εξαρτώνται null από τον τρόπο ρύθμισης του παράγοντα. Για παράδειγμα, isManaged το είναι null για υπαλλήλους που δημιουργήθηκαν στο Agent Builder.

Βασικές ιδιότητες

Διαδρομή πεδίου API Τύπος δεδομένων Περιγραφή Παράδειγμα Κατάσταση
properties.displayName συμβολοσειρά Το εμφανιζόμενο όνομα του πράκτορα. Customer support agent Γενικά διαθέσιμο
properties.name GUID Το αναγνωριστικό του πράκτορα στο συγκεκριμένο περιβάλλον Dataverse (αναγνωριστικό bot CDS). aaaa0000-bb11-2222-33cc-444444dddddd Γενικά διαθέσιμο
properties.createdAt datetime Ημερομηνία και ώρα δημιουργίας του παράγοντα. 2024-12-13T04:00:00Z Γενικά διαθέσιμο
properties.createdBy GUID Entra ID του χρήστη που δημιούργησε τον παράγοντα. aaaa0000-bb11-2222-33cc-444444dddddd Γενικά διαθέσιμο
properties.ownerId συμβολοσειρά Το αναγνωριστικό αντικειμένου (Entra ID) του τρέχοντος κατόχου του παράγοντα. aaaa0000-bb11-2222-33cc-444444dddddd Γενικά διαθέσιμο
properties.environmentId συμβολοσειρά Το αναγνωριστικό του περιβάλλοντος Power Platform που περιέχει τον πόρο. aaaa0000-bb11-2222-33cc-444444dddddd Γενικά διαθέσιμο
properties.lastPublishedAt datetime Η ημερομηνία και ώρα τελευταίας δημοσίευσης του πράκτορα. Κενό/μηδενικό εάν ο παράγοντας βρίσκεται ακόμα σε στάδιο προσχεδίου. 2026-01-15T10:30:00Z Γενικά διαθέσιμο
properties.createdIn συμβολοσειρά Το εργαλείο σύνταξης όπου δημιουργήθηκε ο παράγοντας: Copilot Studio ή Microsoft 365 Copilot Agent Builder. Copilot Studio Γενικά διαθέσιμο
properties.schemaName συμβολοσειρά Το όνομα σχήματος Dataverse. Διατίθεται για τους πράκτορες του Copilot Studio και τους πράκτορες του Microsoft 365 Copilot Agent Builder. cr5e3_agentName Γενικά διαθέσιμο
properties.isQuarantined δυαδική τιμή Εάν ο παράγοντας είναι σε καραντίνα αυτή τη στιγμή. false Προεπισκόπηση
properties.quarantinedAt datetime Η ημερομηνία και ώρα τελευταίας καραντίνας του πράκτορα. 2026-02-01T08:00:00Z Προεπισκόπηση
properties.isManaged δυαδική τιμή Εάν ο παράγοντας είναι μέρος μιας διαχειριζόμενης λύσης Dataverse. Null για υπαλλήλους που δημιουργήθηκαν στο Agent Builder. false Προεπισκόπηση

Ιδιότητες ταυτότητας Entra

Διαδρομή πεδίου API Τύπος δεδομένων Περιγραφή Παράδειγμα Κατάσταση
properties.botId συμβολοσειρά Το αναγνωριστικό bot CDS στο περιβάλλον. aaaa0000-bb11-2222-33cc-444444dddddd Γενικά διαθέσιμο
properties.entraAppId συμβολοσειρά Το αναγνωριστικό καταχώρησης εφαρμογής Entra που σχετίζεται με τον πράκτορα, εφόσον υπάρχει. aaaa0000-bb11-2222-33cc-444444dddddd Γενικά διαθέσιμο
properties.entraAgentId συμβολοσειρά Αναγνωριστικό ταυτότητας παράγοντα Entra, όταν υπάρχει. aaaa0000-bb11-2222-33cc-444444dddddd Γενικά διαθέσιμο
properties.entraAgentBlueprintId συμβολοσειρά Αναγνωριστικό Blueprint του Entra Agent, εάν υπάρχει. aaaa0000-bb11-2222-33cc-444444dddddd Γενικά διαθέσιμο

Note

Δεν είναι όλες οι ιδιότητες ταυτότητας διαθέσιμες για όλους τους τύπους παραγόντων: entraAppId είναι ένα αναγνωριστικό παλαιού τύπου, χρησιμοποιούν entraAgentId νεότερα στοιχεία και entraAgentBlueprintId. Αυτά τα πεδία συμπληρώνονται μόνο όταν ισχύουν για τον συγκεκριμένο παράγοντα. Καμία από αυτές τις ιδιότητες ταυτότητας δεν ισχύει για τους υπαλλήλους του Microsoft 365 Copilot Agent Builder.

Μάθετε περισσότερα στο θέμα Ταυτότητες εκπροσώπου και έλεγχος ταυτότητας στο Copilot Studio.

Ιδιότητες ρύθμισης παραμέτρων

Διαδρομή πεδίου API Τύπος δεδομένων Περιγραφή Παράδειγμα Κατάσταση
properties.orchestration συμβολοσειρά Η λειτουργία ενορχήστρωσης του παράγοντα (μάθετε περισσότερα στις λειτουργίες ενορχήστρωσης). Generative Προεπισκόπηση
properties.model συμβολοσειρά Το μοντέλο AI που χρησιμοποιείται από τον παράγοντα. gpt-4o Προεπισκόπηση
properties.authentication συμβολοσειρά Η λειτουργία ελέγχου ταυτότητας έχει ρυθμιστεί για τον παράγοντα (μάθετε περισσότερα στις λειτουργίες ελέγχου ταυτότητας). Microsoft Entra Προεπισκόπηση
properties.channels πίνακας Τα εμφανιζόμενα ονόματα των καναλιών στα οποία έχει δημοσιευτεί ο παράγοντας. ["Teams","SharePoint"] Προεπισκόπηση
properties.sharedWithViewers αντικείμενο Το πλήθος μεμονωμένων χρηστών θεατή (userCount) και ομάδων θεατή (groupCount) με το οποίο γίνεται κοινή χρήση του παράγοντα. Εάν ένας δημιουργός θέσει σε κοινή χρήση τον παράγοντα με ολόκληρο τον μισθωτή, entireTenant έχει οριστεί σε true, ακόμα και αν ένας διαχειριστής δεν ενέκρινε την κοινή χρήση. "groupCount": 0, "userCount": 0, "entireTenant": false Προεπισκόπηση
properties.sharedWithEditors αντικείμενο Το πλήθος μεμονωμένων χρηστών προγράμματος επεξεργασίας (userCount) και ομάδων επεξεργασίας (groupCount) με το οποίο γίνεται κοινή χρήση του παράγοντα. "groupCount": 0, "userCount": 0 Προεπισκόπηση
properties.capabilitiesCounts αντικείμενο Συνολικό διακριτό πλήθος κάθε τύπου διαμορφωμένων δυνατοτήτων "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Προεπισκόπηση

Λειτουργίες ενορχήστρωσης

Το properties.orchestration πεδίο αποδέχεται τις ακόλουθες τιμές:

Τιμή Περιγραφή
Κλασικός Ο πράκτορας χρησιμοποιεί κλασική ενορχήστρωση βάσει θέματος με προετοιμασμένα δέντρα διαλόγου.
Παραγωγική Ο παράγοντας χρησιμοποιεί παραγωγική ενορχήστρωση, όπου ένα μοντέλο τεχνητής νοημοσύνης επιλέγει δυναμικά θέματα και εργαλεία.

Λειτουργίες ελέγχου ταυτότητας

Το properties.authentication πεδίο αποδέχεται τις ακόλουθες τιμές:

Τιμή Περιγραφή
Χωρίς Δεν απαιτείται έλεγχος ταυτότητας.
Microsoft Entra Έλεγχος ταυτότητας μέσω του Αναγνωριστικού Microsoft Entra.
Γενικό OAuth 2.0 Έλεγχος ταυτότητας μέσω μιας γενικής υπηρεσίας παροχής OAuth 2.0.

Δυνατότητες αντιπροσώπων

Αυτή η ενότητα παραθέτει τις δυνατότητες (εργαλεία και γνώσεις) του παράγοντα. Προς το παρόν, εμφανίζει λεπτομερή δεδομένα μόνο για τις συνδέσεις που χρησιμοποιούνται από τον παράγοντα και μια διαμόρφωση γνώσεων, όπως περιγράφεται αναλυτικά στις παρακάτω ενότητες.

Η απογραφή έχει έναν περιορισμό 200 έως 200 πόρων για κάθε τύπο ανά πράκτορα. Μάθετε περισσότερα στους Γνωστούς περιορισμούς.

Η απογραφή καταργεί αυτόματα διπλότυπους πόρους, όπως μια σύνδεση Power Platform που έχετε ρυθμίσει δύο φορές σε έναν παράγοντα με την ίδια ρύθμιση παραμέτρων.

Ιδιότητες σύνδεσης

Η απογραφή περιλαμβάνει έναν πίνακα με την ονομασία powerPlatformConnectors, ο οποίος περιέχει τις συνδέσεις Power Platform που έχουν ρυθμιστεί σε έναν παράγοντα. Κάθε σύνδεση αναγνωρίζεται από την connectorId (μια συμβολοσειρά που περιέχει το αναγνωριστικό πόρου της σύνδεσης, για παράδειγμα, shared_excelonlinebusiness). Για κάθε ρυθμισμένο σύνδεσμο, υπάρχει μια λίστα με τα ρυθμισμένα operations. Η λίστα περιλαμβάνει τις ακόλουθες ιδιότητες:

Property Τύπος δεδομένων Περιγραφή Κατάσταση
OperationId συμβολοσειρά Το αναγνωριστικό της συγκεκριμένης λειτουργίας εντός της σύνδεσης, για παράδειγμα, AddRowV2 Προεπισκόπηση
createdBy GUID Ο χρήστης που ρυθμίζονται οι παράμετροι της λειτουργίας Προεπισκόπηση
isEnabled δυαδική τιμή Εάν η λειτουργία σύνδεσης είναι ενεργοποιημένη τη συγκεκριμένη στιγμή Προεπισκόπηση
usedAs συμβολοσειρά Πώς χρησιμοποιείται η λειτουργία:
  • Tool εάν έχει ρυθμιστεί ως γενικό εργαλείο
  • Topic Tool εάν έχει ρυθμιστεί ως εργαλείο σε ένα συγκεκριμένο θέμα
  • Knowledge εάν η σύνδεση έχει ρυθμιστεί ως προέλευση γνώσεων
 Προεπισκόπηση
requiresEndUserConsent δυαδική τιμή Εάν οι τελικοί χρήστες πρέπει να δίνουν τη συγκατάθεσή τους πριν ο παράγοντας μπορεί να χρησιμοποιήσει τη λειτουργία Προεπισκόπηση
whenCanBeUsed συμβολοσειρά Πότε μπορεί να κληθεί η λειτουργία:
  • Anytime εάν το εργαλείο είναι διαθέσιμο στον παράγοντα χωρίς περιορισμούς
  • ViaDirectReferenceOnly εάν ο παράγοντας χρησιμοποιεί το εργαλείο μόνο όταν ο δημιουργός το ρυθμίζει ρητά σε συγκεκριμένα θέματα
  • Conditional εάν ο παράγοντας μπορεί να χρησιμοποιήσει το εργαλείο σύμφωνα με μια προκαθορισμένη λογική από τον κατασκευαστή
 Προεπισκόπηση
connectionProvider συμβολοσειρά Ποιος παρέχει τη σύνδεση για τη λειτουργία:
  • User εάν ο τελικός χρήστης παρέχει διαπιστευτήρια στον χρόνο εκτέλεσης
  • Maker εάν ο δημιουργός ορίσει τη σύνδεση τη στιγμή της σύνταξης
 Προεπισκόπηση
connectionIdSharedByMaker GUID Αναγνωριστικό σύνδεσης, συμπληρώνεται μόνο όταν connectionProvider = Maker Προεπισκόπηση
Παράδειγμα
{
  "type": "microsoft.copilotstudio/agents",
  "properties": {
    "displayName": "Customer Support Agent",
    "createdIn": "Copilot Studio",
    "powerPlatformConnectors": [
      {
        "connectorId": "shared_excelonlinebusiness",
        "operations": [
          {
            "operationId": "RunScriptProd",
            "usedAs": "Tool",
            "isEnabled": true,
            "requiresEndUserConsent": false,
            "whenCanBeUsed": "ViaDirectReferenceOnly",
            "connectionProvider": "Maker",
            "connectionIdSharedByMaker": "11112222-3333-4444-5555-666677778888",
            "createdBy": "52bff06b-5db5-42cd-9919-28f95e3c07af"
          }
        ]
      }
    ],
    "capabilitiesCounts": {
      "distinctPowerPlatformConnectors": 2,
      "distinctPowerPlatformConnectorsOperations": 3
    }
  }
}

Ιδιότητες γνωσιακής βάσης

Η απογραφή περιλαμβάνει την ακόλουθη ιδιότητα για πληροφορίες:

Property Τύπος δεδομένων Περιγραφή Κατάσταση
IsWebSearchEnabledForKnowledge δυαδική τιμή True εάν ο παράγοντας μπορεί να χρησιμοποιήσει την αναζήτηση web ως προέλευση γνώσεων Προεπισκόπηση

Γνωστοί περιορισμοί

  • Δεν παρακολουθούνται πράκτορες V1 - Το απόθεμα δεν περιλαμβάνει πράκτορες που δημιουργήθηκαν με τον αρχικό χρόνο εκτέλεσης Των Power Virtual Agents V1. Παρακολουθεί μόνο τους πράκτορες V2 (Copilot Studio).
  • Οι ιδιότητες ταυτότητας ενδέχεται να μην είναι διαθέσιμες για όλους τους παράγοντες - Τα πεδία entraAgentId και entraAgentBlueprintId συμπληρώνονται μόνο για παράγοντες που έχουν υλοποιηθεί με το νεότερο μοντέλο ταυτότητας παράγοντα Entra. Οι παλαιότεροι πράκτορες μπορεί να έχουν μόνο entraAppId και Microsoft 365 Copilot πράκτορες του Agent Builder δεν έχουν καμία από αυτές τις ιδιότητες ταυτότητας.
  • Πλήθος δυνατοτήτων - Η απογραφή έχει έναν περιορισμό 200 έως 200 πόρων κάθε τύπου ανά πράκτορα. Εάν ένας παράγοντας έχει περισσότερους από 200 ρυθμισμένους πόρους από έναν συγκεκριμένο τύπο (για παράδειγμα, συνδέσεις Power Platform), η απογραφή εμφανίζει τυχαίους 200. Οι διαχειριστές μπορούν να χρησιμοποιήσουν το capabilitiesCounts πεδίο για να κατανοήσουν πόσοι πόροι ρυθμίζονται σε έναν παράγοντα ανά τύπο.

Σχετικό περιεχόμενο

  • Last updated on