Υποβολή αιτήσεων HTTP
Στο Copilot Studio, μπορείτε να επεκτείνετε τις δυνατότητες ενός copilot καλώντας εξωτερικά API REST χρησιμοποιώντας τον κόμβο αίτησης HTTP. Αυτή η κλήση μπορεί να είναι χρήσιμη όταν χρειάζεται να ανακτήσετε δεδομένα από ένα εξωτερικό σύστημα ή να διαχειριστείτε δεδομένα σε αυτό το σύστημα.
Προϋποθέσεις
Χρήση του κόμβου αίτησης HTTP
Επιλέξτε Προσθήκη κόμβου (+), ανοίξτε το υπομενού Πρόσθετα κριτήρια και στη συνέχεια επιλέξτε Αποστολή αίτησης HTTP.
Στο πλαίσιο URL, πληκτρολογήστε τη διεύθυνση URL για το API τελικό σημείο που θέλετε να καλέσετε.
Επιλέξτε την κατάλληλη μέθοδο αίτησης από την αναπτυσσόμενη λίστα. Υποστηρίζονται μέθοδοι GET, POST, PATCH, PUT και DELETE.
Στην περιοχή Κεφαλίδες και σώμα στον κόμβο, επιλέξτε το κουμπί Επεξεργασία, το οποίο ανοίγει το παράθυρο ιδιοτήτων αίτησης HTTP.
Μπορείτε, προαιρετικά, να προσθέσετε μία ή περισσότερες κεφαλίδες στην αίτηση HTTP. Επιλέξτε το κουμπί Προσθήκη για να προσθέσετε το κλειδί και την τιμή κάθε κεφαλίδας.
Από προεπιλογή, δεν αποστέλλεται περιεχόμενο στο σώμα της αίτησης HTTP, αλλά μπορείτε να καθορίσετε περιεχόμενο στο σώμα.
Στον κόμβο, επιλέξτε Τύπος δεδομένων απόκρισης από τις διαθέσιμες επιλογές.
Μπορείτε να δώσετε ένα παράδειγμα απόκρισης JSON, το οποίο μπορείτε συνήθως να βρείτε στην τεκμηρίωση για το API που καλείτε. Δημιουργεί μια μεταβλητή Power Fx, επιτρέποντάς σας να τη χρησιμοποιήσετε αλλού στον καμβά συγγραφής σας, με υποστήριξη intellisense στον επεξεργαστή Power Fx. Επιλέξτε Από δείγμα δεδομένων και, στη συνέχεια, επιλέξτε Λήψη σχήματος από το δείγμα JSON. Επικολλήστε το δείγμα απάντησης στο πρόγραμμα επεξεργασίας και επιλέξτε Επιβεβαίωση.
Στην περιοχή Αποθήκευση απόκρισης ως επιλέξτε πού θέλετε να αποθηκευτεί η απόκριση αιτήματος HTTP, είτε δημιουργώντας μια νέα μεταβλητή είτε επιλέγοντας μια υπάρχουσα.
Αποστολή περιεχομένου στο σώμα της αίτησης HTTP
Στην περιοχή Κεφαλίδες και σώμα στον κόμβο, επιλέξτε το κουμπί Επεξεργασία, το οποίο ανοίγει το παράθυρο ιδιοτήτων αίτησης HTTP.
Στο Σώμα επιλέξτε τον κατάλληλο τύπο περιεχομένου. Από προεπιλογή, το Σώμα έχει οριστεί σε Χωρίς περιεχόμενο, όπου δεν πρέπει να υπάρχει περιεχόμενο στο σώμα της αίτησης, το οποίο χρησιμοποιείται συνήθως με την αίτηση GET. Για να προσθέσετε περιεχόμενο στο σώμα του οργανισμού, επιλέξτε μία από τις διαθέσιμες επιλογές.
Περιεχόμενο JSON: Το περιεχόμενο JSON σάς επιτρέπει να παρέχετε ένα αντικείμενο JSON στο σώμα της αίτησης. Αυτό το αντικείμενο χρησιμοποιείται συχνά κατά την υποβολή αιτήσεων POST ή PUT. Όταν επιλέξετε αυτή την επιλογή, ένα πρόγραμμα επεξεργασίας σάς επιτρέπει να καταχωρήσετε το περιεχόμενο JSON.
Μπορείτε επίσης να καθορίσετε το περιεχόμενο JSON χρησιμοποιώντας Power Fx, επιτρέποντάς σας να συμπεριλάβετε δυναμικές τιμές και μεταβλητές αναφοράς. Επιλέξτε το κουμπί Επεξεργασία JSON, επιλέξτε Τύπος και, στη συνέχεια, εισαγάγετε ένα αντικείμενο Power Fx (τυχόν υπάρχον JSON που είχε εισαχθεί μετατρέπεται σε αντικείμενο Power Fx για εσάς), το οποίο μετατρέπεται σε JSON όταν γίνεται η αίτηση HTTP.
Μη επεξεργασμένο περιεχόμενο: Το μη επεξεργασμένο περιεχόμενο σάς επιτρέπει να εισαγάγετε μια συμβολοσειρά δεδομένων στο σώμα της αίτησης και αυτή η συμβολοσειρά μπορεί να είναι τύπος περιεχομένου που καθορίζετε. Το ακατέργαστο περιεχόμενο εισάγεται χρησιμοποιώντας έναν τύπο Power Fx, όπως το περιεχόμενο συμβολοσειράς που παρουσιάζεται στο ακόλουθο παράδειγμα.
Χειρισμός σφαλμάτων και λήξης χρονικού ορίου
Ο κόμβος αιτήματος HTTP περιλαμβάνει πολλές επιλογές για το χειρισμό σε περιπτώσεις όπου η αίτηση HTTP ενδέχεται να αποτύχει ή να επιστρέψει ένα σφάλμα.
Από προεπιλογή, η λειτουργία "εγείρει σφάλμα". Αυτό σημαίνει ότι όταν μια αίτηση HTTP επιστρέψει ένα σφάλμα ή αποτύχει στην εκτέλεσή της, το copilot διακόπτει τη λειτουργία της και ενεργοποιεί το θέμα συστήματος Σφάλμα, εμφανίζοντας ένα μήνυμα σφάλματος.
Ωστόσο, μπορείτε να ρυθμίσετε τις παραμέτρους του χειρισμού σφαλμάτων ώστε να μην ενεργοποιηθεί το θέμα συστήματος σφάλματος. Αντίθετα, συμπληρώνει τον κωδικό κατάστασης HTTP και οποιοδήποτε σώμα απόκρισης σφάλματος σε μεταβλητές που καθορίζετε, επιτρέποντάς σας να εξετάζετε αυτές τις μεταβλητές ανάλογα με τις ανάγκες και να συνεχίσετε την εκτέλεση του θέματος. Αυτή η ρύθμιση παραμέτρων είναι χρήσιμη σε σενάρια όπου θέλετε το copilot να συνεχίσει τη λειτουργία του ακόμα και εάν αποτύχει μια συγκεκριμένη αίτηση HTTP.
Για να ρυθμίσετε τη συμπεριφορά χειρισμού σφαλμάτων.
Στην περιοχή Κεφαλίδες και σώμα στον κόμβο, επιλέξτε το κουμπί Επεξεργασία, το οποίο ανοίγει το παράθυρο ιδιοτήτων αίτησης HTTP.
Επιλέξτε την επιθυμητή συμπεριφορά από την αναπτυσσόμενη λίστα Χειρισμός σφαλμάτων.
Αν επιλέξετε Συνέχεια σε σφάλμα, ρυθμίστε τον Κωδικό κατάστασης και τις μεταβλητές Σώμα απόκρισης σφάλματος είτε δημιουργώντας νέες μεταβλητές είτε επιλέγοντας υπάρχουσες μεταβλητές από τον επιλογέα.
Σε αυτό το δείγμα κώδικα, εάν η αίτηση HTTP αποτύχει, το copilot αποθηκεύει τον κωδικό κατάστασης HTTP στη μεταβλητή Topic.StatusCode και το σώμα της απάντησης στη μεταβλητή Topic.ErrorResponse. Το copilot συνεχίζει στα επόμενα βήματά του στο θέμα.
Ο τύπος μεταβλητής απόκρισης σφάλματος είναι Οποιοσδήποτε. Μπορείτε να χρησιμοποιήσετε τον κόμβο Ανάλυση τιμής για να μετατρέψετε αυτήν τη μεταβλητή σε καρτέλα Power Fx.
Το τμήμα παραθύρου ιδιοτήτων περιέχει επίσης μια ιδιότητα Χρονικό όριο αίτησης η οποία αποδέχεται μια τιμή σε χιλιοστά του δευτερολέπτου. Η προεπιλεγμένη τιμή είναι 30 δευτερόλεπτα, αλλά μπορείτε να αλλάξετε αυτήν την τιμή, εάν χρειάζεται.