Απόθεμα παραγόντων Microsoft Copilot Studio

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

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

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

Σημείωμα

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

Σημαντικό

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

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

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

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

Το απόθεμα παρέχει τις ακόλουθες ιδιότητες για κάθε παράγοντα.

Σημείωμα

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

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

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

Διαδρομή πεδίου API Τύπος δεδομένων Description Παράδειγμα Κατάσταση
properties.displayName string Το εμφανιζόμενο όνομα του παράγοντα. 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 του χρήστη που δημιούργησε τον παράγοντα. aaaa0000-bb11-2222-33cc-444444dddddd Γενικά διαθέσιμο
properties.ownerId string Το αναγνωριστικό αντικειμένου (Entra ID) του τρέχοντος κατόχου του παράγοντα. aaaa0000-bb11-2222-33cc-444444dddddd Γενικά διαθέσιμο
properties.environmentId string Το αναγνωριστικό του περιβάλλοντος Power Platform που περιέχει τον πόρο. aaaa0000-bb11-2222-33cc-444444dddddd Γενικά διαθέσιμο
properties.lastPublishedAt datetime Η ημερομηνία και ώρα της δημοσίευσης του παράγοντα. Κενό/μηδενικό εάν ο παράγοντας βρίσκεται ακόμα σε στάδιο προσχεδίου. 2026-01-15T10:30:00Z Γενικά διαθέσιμο
properties.createdIn string Το εργαλείο σύνταξης όπου δημιουργήθηκε ο παράγοντας: Copilot Studio ή Microsoft 365 Copilot Agent Builder. Copilot Studio Γενικά διαθέσιμο
properties.schemaName string Όνομα σχήματος Dataverse. Διατίθεται για παράγοντες Copilot Studio και Microsoft 365 Copilot Agent Builder. cr5e3_agentName Γενικά διαθέσιμο
properties.isQuarantined boolean Εάν ο παράγοντας βρίσκεται επί του παρόντος σε καραντίνα. false Έκδοση προεπισκόπηση
properties.quarantinedAt datetime Η ημερομηνία και ώρα της τελευταίας καραντίνας του παράγοντα. 2026-02-01T08:00:00Z Έκδοση προεπισκόπηση
properties.isManaged boolean Υποδεικνύει εάν ο παράγοντας είναι μέρος μιας διαχειριζόμενης λύσης Dataverse. Null για παράγοντες που έχουν δημιουργηθεί στο Agent Builder. false Έκδοση προεπισκόπηση

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

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

Σημείωμα

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

Για να μάθετε περισσότερα σχετικά με τις έννοιες ταυτότητας του Entra, δείτε την ενότητα Εγγραφή εφαρμογής, ταυτότητες παραγόντων και έλεγχος ταυτότητας για το Copilot Studio.

Ρύθμιση παραμέτρων ιδιοτήτων

Διαδρομή πεδίου API Τύπος δεδομένων Description Παράδειγμα Κατάσταση
properties.orchestration string Η λειτουργία ενορχήστρωσης του παράγοντα (μάθετε περισσότερα στις Λειτουργίες ενορχήστρωσης). Generative Έκδοση προεπισκόπηση
properties.model string Το μοντέλο AI που χρησιμοποιεί ο παράγοντας. gpt-4o Έκδοση προεπισκόπηση
properties.authentication string Η λειτουργία ελέγχου ταυτότητας που έχει διαμορφωθεί για τον παράγοντα (μάθετε περισσότερα στις Λειτουργίες ελέγχου ταυτότητας). 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 ID.
Γενική μέθοδος OAuth 2.0 Έλεγχος ταυτότητας μέσω γενικού παρόχου OAuth 2.0.

Δυνατότητες παράγοντα

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

Το απόθεμα έχει μέγιστο όριο 200 πόρων κάθε τύπου ανά παράγοντα. Περισσότερες πληροφορίες στην ενότητα Γνωστοί περιορισμοί.

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

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

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

Ιδιότητα Τύπος δεδομένων Περιγραφή Κατάσταση
OperationId string Το αναγνωριστικό της συγκεκριμένης λειτουργίας εντός του συνδέσμου. Για παράδειγμα, AddRowV2 Έκδοση προεπισκόπηση
createdBy GUID Ο χρήστης που διαμόρφωσε τη λειτουργία Έκδοση προεπισκόπηση
isEnabled boolean Εάν η λειτουργία σύνδεσης είναι ενεργοποιημένη αυτήν τη στιγμή Έκδοση προεπισκόπηση
usedAs string Πώς χρησιμοποιείται η λειτουργία:
  • Tool εάν έχει διαμορφωθεί ως γενικό εργαλείο
  • Topic Tool εάν έχει ρυθμιστεί ως εργαλείο σε ένα συγκεκριμένο θέμα
  • Knowledge αν η σύνδεση έχει διαμορφωθεί ως προέλευση γνώσης
 Έκδοση προεπισκόπηση
requiresEndUserConsent boolean Αν απαιτείται η συγκατάθεση των τελικών χρηστών πριν ο παράγοντας χρησιμοποιήσει τη λειτουργία Έκδοση προεπισκόπηση
whenCanBeUsed string Πότε μπορεί να κληθεί η λειτουργία:
  • Anytime Εάν το εργαλείο είναι διαθέσιμο στον παράγοντα χωρίς περιορισμούς
  • ViaDirectReferenceOnly εάν ο παράγοντας χρησιμοποιεί το εργαλείο μόνο όταν ο δημιουργός το έχει ρητά διαμορφώσει σε συγκεκριμένα θέματα
  • Conditional αν ο παράγοντας μπορεί να χρησιμοποιήσει το εργαλείο σύμφωνα με προκαθορισμένη λογική που έχει ορίσει ο δημιουργός
 Έκδοση προεπισκόπηση
connectionProvider string Ποιος παρέχει τη σύνδεση για τη λειτουργία:
  • 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
    }
  }
}

Ιδιότητες γνώσης

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

Ιδιότητα Τύπος δεδομένων Περιγραφή Κατάσταση
IsWebSearchEnabledForKnowledge boolean Αληθές αν ο παράγοντας μπορεί να χρησιμοποιήσει την αναζήτηση στο Web ως προέλευση γνώσης Έκδοση προεπισκόπηση

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

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

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

  • Last updated on