Συνδέστε έναν παράγοντα που είναι διαθέσιμος μέσω του πρωτοκόλλου Agent2Agent (A2A)

Σημείωμα

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

Το πρωτόκολλο Agent2Agent (A2A) είναι ένα ανοικτό πρότυπο για την επικοινωνία και τη συνεργασία μεταξύ παραγόντων.

Μπορείτε να συνδέσετε τον προσαρμοσμένο πράκτορά σας σε έναν άλλο παράγοντα που υποστηρίζει το πρωτόκολλο A2A. Το Copilot Studio χρησιμοποιεί το πρωτόκολλο A2A για την ενορχήστρωση με αυτόν τον παράγοντα ως απάντηση σε μια αίτηση χρήστη ή ένα έναυσμα.

Τι είναι το πρωτόκολλο Agent2Agent (A2A);

Το πρωτόκολλο Agent-to-Agent (A2A) ορίζει μια τυπική σύμβαση για την επικοινωνία μεταξύ αντιπροσώπων. Επιτρέπει σε έναν ενορχηστρωτή ή πράκτορα να:

Αποστολή εργασιών σε εξωτερικούς παράγοντες.
Παροχή εμπλουτιμένων, δομημένων μετα-δεδομένων.
Λήψη αποκρίσεων παράγοντα σε προβλέψιμη μορφή.

Δείτε πώς το πρωτόκολλο A2A συγκρίνεται με μια παραδοσιακή σύνδεση HTTP για επικοινωνία μεταξύ αντιπροσώπων:

Δυνατότητα	Πρωτόκολλο A2A	Σύνδεση HTTP
Έχει σχεδιαστεί για ροές εργασιών αντιπροσώπων	✓	✗
Υποστηρίζει αλληλεπιδράσεις πολλαπλών φάσεων	✓	✗
Παρέχει εμπλουτισμένα μετα-δεδομένα βάσει περιβάλλοντος	✓	Περιορισμένη
Διαλειτουργικότητα μεταξύ πλαισίων	✓	Ποικίλλει

Χρησιμοποιώντας το A2A, το Copilot Studio μπορεί να αναθέτει εργασίες σε έναν άλλο πράκτορα, όχι μόνο να καλεί API.

Πότε να χρησιμοποιείτε συνδέσεις A2A

Χρησιμοποιήστε μια σύνδεση A2A όταν θέλετε να ενσωματώσετε παράγοντες που υλοποιούν ήδη το πρωτόκολλο Agent-to-Agent. Αυτή η προσέγγιση λειτουργεί καλά για τους παράγοντες που είναι:

Βασίζεται σε εξωτερικά πλαίσια.
Φιλοξενείται εκτός του Copilot Studio.
Εξοπλισμένα με τη δική τους λογική ή ροές εργασιών για συγκεκριμένους τομείς.

Χρησιμοποιήστε εναλλακτικά μοτίβα ενοποίησης, ανάλογα με την περίπτωση:

Ανάγκη ενοποίησης	Προτεινόμενη προσέγγιση
Σύνδεση σε API ή βασικές υπηρεσίες HTTP	Προσαρμοσμένες συνδέσεις / εργαλεία HTTP
Χρήση εργαλείων ή πόρων MCP	Διακομιστές MCP
Ενοποίηση παραγόντων που έχουν δημιουργηθεί με το SDK παραγόντων Microsoft 365	Πρωτόκολλο δραστηριότητας

Μπορείτε να συνδυάσετε πολλά μοντέλα ενοποίησης εντός του ίδιου παράγοντα Copilot Studio.

Σύνδεση του πράκτορά σας σε άλλον πράκτορα μέσω του πρωτοκόλλου A2A

Μεταβείτε στη σελίδα Παράγοντες για τον κύριο παράγοντά σας και επιλέξτε Προσθήκη παράγοντα.
Επιλέξτε Σύνδεση σε έναν εξωτερικό παράγοντα>Agent2Agent.
Εισαγάγετε το URL τερματικού σημείου του παράγοντα A2A. Η διεύθυνση URL τελικού σημείου θα πρέπει να είναι το τελικό σημείο επικοινωνίας με τον παράγοντα και όχι η διεύθυνση URL για την κάρτα παράγοντα.

