Επέκταση του παράγοντα με εργαλεία από ένα REST API (προεπισκόπηση)

[Αυτό το άρθρο αποτελεί τεκμηρίωση προέκδοσης και ενδέχεται να αλλάξει.]

Μπορείτε να χρησιμοποιήσετε τα REST API (συμπεριλαμβανομένου του OpenAI API) για να συνδέσετε έναν παράγοντα που δημιουργείτε με εξωτερικά συστήματα και να αποκτήσετε πρόσβαση σε διαθέσιμα δεδομένα για χρήση εντός του παράγοντα σας. Μπορείτε να συνδέσετε τον παράγοντα σας σε ένα REST API παρέχοντας το Copilot Studio με τρία πράγματα:

• Μια OpenAPI προδιαγραφή που καθορίζει τις λειτουργίες και τις διαθέσιμες ενέργειες του API
• Λεπτομέρειες σχετικά με τον τύπο ελέγχου ταυτότητας που απαιτείται και τα στοιχεία ελέγχου ταυτότητας για τη σύνδεση των χρηστών στο API για πρόσβαση στο εξωτερικό σύστημα
• Περιγραφές που βοηθούν το μοντέλο γλώσσας να καθορίσει πότε πρέπει να καλέσει το API για να χρησιμοποιήσει τα δεδομένα

Τα REST API μπορούν να προστεθούν σε παράγοντες Copilot και προσαρμοσμένους παράγοντες μέσω Copilot Studio.

Important

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

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

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

Οι παράγοντες Copilot επιτρέπουν σε έναν κατασκευαστή να συνδυάζει πολλαπλές προελεύσεις δεδομένων, όπως συνδέσεις, API, προτροπές και πηγές γνώσης σε ένα μόνο παράγοντα. Μπορείτε να χρησιμοποιήσετε αυτόν τον παράγοντα για να επεκτείνετε τις εμπειρίες παράγοντα με την επωνυμία της Microsoft, όπως Microsoft 365 Copilot.

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

Σημείωμα

Τα εργαλεία REST API πρέπει να δημιουργούνται από μια προδιαγραφή OpenAPI v2. Αυτή η απαίτηση οφείλεται στη συμπειφορά του Power Platform στην επεξεργασία των προδιαγραφών API. Εάν υποβληθεί μια προδιαγραφή v3, μεταφράζεται αυτόματα σε μια προδιαγραφή v2 κατά τη διαδικασία δημιουργίας.

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

Απαιτούνται ορισμένες προϋποθέσεις για την επέκταση της εμπειρίας παράγοντα με την επωνυμία της Microsoft με ενέργειες συνδέσμου.

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

Χρειάζεστε επίσης ένα αντίγραφο των OpenAPI προδιαγραφών, γνώση του τύπου ελέγχου ταυτότητας που απαιτείται και τα στοιχεία ελέγχου ταυτότητας.

Προσθήκη ενέργειας REST API σε έναν παράγοντα

Η προσθήκη ενός REST API στον παράγοντα σας περιλαμβάνει μερικά βήματα. Οι ακόλουθες ενότητες σας εξηγούν τη διαδικασία.

Η διαδικασία προσθήκης ενός REST API είναι ίδια τόσο για εξατομικευμένους όσο και για παράγοντες Copilot.

Υπάρχουν μερικά βήματα στη διαδικασία.

Προσθήκη ενέργειας σε παράγοντα

1. μεταβείτε στη σελίδα Επισκόπηση του παράγοντα σας.

   

2. Στην ενότητα Εργαλεία , επιλέξτε Προσθήκη εργαλείου. Μπορείτε επίσης να μεταβείτε στην καρτέλα Εργαλεία και να επιλέξετε Προσθήκη εργαλείου.

   Εμφανίζεται η σελίδα Προσθήκη εργαλείου .

3. Επιλέξτε Νέο εργαλείο>REST API.

Παροχή προδιαγραφής, περιγραφής και λύσης API

1. Ανεβάστε ένα OpenAPI αρχείο προδιαγραφών για το REST API στο οποίο θέλετε να συνδεθείτε. Μπορείτε είτε να σύρετε και να αποθέσετε το αρχείο προδιαγραφών στην οθόνη Αποστολή REST API είτε να περιηγηθείτε στο σύστημά σας για να εντοπίσετε το αρχείο που θέλετε να χρησιμοποιήσετε.

   

   Σημείωμα

   Η OpenAPI προδιαγραφή πρέπει να είναι ένα αρχείο JSON σε μορφή v2. Εάν υποβληθεί μια προδιαγραφή v3, μεταφράζεται αυτόματα σε μια προδιαγραφή v2 κατά τη διαδικασία δημιουργίας.

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

   

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

