Αυτοματοποίηση αξιολογήσεων αντιπροσώπων με το API Power Platform

Σημείωμα

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

Η Copilot Studio παρέχει στους δημιουργούς εργαλεία για τη συνεχή αξιολόγηση της απόδοσης των αντιπροσώπων, εκτελώντας αυτοματοποιημένες δοκιμές σε σχέση με προκαθορισμένα σύνολα δοκιμών χρησιμοποιώντας το Power Platform REST API. Χρησιμοποιώντας το REST API, μπορείτε να ενεργοποιήσετε μέσω προγραμματισμού αξιολογήσεις αντιπροσώπων ως μέρος των ροών εργασιών ανάπτυξής σας, όπως κατά τη διάρκεια ενημερώσεων αντιπροσώπων, επικύρωσης έκδοσης ή δοκιμής παλινδρόμησης.

Η αυτοματοποίηση των αξιολογήσεων σάς βοηθά:

• Επαληθεύστε την ποιότητα του παράγοντα μετά την πραγματοποίηση αλλαγών.
• Εκτελέστε επαναλαμβανόμενους ελέγχους επιδόσεων σε σχέση με παράγοντες παραγωγής ή προεργασίας.
• Ενσωματώστε τις δοκιμές αντιπροσώπων σε διοχετεύσεις CI/CD.
• Εντοπισμός παλινδρόμησης στη συμπεριφορά του παράγοντα νωρίς στον κύκλο ζωής ανάπτυξης.

Προϋποθέσεις

• Έχετε το Αναγνωριστικό bot και το Αναγνωριστικό περιβάλλοντος για τον στοχευμένο πράκτορα.
• Ένα σύνολο test που δημιουργήθηκε σε Copilot Studio για τον παράγοντα προορισμού σας.
• Ένα διακριτικό πρόσβασης χρήστη που εκδίδεται από Microsoft Entra ID (OAuth 2.0). Για να λάβετε το διακριτικό, ανατρέξτε στο θέμα Έλεγχος ταυτότητας.
  • Αποκτήστε το διακριτικό πρόσβασης χρησιμοποιώντας το αναγνωριστικό προγράμματος-πελάτη μιας καταχώρησης εφαρμογής που έχει την κατάλληλη εμβέλεια που εκχωρείται στο API Power Platform.

Επισκόπηση για την εκτέλεση αξιολογήσεων με χρήση του REST API

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

1. Συμπληρώστε τις προϋποθέσεις.
2. Βρείτε και ανακτήστε το αναγνωριστικό συνόλου δοκιμών του συνόλου δοκιμών που θέλετε να χρησιμοποιήσετε.
3. Εκτελέστε την αξιολόγηση.
4. Ανακτήστε τα αποτελέσματα χρησιμοποιώντας το αναγνωριστικό εκτέλεσης αξιολόγησης.

Όταν η αίτηση είναι επιτυχής, η αξιολόγηση εκτελείται ασύγχρονα και παράγει αποτελέσματα που μπορείτε να εξετάσετε σε Copilot Studio.

Λειτουργίες API για την αυτοματοποίηση αξιολογήσεων

Copilot Studio υποστηρίζει λειτουργίες REST API που μπορείτε να χρησιμοποιήσετε για να ενεργοποιήσετε αξιολογήσεις μέσω προγραμματισμού σε σχέση με τον πράκτορά σας, χρησιμοποιώντας ένα υπάρχον σύνολο δοκιμών.

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

• Power Platform API και SDK: Από UX-first έως API-first (Ιστολόγιο προγραμματιστών Power Platform)
• Επισκόπηση δυνατότητας προγραμματισμού και επεκτασιμότητας
• Γρήγορα αποτελέσματα με το API Power Platform
• Λειτουργίες APIPower Platform για Copilot Studio πράκτορες

Λήψη συνόλων δοκιμών αντιπροσώπων