Μόλις εισαγάγετε τη διεύθυνση URL τελικού σημείου, εάν ο πράκτοράς σας έχει μια έγκυρη κάρτα παράγοντα στην τυπική διεύθυνση URL .well-known, το Copilot Studio αντλεί αυτόματα το όνομα και την περιγραφή για τον πράκτορά σας από την κάρτα και τα συμπληρώνει στη φόρμα για εσάς.

Σημείωμα

Εάν ένα όνομα και μια περιγραφή δεν συμπληρώνονται αυτόματα για τον παράγοντά σας, είναι πιθανό ο παράγοντάς σας να μην έχει κάρτα παράγοντα, η κάρτα βρίσκεται σε διαφορετική διεύθυνση URL από την αναμενόμενη ή υπάρχει πρόβλημα επικοινωνίας με την κάρτα. Πρώτα, ελέγξτε ότι το endpoint του agent είναι σωστό. Εάν ισχύει αυτό, μπορείτε να εισαγάγετε με μη αυτόματο τρόπο ένα κατάλληλο όνομα και περιγραφή για τον παράγοντα SDK. Η περιγραφή θα πρέπει να περιγράφει τον σκοπό του παράγοντά σας, ώστε ο κύριος παράγοντάς σας να μπορεί να κατανοήσει πότε πρέπει να χρησιμοποιηθεί ο δεύτερος παράγοντας. Μάθετε περισσότερα σχετικά με την εγγραφή αποτελεσματικών μετα-δεδομένων. Μπορείτε επίσης να δοκιμάσετε να μεταβείτε στην κάρτα του πράκτορά σας στο πρόγραμμα περιήγησής σας (βρίσκεται στο τερματικό σημείο του πράκτορα + /.well-known/agent.json).
Επιλέξτε την κατάλληλη μέθοδο ελέγχου ταυτότητας, ανάλογα με τον τρόπο ρύθμισης του παράγοντα SDK, από την αναπτυσσόμενη λίστα Έλεγχος ταυτότητας . Οι επιλογές είναι οι εξής:
- Καμία: Ενεργοποιήστε αυτή την επιλογή εάν ο πράκτοράς σας δεν απαιτεί έλεγχο ταυτότητας ή εάν χρησιμοποιείτε το δείγμα παράγοντα που παρέχεται σε αυτήν την τεκμηρίωση, στον οποίο δεν είναι ενεργοποιημένος ο έλεγχος ταυτότητας.
- Κλειδί API: Ενεργοποιήστε αυτή την επιλογή εάν ο πράκτοράς σας απαιτεί ένα κλειδί API για τον έλεγχο ταυτότητας. Πρέπει να καταχωρήσετε το όνομα της κεφαλίδας όπου θα πρέπει να συμπεριληφθεί το κλειδί API ή την παράμετρο ερωτήματος.
- OAuth 2.0: Ενεργοποιήστε αυτή την επιλογή εάν ο πράκτοράς σας χρησιμοποιεί το OAuth 2.0 για τον έλεγχο ταυτότητας. Πρέπει να καταχωρήσετε το αναγνωριστικό προγράμματος-πελάτη, τον μυστικό κωδικό προγράμματος-πελάτη, τη διεύθυνση URL εξουσιοδότησης, τη διεύθυνση URL διακριτικού και τη διεύθυνση URL ανανέωσης.
Εάν επιλέξετε έναν τύπο ελέγχου ταυτότητας διαφορετικό από το Κανένας, πρέπει επίσης να συμπληρώσετε τις άλλες λεπτομέρειες ελέγχου ταυτότητας.
Επιλέξτε Δημιουργία.
Επιλέξτε τη σύνδεση που θέλετε από τη λίστα διαθέσιμων συνδέσεων ή δημιουργήστε μια νέα σύνδεση μεταξύ του παράγοντα A2A και του παράγοντα Copilot Studio σας.
Επιλέξτε Προσθήκη και διαμόρφωση.

Σημείωμα

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

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

Δείγμα σύνδεσης A2A

Σε αυτή τη γρήγορη εκκίνηση, ρυθμίζετε έναν παράγοντα με δυνατότητα A2A και τον συνδέετε σε έναν παράγοντα Copilot Studio. Όταν ολοκληρώσετε τα βήματα,