2. Επαληθεύστε τις λεπτομέρειες και, στη συνέχεια, κάντε κλικ στο κουμπί Επόμενο.

   Εμφανίζεται μια σελίδα λεπτομερειών πρόσθετου API όπου μπορείτε να παρέχετε πρόσθετες πληροφορίες σχετικά με το API.

   

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

   Για παράδειγμα, η αρχική περιγραφή που παρέχεται είναι: "Μια απλή υπηρεσία για τη διαχείριση εισιτηρίων".

   Μια καλύτερη περιγραφή είναι: "Ένα σύστημα που χρησιμοποιείται για τη λήψη, ανάκτηση, εύρεση και εμφάνιση υπαρχόντων εισιτηρίων από το SunnyADO." Επιτρέπει στους χρήστες να ενημερώνουν, να αλλάζουν και να διαχειρίζονται εισιτήρια για να παρέχουν περισσότερα δεδομένα για τη βελτίωση των αρχείων.

3. Εισαγάγετε μια βελτιωμένη περιγραφή στο πεδίο Περιγραφή.

4. Στην περιοχή Λύση, ένα αναπτυσσόμενο μενού απαριθμεί όλες τις λύσεις που είναι διαθέσιμες στο τρέχον περιβάλλον. Επιλέξτε τη λύση που θέλετε να χρησιμοποιήσετε. Για περισσότερες πληροφορίες σχετικά με τις λύσεις που υπάρχουν, ανατρέξτε στο θέμα Έννοιες λύσεων.

   

   Εάν έχετε μια προτιμώμενη λύση ή η επιλεγμένη σύνδεση βρίσκεται ήδη στη λύση, τότε η λύση επιλέγεται αυτόματα.

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

   Σημείωμα

   Εάν δεν βλέπετε την προεπιλεγμένη λύση ή την προεπιλεγμένη λύση CDS ως επιλογή σε αυτήν την περίπτωση, συνιστούμε να έχετε μια προσαρμοσμένη λύση για εύκολη διαχείριση. Για περισσότερες πληροφορίες, δείτε: Προεπιλεγμένη λύση έναντι προεπιλεγμένης λύσης.

5. Με επιλεγμένη λύση, επιλέξτε Επόμενο για να συνεχίσετε.

Παροχή λεπτομερειών ελέγχου ταυτότητας

Εμφανίζεται η σελίδα Έλεγχος ταυτότητας, για να επιλέξετε τον τύπο ελέγχου ταυτότητας που θα χρησιμοποιηθεί για το API.

Σημείωμα

Προς το παρόν, οι διαθέσιμες επιλογές είναι Καμία, Auth 2.0 και API.

1. Επιλέξτε μια μεθόδου ελέγχου ταυτότητας από τη λίστα.

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

   • Κανένα: Δεν απαιτούνται άλλα πεδία.
   • Κλειδί API:
     • Ετικέτα παραμέτρου: Μια ετικέτα κειμένου για την παράμετρο API.
     • Όνομα παραμέτρου: Ένα όνομα κειμένου για την παράμετρο API.
     • Θέση παραμέτρου: Η θέση όπου μπορεί να βρεθεί η παράμετρος.
   • Έλεγχος ταυτότητας 2.0:
     • Αναγνωριστικό προγράμματος-πελάτη: GUID προγράμματος-πελάτη για την υπηρεσία προορισμού.
     • Μυστικός κωδικός προγράμματος-πελάτη – Μυστική αξία για τον πελάτη. Το μυστικό δεν εμφανίζεται όταν ο χρήστης ανοίξει τον πίνακα επεξεργασίας μετά. Ωστόσο, αποθηκεύστε το μυστικό, γιατί θα το χρειαστείτε εάν επιλέξετε να κάνετε περαιτέρω αλλαγές.
     • URL εξουσιοδότησης: URL που χρησιμοποιείται για την εξουσιοδότηση του συστήματος προέλευσης.
     • URL διακριτικού: URL όπου μπορεί να ανακτηθεί το διακριτικό.
     • Διεύθυνση URL ανανέωσης: Σε ποια διεύθυνση URL θα ανακατευθυνθείτε σε ένα σενάριο ανανέωσης.
     • Πεδίο εφαρμογής: Η διεύθυνση URL πεδίου που έχει εκχωρηθεί στο API για Microsoft Entra εφαρμογές.
     • Ποιος οργανισμός του Microsoft 365 έχει πρόσβαση στα τελικά σημεία: Αυτό περιορίζει την πρόσβαση στην πηγή είτε στον οργανισμό του δημιουργού είτε σε όλους τους οργανισμούς.
     • Ποια εφαρμογή (υπολογιστής-πελάτης) μπορεί να χρησιμοποιήσει τα τελικά σημεία: GUID που καθορίζει το σύστημα-πελάτη που μπορεί να χρησιμοποιηθεί για πρόσβαση σε αυτά τα δεδομένα. Οι εφαρμογές θα μπορούσαν να περιλαμβάνουν Microsoft 365, Power Automate και άλλες επιλογές.