• Τελικό σημείο: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/makerevaluation/testsets?api-version=2024-10-01
• Σκοπός: Ανακτήστε έναν πίνακα με τα αναγνωριστικά του συνόλου δοκιμών και άλλες λεπτομέρειες για έναν συγκεκριμένο παράγοντα.
• Απάντηση: Επιστρέφει μια λίστα που ονομάζεται value σύνολα δοκιμών με τις ακόλουθες πληροφορίες:
  • auditInfo: Χρονική σήμανση και αναγνωριστικά χρηστών για τη δημιουργία και την τροποποίηση κάθε συνόλου δοκιμών
  • displayName: Το όνομα του συνόλου δοκιμών.
  • id: Το αναγνωριστικό του συνόλου δοκιμών. Χρησιμοποιήστε την στην Έναρξη αξιολόγησης ενός παράγοντα για να επιλέξετε ποιο σύνολο δοκιμών θα χρησιμοποιήσετε.
  • description: Η περιγραφή του συνόλου δοκιμών.
  • state: Η κατάσταση του συνόλου δοκιμών. Ένα σύνολο δοκιμών με δυνατότητα χρήσης έχει την κατάσταση Active.
  • totalTestCases: Ο αριθμός των υποθέσεων δοκιμής εντός του συνόλου δοκιμών.

Μάθετε περισσότερα στο ενότητα Σύνολα δοκιμών αξιολόγησης δημιουργού λίστας.

Λήψη λεπτομερειών συνόλου δοκιμής παράγοντα

• Τελικό σημείο: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/makerevaluation/testsets/{TestSetId}?api-version=2024-10-01
• Σκοπός: Ανάκτηση λεπτομερειών για ένα συγκεκριμένο σύνολο δοκιμών, χρησιμοποιώντας το αναγνωριστικό συνόλου δοκιμών.
• Απάντηση: Επιστρέφει τις πληροφορίες ενός στοιχείου στον πίνακα απόκρισης συνόλων δοκιμών get agent .

Μάθετε περισσότερα στο ενότητα Σύνολα δοκιμών αξιολόγησης δημιουργού λίστας.

Έναρξη αξιολόγησης παράγοντα

• Τελικό σημείο: POST https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/makerevaluation/testsets/{TestSetId}/run?api-version=2024-10-01
• Σκοπός: Εκτελέστε μια αξιολόγηση για μια δοκιμή που έχει οριστεί χρησιμοποιώντας το σύνολο idδοκιμών . Μπορείτε επίσης να συμπεριλάβετε ένα προφίλ χρήστη για τον έλεγχο ταυτότητας συνδέσεων κατά την εκτέλεση της αξιολόγησης. Χρησιμοποιήστε mcsConnectionId το για να καθορίσετε το προφίλ χρήστη. Εάν δεν προσθέσετε μια mcsConnectionId στην κλήση σας, η αξιολόγηση εκτελείται χωρίς έλεγχο ταυτότητας.
• Απάντηση: Επιστρέφει τις ακόλουθες πληροφορίες:
  • runId: Το αναγνωριστικό για την εκτέλεση αξιολόγησης. Χρησιμοποιήστε αυτό το αναγνωριστικό για να ανακτήσετε λεπτομέρειες αξιολόγησης.
  • lastUpdatedAt: Πότε ενημερώθηκε η κατάσταση εκτέλεσης για τελευταία φορά.
  • executionState: Η κατάσταση της εκτέλεσης ενώ εκτελείται η αξιολόγηση.
  • state: Η τρέχουσα κατάσταση της διαδικασίας.
  • totalTestCases: Ο συνολικός αριθμός των περιπτώσεων δοκιμής στο σύνολο δοκιμών που χρησιμοποιούνται για την αξιολόγηση.
  • testCasesProcessed: Συνολικές υποθέσεις δοκιμής που αξιολογήθηκαν από την τελευταία ενημέρωση.

Μάθετε περισσότερα στο θέμα Εκτέλεση δοκιμής αξιολόγησης δημιουργού.

Ανάκτηση εκτελέσεων δοκιμών παραγόντων

• Τελικό σημείο: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/makerevaluation/testruns?api-version=2024-10-01
• Σκοπός: Ανάκτηση ενός πίνακα όλων των προηγούμενων εκτελέσεων.
• Απάντηση: Κάθε στοιχείο στον πίνακα περιλαμβάνει τις ίδιες τιμές όπως στις λεπτομέρειες εκτέλεσης δοκιμής get agent.

Μάθετε περισσότερα στην ενότητα Εκτελέσεις δοκιμών αξιολόγησης δημιουργού λίστας.

Λήψη λεπτομερειών εκτέλεσης δοκιμής του παράγοντα