Εκτελέστε ένα δείγμα παράγοντα με δυνατότητα A2A τοπικά ή χρησιμοποιήστε έναν υπάρχοντα παράγοντα A2A που έχετε ήδη.
Να εκθέτετε τον agent με ασφάλεια μέσω HTTPS χρησιμοποιώντας Dev Tunnels ή άλλη επιλογή φιλοξενίας.
Συνδέστε τον εξωτερικό παράγοντα σε έναν παράγοντα του Copilot Studio μέσω μιας σύνδεσης A2A.
Επαληθεύστε τη σύνδεση ενεργοποιώντας τον παράγοντα από το Copilot Studio με μια εργασία σε φυσική γλώσσα, όπως: "Ποιο φυτό χρειάζεται περισσότερο φως, το φυτό της ντομάτας ή το φυτό της φράουλας;"

Μετά τη ρύθμιση παραμέτρων της σύνδεσης, θα δείτε τα εξής:

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

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

Για να ακολουθήσετε το δείγμα σεναρίου, χρειάζεστε:

Ένας πόρος Azure OpenAI με:
- Διεύθυνση URL τελικού σημείου
- Όνομα διάθεσης
- Κλειδί API
.NET 10 SDK ή νεότερη έκδοση
Ένα περιβάλλον Copilot Studio με δικαιώματα για:
- Επεξεργασία παραγόντων
- Ρύθμιση παραμέτρων συνδέσεων
Μια μέθοδος για την δημόσια έκθεση του τοπικού παράγοντα:
- Διαθέσιμες Σήραγγες (προτείνεται για ανάπτυξη)
- Ή ένα φιλοξενούμενο περιβάλλον όπως το Azure App Service ή το κοντέινερ

Εάν έχετε ήδη έναν παράγοντα με δυνατότητα A2A, μεταβείτε στη Δημιουργία της σύνδεσης A2A στο Copilot Studio.

Βήμα 1: Κλωνοποίηση και ρύθμιση παραμέτρων του δείγματος παράγοντα A2A

Κλωνοποιήστε το αποθετήριο του δείγματος παράγοντα A2A:

git clone https://github.com/microsoft/CopilotStudioSamples.git
cd CopilotStudioSamples/extensibility/a2a/Simple-A2A-Sample

Ορίστε τις απαιτούμενες ρυθμίσεις Azure OpenAI:

AZURE_OPENAI_ENDPOINT: Η διεύθυνση URL τελικού σημείου σας Azure OpenAI
AZURE_OPENAI_DEPLOYMENT_NAME: Το όνομα της ανάπτυξής σας Azure OpenAI
AZURE_OPENAI_API_KEY: Το κλειδί σας API Azure OpenAI

Μπορείτε να ρυθμίσετε αυτές τις παραμέτρους είτε ως μεταβλητές περιβάλλοντος είτε αποθηκεύοντας τις στο appsettings.json ή appsettings.Development.jsonστο .

Επιλογή Α: Ρύθμιση παραμέτρων ως μεταβλητών περιβάλλοντος

$env:AZURE_OPENAI_ENDPOINT="https://YOUR-RESOURCE.openai.azure.com"
$env:AZURE_OPENAI_DEPLOYMENT_NAME="YOUR-DEPLOYMENT"
$env:AZURE_OPENAI_API_KEY="YOUR-KEY"

Επιλογή Β: Ρύθμιση παραμέτρων σε appsettings.json

{  
    "AzureOpenAI": {    
        "Endpoint": "https://YOUR-RESOURCE.openai.azure.com",
        "DeploymentName": "YOUR-DEPLOYMENT",
        "ApiKey": "YOUR-KEY"  
    }
}

Βήμα 2: Δημιουργία, εκτέλεση και έκθεση του πράκτορα

Επαναφορά και δόμηση εξαρτήσεων:

dotnet restore
dotnet build

Εκτελέστε τον πράκτορα:

dotnet run

Η κονσόλα εμφανίζει την τοπική διεύθυνση URL τελικού σημείου A2A.

Έκθεση του τελικού σημείου

Σημείωμα

Για σενάρια παραγωγής, αναπτύξτε τον παράγοντα ως ασφαλή εφαρμογή Web ή υπηρεσία κοντέινερ χρησιμοποιώντας τον κατάλληλο έλεγχο ταυτότητας. Χρησιμοποιήστε Dev Tunnels μόνο για τοπική ανάπτυξη και επιδείξεις.

