Τελικό σημείο ανταλλαγής μηνυμάτων παραγόντων

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

Διαγραφή σημείου αποστολής μηνυμάτων παράγοντα

Χρησιμοποιήστε την εντολή a365 cleanup blueprint --endpoint-only για να διαγράψετε την εγγραφή του σημείου αποστολής μηνυμάτων παράγοντα. Αυτή η εντολή δεν επηρεάζει τον κώδικα του παράγοντα ούτε το αναπτυγμένο τελικό σημείο. Αφαιρεί μόνο την καταχώριση μέσω του Teams Graph (Πλατφόρμα MCP).

a365 cleanup blueprint --endpoint-only

Διαμόρφωση σημείου μηνυμάτων στο a365.config.json

Πριν ορίσετε το messaging endpoint, καθορίστε το στο αρχείο διαμόρφωσης a365.config.json. Αυτό το αρχείο περιέχει την κύρια διαμόρφωση για την ανάπτυξη του παράγοντα σας.

Προσθέστε ή ενημερώστε τις ιδιότητες διαμόρφωσης του messaging endpoint:

{
  "messagingEndpoint": "https://your-endpoint-url.com/api/messages",
  "deploymentProjectPath": "."
}

  • messagingEndpoint: Καθορίστε την ακριβή διεύθυνση URL του endpoint όπου μπορείτε να στέλνετε μηνύματα στον παράγοντα.

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

Ρύθμιση παραμέτρων ιδιοτήτων

Ιδιότητα Περιγραφή Απαραίτητο Προεπιλογή Παράδειγμα
messagingEndpoint Η διεύθυνση URL όπου ο παράγοντας σας λαμβάνει μηνύματα Όχι Κανένας https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Διαδρομή προς τον κατάλογο έργου του παράγοντας για ενημερώσεις διαμόρφωσης Όχι . ./my-agent ή ..

Επιλογές ρύθμισης παραμέτρων τελικού σημείου

Η τιμή του messagingEndpoint εξαρτάται από το σενάριο ανάπτυξης:

Για αναπτύξεις Azure:

  • Εφαρμογή web Azure: https://your-app-name.azurewebsites.net/api/messages

Για αναπτύξεις μη Azure:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Άλλοι πάροχοι cloud: Η προσαρμοσμένη διεύθυνση URL τελικού σημείου

Για τοπικές δοκιμές με Dev Tunnels:

  • Διεύθυνση URL διοχέτευσης προγραμματιστών: https://abc123xyz.devtunnels.ms:3978/api/messages

Σημαντικό

Το deploymentProjectPath προσδιορίζει πού το CLI αναζητά αρχεία έργου και πού ενημερώνει τη ρύθμιση παραμέτρων περιβάλλοντος, όπως αρχεία .env.

Σημείωμα

Όταν χρησιμοποιείτε Dev Tunnels για τοπικές δοκιμές, ενημερώστε το messagingEndpoint στο a365.config.json με το URL του Dev Tunnel πριν εκτελέσετε την εντολή setup. Για περισσότερες πληροφορίες, δείτε testing with Dev Tunnels.

Ορισμός τελικού σημείου ανταλλαγής μηνυμάτων παραγόντων

Αφού ενημερώσετε το a365.config.jsonαρχείο, χρησιμοποιήστε αυτή την εντολή για να καταχωρίσετε το endpoint μηνυμάτων ώστε η υπηρεσία Agent 365 να μπορεί να στέλνει ειδοποιήσεις στον παράγοντα σας. Η λειτουργία --endpoint-only καταχωρεί το τελικό σημείο μέσω του Teams Graph της πλατφόρμας MCP.

a365 setup blueprint --endpoint-only

Μπορείτε επίσης να εισάγετε απευθείας το URL με --messaging-endpoint, αντί να επεξεργαστείτε το a365.config.json:

a365 setup blueprint --endpoint-only `
  --messaging-endpoint https://your-app.azurewebsites.net/api/messages

Κατά την τοπική δοκιμή, μπορείτε να ορίσετε αυτό το endpoint ως Dev Tunnel endpoint πριν αναπτύξετε τον παράγοντα στο cloud. Για περισσότερες πληροφορίες, δείτε testing with Dev Tunnels.

Για να ενημερώσετε μια υπάρχουσα διεύθυνση URL τελικού σημείου:

a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages

Ανάπτυξη τελικού σημείου

Εάν δεν έχετε ήδη αναπτύξει τον παράγοντα σας στο cloud, μάθετε πώς να αναπτύξετε παράγοντα στο Azure.

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

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

  • Last updated on