3. Μόλις συμπληρωθούν όλα τα πεδία, επιλέξτε Επόμενο.

   Θα εμφανίζεται μια σελίδα Select και ρύθμιση παραμέτρων του εργαλείου προσθήκης , όπου μπορείτε να επιλέξετε εργαλεία για ενεργοποίηση για το API.

   

Επιλογή εργαλείων για το API

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

1. Επιλέξτε ένα εργαλείο από τη λίστα για να ρυθμίσετε τις παραμέτρους.

   Εμφανίζεται η σελίδα Ρύθμιση παραμέτρων ενέργειας προσθήκης.

   

2. Ρύθμιση παραμέτρων της επιλεγμένης ενέργειας. Όπως και με το συνολικό API, θα σας ζητηθεί να καταχωρήσετε ένα Όνομα εργαλείου και Μια Περιγραφή εργαλείου. Οι περιγραφές αρχικά προσυμπληρώνονται από τις περιγραφές στην προδιαγραφή API. Το όνομα δεν χρειάζεται να είναι μοναδικό, αλλά θα πρέπει να αντιπροσωπεύει το ίδιο το εργαλείο. Η περιγραφή, όπως και με τη συνολική περιγραφή API, θα πρέπει να είναι αρκετά συγκεκριμένη ώστε να παρέχει στο μοντέλο γλώσσας λεπτομέρειες, ώστε να αναγνωρίζει καλύτερα ότι το ερώτημά σας ευθυγραμμίζεται με αυτό το συγκεκριμένο εργαλείο.

3. Μόλις συμπληρωθούν τα πεδία, επιλέξτε Επόμενο.

   Εμφανίζεται η σελίδα Εξέταση των παραμέτρων του εργαλείου σας .

   

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

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

5. Αφού ολοκληρώσετε τις περιγραφές, επιλέξτε Επόμενο.

   Το πρώτο εργαλείο έχει ρυθμιστεί τώρα και εμφανίζεται στη λίστα επιλεγμένων εργαλείων στη σελίδα "Επιλογή και ρύθμιση παραμέτρων του εργαλείου προσθήκης ".

   

6. Προσθέστε τυχόν άλλες ενέργειες που θέλετε να συμπεριλάβετε αυτήν τη στιγμή. Όταν ολοκληρώσετε την προσθήκη εργαλείων που θέλετε να υποστηρίζει ο πράκτοράς σας, επιλέξτε Επόμενο.

   Εμφανίζεται η σελίδα Έλεγχος του εργαλείου σας . Η σελίδα παρέχει τις λεπτομέρειες του ρυθμισμένου εργαλείου REST API.

   

Αναθεώρηση και δημοσίευση

1. Εάν πρέπει να κάνετε ενημερώσεις, μπορείτε να επιλέξετε Πίσω και να κάνετε τις αλλαγές σας. Διαφορετικά, επιλέξτε Επόμενο.

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

2. Αφού ολοκληρωθεί η δημοσίευση, θα επιστρέψετε στην οθόνη Επιλογή εργαλείου . Εδώ μπορείτε να προσθέσετε το πρόσφατα διαμορφωμένο REST API στον παράγοντα Copilot ή στον προσαρμοσμένο παράγοντα και να ολοκληρώσετε τη διαμόρφωση του στοιχείου.

   

Το εργαλείο REST API είναι τώρα διαθέσιμο για χρήση στον πράκτορά σας.

Φιλοδώρημα

Για να βρείτε πιο εύκολα το εργαλείο σας, χρησιμοποιήστε τη γραμμή αναζήτησης για να το εντοπίσετε.