Εάν χρησιμοποιείτε το Visual Studio Code και σκοπεύετε να εκθέσετε το τελικό σημείο χρησιμοποιώντας διοχετεύσεις ανάπτυξης, εκθέστε μια νέα θύρα διοχέτευσης ανάπτυξης. Επιλέξτε τη θύρα A2A που εμφανίζεται στην κονσόλα. Κάντε δεξί κλικ και δημοσιοποιήστε τη θύρα. διαφορετικά, δεν είναι ορατό στο διαδίκτυο.

Οι διοχέτευσης ανάπτυξης σάς δίνουν μια δημόσια διεύθυνση URL, όπως: https://xyz123-9000.dev.tunnels.ms/. Σημειώστε αυτή τη διεύθυνση URL ως το τελικό σημείο βάσης, ώστε να μπορείτε να τη χρησιμοποιήσετε κατά τη ρύθμιση των παραμέτρων της σύνδεσης A2A στο Copilot Studio.

Βήμα 3: Δημιουργία της σύνδεσης A2A στο Copilot Studio

Αφού ο παράγοντας A2A είναι προσβάσιμος στο κοινό, δημιουργήστε τη σύνδεση A2A εντός του Copilot Studio.

Ανοίξτε το Copilot Studio και επιλέξτε τον κύριο πράκτορά σας.
Επιλέξτε Agents.
Επιλέξτε Προσθήκη παράγοντα και, στη συνέχεια, επιλέξτε Παράγοντας A2A.
Εισαγάγετε τις απαιτούμενες τιμές ρύθμισης παραμέτρων:
- Όνομα: Ένα περιγραφικό όνομα, όπως Βοτανικός Παράγοντας.
- Διεύθυνση URL τελικού σημείου: Χρησιμοποιήστε τη δημόσια διεύθυνση URL διοχέτευσης ανάπτυξης ακολουθούμενη από το τελικό σημείο μηνύματος A2A, για παράδειγμα: https://xyz123-5073.dev.tunnels.ms/a2a/botanical/v1/message:stream
- Έλεγχος ταυτότητας: Επιλέξτε Κανένα εάν χρησιμοποιείτε το δείγμα παράγοντα (δεν έχει επιβληθεί έλεγχος ταυτότητας).
Επιλέξτε Αποθήκευση για να επικυρώσετε και να δημιουργήσετε τη σύνδεση.

Όταν η ρύθμιση παραμέτρων είναι έγκυρη, το Copilot Studio επιβεβαιώνει ότι ο παράγοντας A2A συνδέεται με επιτυχία.

Υπόδειξη

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

Βήμα 4: Αποστολή μιας εργασίας από το Copilot Studio στον παράγοντα A2A

Αφού δημιουργήσετε τη σύνδεση, επαληθεύστε την ενοποίηση στέλνοντας μια εργασία.

Ανοίξτε τον κύριο πράκτορά σας στο Copilot Studio και μεταβείτε στον καμβά Test.
Εισαγάγετε μια προτροπή που θα πρέπει να ανατεθεί στον παράγοντα A2A. Για παράδειγμα: "Ποιο φυτό χρειάζεται περισσότερο φως- ένα φυτό ντομάτας ή ένα φυτό φράουλας;"
Ο ενορχηστρωτής παράγοντα αξιολογεί την εισαγωγή από τον χρήστη και αναθέτει την εργασία στον παράγοντα A2A.
Ο εξωτερικός παράγοντας επεξεργάζεται την αίτηση και επιστρέφει μια απόκριση, η οποία εμφανίζεται στη συνομιλία δοκιμής.

Στα αρχεία καταγραφής του εξωτερικού παράγοντα, βλέπετε τα εξής:

Μια ληφθείσα εργασία A2A.
Το μήνυμα φυσικής γλώσσας.
Η απόκριση που δημιουργήθηκε επέστρεψε στο Copilot Studio.

Βήμα 5: Έλεγχος του ωφέλιμου φορτίου και των μετα-δεδομένων A2A

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

Ένα τυπικό ωφέλιμο φορτίο μηνύματος A2A περιλαμβάνει:

