Σύνδεση σε έναν παράγοντα Microsoft Foundry (έκδοση προεπισκόπησης)

Σημείωση

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

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

Μπορείτε να συνδέσετε έναν Παράγοντα Microsoft Foundry με τον προσαρμοσμένο παράγοντά σας, επιτρέποντάς σας να καλέσει αυτόν τον παράγοντα για να ανταποκριθεί σε έναν χρήστη ή ένα έναυσμα.

Σημαντικό

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

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

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

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

Πριν συνδέσετε ένα copilot Microsoft Foundry στο Copilot Studio, το copilot Foundry πρέπει να έχει ενεργοποιημένο το τελικό σημείο πρωτοκόλλου Activity. Ένας νεοδημιουργημένος πράκτορας Foundry εκθέτει μόνο τα τελικά σημεία του πρωτοκόλλου Responses και A2A από προεπιλογή. Εάν το τελικό σημείο δραστηριότητας δεν είναι ενεργοποιημένο, η σύνδεση με το Copilot Studio αποτυγχάνει κατά τον χρόνο εκτέλεσης με σφάλμα 400. Μάθετε περισσότερα στο άρθρο Ενεργοποίηση εισερχόμενων συνδέσεων A2A σε πράκτορα Foundry.

Προς το παρόν, μπορείτε να ενεργοποιήσετε το τελικό σημείο δραστηριότητας μόνο μέσω προγραμματισμού, χρησιμοποιώντας το REST API ή το Python SDK. Δεν υπάρχει επιλογή ενεργοποίησης από την πύλη Microsoft Foundry. Μάθετε περισσότερα σχετικά με τη διαδικασία ενεργοποίησης στην ενότητα Ρύθμιση παραμέτρων και κοινή χρήση του copilot σας.

Αφού ενεργοποιήσετε το Activity endpoint, η ενότητα Τελικά σημεία στην πύλη Foundry για τον παράγοντα συνεχίζει να εμφανίζει μόνο τα Αποκρίσεις και A2A. Αυτή η παράλειψη διεπαφής χρήστη είναι αναμενόμενη και δεν σημαίνει ότι η αλλαγή απέτυχε. Η σύνδεση με το Copilot Studio λειτουργεί μετά την εφαρμογή της ενημέρωσης.

Σύνδεση με έναν παράγοντα Microsoft Foundry

1. Μεταβείτε στη σελίδα Παράγοντες για τον κύριο παράγοντά σας και επιλέξτε Προσθήκη παράγοντα.

2. Στην περιοχή Σύνδεση με εξωτερικό παράγοντα, επιλέξτε Microsoft Foundry από τους διαθέσιμους τύπους παραγόντων.

3. Επιλέξτε τη σύνδεση που θέλετε από τη λίστα διαθέσιμων συνδέσεων ή δημιουργήστε μια νέα σύνδεση μεταξύ του Microsoft Foundry και του παράγοντα Copilot Studio. Για να δημιουργήσετε μια νέα σύνδεση, πρέπει να καταχωρήσετε τη διεύθυνση URL τελικού σημείου έργου Foundry.

   Σημείωση

   Κατά τη σύνδεση με πράκτορες του Microsoft Foundry από το Copilot Studio, μπορείτε να συνδεθείτε μόνο με υπαλλήλους που έχουν δημιουργηθεί στη νέα πύλη Microsoft Foundry. Η σύνδεση με έναν παράγοντα που δημιουργήθηκε στην προηγούμενη πύλη οδηγεί σε ένα σφάλμα που υποδεικνύει 404 - Version not found.

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

5. Εισαγάγετε ένα κατάλληλο όνομα και περιγραφή για τον παράγοντα SDK. Η περιγραφή θα πρέπει να περιγράφει τον σκοπό του παράγοντα Microsoft Foundry, επιτρέποντας στον κύριο παράγοντά σας να κατανοήσει πότε πρέπει να χρησιμοποιηθεί. Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Σύνταξη αποτελεσματικών μετα-δεδομένων.

6. Εισαγάγετε το Αναγνωριστικό παράγοντα για τον παράγοντα Microsoft Foundry στον οποίο θέλετε να συνδεθείτε.

7. Προσαρμόστε την περιγραφή (εάν χρειάζεται) για να την κάνετε πιο συμφραζόμενη για τον κύριο πράκτορα. Για παράδειγμα, κάντε την περιγραφή πιο συγκεκριμένη εάν έχετε άλλα εργαλεία ή στοιχεία στα οποία οι περιγραφές ενδέχεται να επικαλύπτονται. Ενημερώστε την περιγραφή για να βεβαιωθείτε ότι το Copilot Studio μπορεί να κατανοήσει πότε πρέπει να καλέσει αυτόν τον εκπρόσωπο.

8. Επιλέξτε Προσθήκη παράγοντα.

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

Σημείωση

• Εάν η πρώτη δοκιμαστική κλήση στον συνδεδεμένο παράγοντα Foundry αποτύχει με σφάλμα παρόμοιο με "Η σύνδεση "Azure AI Foundry Agent Service" επέστρεψε ένα σφάλμα HTTP με κωδικό 400. Εσωτερικό σφάλμα: Το τελικό σημείο παράγοντα <name> δεν υποστηρίζει δραστηριότητα. Ενημερώστε το τελικό σημείο του παράγοντα ώστε να υποστηρίζει αυτό το πρωτόκολλο. Ο παράγοντας Foundry δεν έχει ενεργοποιημένο το τελικό σημείο του Πρωτοκόλλου δραστηριότητας. Ανατρέξτε στην ενότητα Προϋποθέσεις σε αυτό το άρθρο και, στη συνέχεια, ενεργοποιήστε το τελικό σημείο δραστηριότητας ακολουθώντας την επιλογή Ρύθμιση παραμέτρων και κοινή χρήση του copilot σας στην τεκμηρίωση του Microsoft Foundry.

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

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