• Τελικό σημείο: GET https://api.powerplatform.com/copilotstudio/environments/{EnvironmentId}/bots/{BotId}/api/makerevaluation/testruns/{TestRunId}?api-version=2024-10-01
• Σκοπός: Ανακτήστε τις λεπτομέρειες μιας αξιολόγησης χρησιμοποιώντας το runId για την εκτέλεση της προοριζόμενης αξιολόγησης σας.
• Απάντηση: Επιστρέφει τις ακόλουθες πληροφορίες:
  • id: Το αναγνωριστικό για την εκτέλεση αξιολόγησης. Χρησιμοποιήστε αυτό το αναγνωριστικό για να ανακτήσετε λεπτομέρειες αξιολόγησης.
  • environmentId: Το αναγνωριστικό για το περιβάλλον του παράγοντα σας.
  • cdsBotId: Το αναγνωριστικό για τον πράκτορα στόχο.
  • ownerId: Το αναγνωριστικό του χρήστη που ξεκίνησε την εκτέλεση αξιολόγησης.
  • testSetId: Το αναγνωριστικό του συνόλου δοκιμών που χρησιμοποιείται για την αξιολόγηση.
  • state: Η κατάσταση προόδου της αξιολόγησης.
  • startTime: Όταν ξεκίνησε η αξιολόγηση.
  • endTime: Όταν ολοκληρωθεί η αξιολόγηση, εάν ολοκληρωθεί.
  • name: Το όνομα της αξιολόγησης.
  • totalTestCases: Συνολικές υποθέσεις δοκιμής στο σύνολο δοκιμών.
  • mcsConnectionId: Το αναγνωριστικό σύνδεσης για την Copilot Studio σύνδεση του προφίλ χρήστη που χρησιμοποιείται για την εκτέλεση της αξιολόγησης. null εάν δεν υπάρχει συνδεδεμένο προφίλ χρήστη.
  • testCasesResults: Η λίστα των περιπτώσεων δοκιμής στην εκτέλεση αξιολόγησης. Περιλαμβάνει:
    • testCaseId: Το αναγνωριστικό του case δοκιμής.
    • state: Η κατάσταση ολοκλήρωσης της υπόθεσης δοκιμής.
    • metricsResults: Οι λεπτομέρειες και τα αποτελέσματα για κάθε μέθοδο δοκιμής που χρησιμοποιείται για την υπόθεση δοκιμής. Περιλαμβάνει τα εξής:
      • type: Η μέθοδος δοκιμής.
      • result: Το τελικό αποτέλεσμα της δοκιμής για αυτήν την υπόθεση δοκιμής. Περιλαμβάνει τα εξής:
        • data: Οι λεπτομέρειες του αποτελέσματος. Οι ακριβείς τιμές εξαρτώνται από τη μέθοδο δοκιμής. Μάθετε περισσότερα στα έγγραφα API του Power Platform. Για μια γενική δοκιμή ποιότητας , η απόκριση περιλαμβάνει τα εξής:
          • abstention: Εάν ο παράγοντας απάντησε στο ερώτημα.
          • relevance: Εάν η απάντηση ήταν σχετική.
          • completeness: Εάν η απάντηση είναι πλήρης.
      • status: Η κατάσταση της υπόθεσης δοκιμής.
      • errorReason: Εάν παρουσιάστηκε σφάλμα, η αιτία του σφάλματος.
      • aiResultReason: Η επεξήγηση AI του αποτελέσματος της υπόθεσης δοκιμής.

Μάθετε περισσότερα στην ενότητα Εκτέλεση δοκιμής αξιολόγησης Maker.

Χρήση αναγνωριστικού σύνδεσης Microsoft Studio για αξιολογήσεις

Για Έναρξη αξιολόγησης παράγοντα μπορείτε προαιρετικά να προσθέσετε ένα αναγνωριστικό σύνδεσης Microsoft Studio στην κλήση ως προφίλ χρήστη για την αξιολόγηση. Για να βρείτε το mcsConnectionId:

1. Μεταβείτε στο Power Automate.
2. Ανοίξτε τη σελίδα Συνδέσεις .
3. Επιλέξτε τη σύνδεση Microsoft Copilot Studio.
4. Αντιγράψτε το mcsConnectionId από τη διεύθυνση URL: .../connections/shared_microsoftcopilotstudio/{mcsConnectionId}/details

Σχετικά άρθρα

• Πληροφορίες για την αξιολόγηση του παράγοντα
• Ενεργοποιήστε αξιολογήσεις πρακτόρων με συνδέσμους