Καραντίνα μη συμβατών παραγόντων με το API Power Platform

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

Η καραντίνα παραγόντων αποτελεί μέρος του ευρύτερου πλαισίου ασφαλείας του Copilot Studio και λειτουργεί παράλληλα με τη συνολική προσέγγιση ασφάλειας στο Copilot Studio.

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

Οι παράγοντες που βρίσκονται σε καραντίνα εξακολουθούν να είναι ορατοί στους χρήστες και τους δημιουργούς παραγόντων στο Copilot Studio, αλλά δεν είναι δυνατή η αλληλεπίδραση με τον παράγοντα ούτε η χρήση του.

Σημαντικό

Ο χώρος ονομάτων powervirtualgents έχει καταργηθεί. Χρησιμοποιήστε τον χώρο ονομάτων copilotstudio στις κλήσεις API σας.

Προαπαιτούμενα στοιχεία

  • Έχετε το Αναγνωριστικό bot και το Αναγνωριστικό περιβάλλοντος για τον παράγοντα προορισμού.
  • Πρέπει να λάβετε ένα διακριτικό πρόσβασης χρήστη που εκδίδεται από το Microsoft Entra ID OAuth2. Για να λάβετε ένα διακριτικό, δείτε Έλεγχος ταυτότητας.
    • Ο χρήστης που σχετίζεται με το διακριτικό πρέπει να έχει έναν από τους ακόλουθους ρόλους διαχειριστή:
      • Καθολικός διαχειριστής μισθωτή
      • Διαχειριστής AI
      • Διαχειριστής Power Platform
    • Πρέπει να αποκτήσετε το διακριτικό πρόσβασης χρησιμοποιώντας το αναγνωριστικό πελάτη μιας καταχώρησης εφαρμογής που έχει το πεδίο CopilotStudio.AdminActions.Invoke εκχωρημένο στο Power Platform API.

Λειτουργίες API για τη διαχείριση καραντίνας παραγόντων

Το Copilot Studio υποστηρίζει τρεις βασικές λειτουργίες REST API για τη διαχείριση της καραντίνας των παραγόντων, ως μέρος του API Power Platform.

Σημείωμα

Τα API SetAsQuarantined και SetAsUnquarantined δεν υποστηρίζουν κλασικά bot συνομιλίας. Το API επιστρέφει 405 Method Not Allowed όταν προσπαθείτε να θέσετε σε καραντίνα ή να αφαιρέσετε από την καραντίνα ένα κλασικό bot συνομιλίας.

Για περισσότερες πληροφορίες σχετικά με το πώς και πότε μπορείτε να χρησιμοποιήσετε το Power Platform API, ανατρέξτε στα εξής:

Λήψη κατάστασης καραντίνας παράγοντα

  • Τελικό σημείο: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine?api-version=1
  • Σκοπός: Ανάκτηση της τρέχουσας κατάστασης καραντίνας ενός παράγοντα
  • Απόκριση: Επιστρέφει μια δυαδική τιμή isBotQuarantined και lastUpdateTimeUtc

Μάθετε περισσότερα στην τεκμηρίωση αναφοράς του API Get Bot Quarantine Status.

Ορισμός παράγοντα ως σε καραντίνα

  • Τελικό σημείο: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsQuarantined?api-version=1
  • Σκοπός: Επισημάνετε έναν παράγοντα ως σε καραντίνα, περιορίζοντας τη διαθεσιμότητα και τις αλληλεπιδράσεις του
  • Απάντηση: Επιβεβαιώνει την ενημέρωση κατάστασης καραντίνας

Μάθετε περισσότερα στην τεκμηρίωση αναφοράς API Set Bot As Quarantined.

Ορισμός παράγοντα ως μη τεθειμένου σε καραντίνα

  • Τελικό σημείο: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/botQuarantine/SetAsUnquarantined?api-version=1
  • Σκοπός: Καταργήστε ένα παράγοντα από τη καραντίνα μετά την εκτίμηση κινδύνου και την αποκατάσταση
  • Απάντηση: Επιβεβαιώνει την ενημέρωση κατάστασης καραντίνας

Μάθετε περισσότερα στην τεκμηρίωση αναφοράς API Set Bot As Unquarantined.

  • Last updated on