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

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

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

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

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

Σημαντικό

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

Προαπαιτούμενα

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

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

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

Σημείωμα

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

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

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

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

Μάθετε περισσότερα στην τεκμηρίωση αναφοράς API για την κατάσταση καραντίνας του bot.

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

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

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

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

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

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

  • Last updated on