Μια μοναδική contextId
Αναγνωριστικά μηνυμάτων
Πληροφορίες τοπικών ρυθμίσεων
Πλήρες ιστορικό συνομιλίας, όχι μόνο η πιο πρόσφατη έκφραση χρήστη
Τμήματα περιεχομένου μηνύματος (κείμενο, κλήσεις εργαλείων ή άλλα μετα-δεδομένα)

Παράδειγμα αποσπάσματος ωφέλιμου φορτίου:

{
"method": "message/send",
"params": {
 "message": {
   "contextId": "ee1e68ee-75fc-42bb-83d7-25fd26e559c3",
   "metadata": {
     "copilotstudio.microsoft.com/a2a/chathistory": [
       {
         "From": "agent",
         "Locale": "en-US",
         "Text": "Hello, I'm A2A Agent Demo...",
         "Timestamp": "2025-11-26T23:19:28.764Z"
       },
       {
         "From": "user",
         "Locale": "en-US",
         "Text": "Which plant needs more sunlight...",
         "Timestamp": "2025-11-26T23:20:21.484Z"
       }
     ]
   }
 }
}
}

Μπορείτε να χρησιμοποιήσετε αυτά τα μετα-δεδομένα για οποιαδήποτε μεταγενέστερη λογική υλοποιεί ο παράγοντας A2A.

Επόμενα βήματα

Αφού δημιουργήσετε τη βασική σύνδεση A2A, μπορείτε να κάνετε τα εξής:

Προσθέστε νέες δεξιότητες ή γνώσεις τομέα στον παράγοντα A2A.
Χρησιμοποιήστε μετα-δεδομένα από το ωφέλιμο φορτίο A2A για να υλοποιήσετε τη λογική δρομολόγησης και εξατομίκευσης.
Προσθέστε έλεγχο ταυτότητας για να διασφαλίσετε το τελικό σημείο A2A και ενημερώστε αντίστοιχα τις ρυθμίσεις του Copilot Studio.
Συνδέστε άλλα στοιχεία με δυνατότητα A2A χρησιμοποιώντας την ίδια προσέγγιση ρύθμισης παραμέτρων.

Βασικά συμπεράσματα

Το Copilot Studio μπορεί να ενορχηστρώσει εξωτερικούς παράγοντες χρησιμοποιώντας το πρωτόκολλο A2A.
Το A2A ενεργοποιεί ροές εργασιών πολλαπλών παραγόντων με εμπλουτισμένα μετα-δεδομένα περιβάλλοντος.
Το δείγμα πράκτορα επιδεικνύει την πλήρη διαδρομή μετ'επιστροφής: Copilot Studio -> πράκτορας A2A -> Copilot Studio.
Τα μηνύματα A2A περιλαμβάνουν λεπτομερή μετα-δεδομένα που υποστηρίζουν συμπεριφορά παράγοντα με επίγνωση περιβάλλοντος.

Σχόλια

Ήταν χρήσιμη αυτή η σελίδα;

Last updated on 2026-08-03

Συνδέστε έναν παράγοντα που είναι διαθέσιμος μέσω του πρωτοκόλλου Agent2Agent (A2A)

Τι είναι το πρωτόκολλο Agent2Agent (A2A);

Πότε να χρησιμοποιείτε συνδέσεις A2A

Σύνδεση του πράκτορά σας σε άλλον πράκτορα μέσω του πρωτοκόλλου A2A

Δείγμα σύνδεσης A2A

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

Βήμα 1: Κλωνοποίηση και ρύθμιση παραμέτρων του δείγματος παράγοντα A2A

Επιλογή Α: Ρύθμιση παραμέτρων ως μεταβλητών περιβάλλοντος

Επιλογή Β: Ρύθμιση παραμέτρων σε appsettings.json

Βήμα 2: Δημιουργία, εκτέλεση και έκθεση του πράκτορα

Έκθεση του τελικού σημείου

Βήμα 3: Δημιουργία της σύνδεσης A2A στο Copilot Studio

Βήμα 4: Αποστολή μιας εργασίας από το Copilot Studio στον παράγοντα A2A

Βήμα 5: Έλεγχος του ωφέλιμου φορτίου και των μετα-δεδομένων A2A

Επόμενα βήματα

Βασικά συμπεράσματα

Σχετικές πληροφορίες

Σχόλια

Πρόσθετοι πόροι