Χρήση της προσαρμοσμένης ενέργειας ταξινόμησης ηλεκτρονικού ταχυδρομείου

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

Η ενέργεια ενημερώνει τα πεδία Κατηγορία ηλεκτρονικού ταχυδρομείου (AI) και Κατάσταση ταξινόμησης στην καρτέλα ηλεκτρονικού ταχυδρομείου.

Σημαντικό

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

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

Η ταξινόμηση ηλεκτρονικού ταχυδρομείου είναι διαθέσιμη και ενεργοποιημένη στο Dynamics 365 Customer Service.
Έχουν ρυθμιστεί τουλάχιστον δύο ενεργές κατηγορίες email.
Η χρέωση πληρωμής ανάλογα με τη χρήση είναι ενεργοποιημένη για το περιβάλλον.
Τα απαιτούμενα δικαιώματα Copilot, παράγοντα AI και διαγεωγραφικής περιοχής είναι ενεργοποιημένα.
Η καρτέλα ηλεκτρονικού ταχυδρομείου υπάρχει στο Dataverse.
Ο χρήστης που καλεί την ενέργεια έχει δικαιώματα ανάγνωσης και ενημέρωσης της καρτέλας ηλεκτρονικού ταχυδρομείου και ανάγνωσης της ρύθμισης παραμέτρων ταξινόμησης ηλεκτρονικού ταχυδρομείου.

Λεπτομέρειες αίτησης

Property	Τιμή
Μοναδικό όνομα	`msdyn_EmailClassificationCustomAction`
Σύνδεση	Παγκόσμια ή χωρίς περιορισμούς
Μέθοδος	`POST`
Διεύθυνση URL API Ιστού	`https://<organization-url>/api/data/v9.2/msdyn_EmailClassificationCustomAction`
Λειτουργία Power Automate	Microsoft Dataverse - Εκτέλεση μη δεσμευμένης ενέργειας

Παράμετροι αίτησης

Παράμετρος	Type	Υποχρεωτικό	Περιγραφή
`emailId`	String	Ναι	GUID μιας υπάρχουσας καρτέλας ηλεκτρονικού ταχυδρομείου Dataverse. Μεταβιβάστε το αναγνωριστικό γραμμής ως κείμενο χωρίς άγκιστρα.
`doRuleEvaluation`	Boolean	Ναι	Καθορίζει εάν αξιολογούνται οι ρυθμισμένες συνθήκες ταξινόμησης ηλεκτρονικού ταχυδρομείου. Χρησιμοποιείται `true` για την εφαρμογή των συνθηκών που έχουν διαμορφωθεί από το διαχειριστή. Χρησιμοποιήστε μόνο `false` όταν η ροή κλήσης ελέγχει εάν το μήνυμα ηλεκτρονικού ταχυδρομείου πληροί τις απαιτούμενες συνθήκες πριν καλέσει την ενέργεια.
`isSimulationMode`	Boolean	Όχι	Ενεργοποιεί τη συμπεριφορά προσομοίωσης για συγκεκριμένη υλοποίηση. Χρήση `false` για ταξινόμηση παραγωγής.
`additionalInfo`	String	Όχι	Περιέχει ένα θέμα και ένα σώμα με κωδικοποίηση JSON για προσομοίωση μόνο περιεχομένου. Αφήστε αυτή την τιμή κενή για ταξινόμηση παραγωγής.

Για ταξινόμηση παραγωγής, μεταβιβάστε το αναγνωριστικό γραμμής email, ορίστε doRuleEvaluation σε true, ορίστε σε false, και isSimulationMode αφήστε additionalInfo το κενό.

Ιδιότητες απόκρισης

Property	Type	Περιγραφή
`emailclassificationResponse`	String	Αποτέλεσμα ταξινόμησης με κωδικοποίηση JSON που περιέχει την κατηγορία, τον λόγο και τις προαιρετικές λεπτομέρειες ιεραρχίας.
`matchedCategoryId`	String	GUID της αντίστοιχης σειράς `msdyn_emailclassificationcategory` . Χρησιμοποιήστε αυτήν την τιμή για ντετερμινιστική διακλάδωση και αναζητήσεις Dataverse.
`status`	String	Αντικείμενο με κωδικοποίηση JSON που περιέχει κώδικα και μήνυμα σε επίπεδο εφαρμογής.

Και τα δύο status και emailclassificationResponse περιέχουν JSON αποθηκευμένα ως συμβολοσειρές, όχι εγγενή αντικείμενα JSON. Ορισμένες προαπαιτούμενες, παραλειπόμενες διαδρομές και διαδρομές εξαίρεσης μπορούν να επιστρέψουν κενές συμβολοσειρές. Βεβαιωθείτε ότι κάθε τιμή δεν είναι κενή πριν την αναλύσετε με την παράσταση Power Automatejson().

Κλήση της ενέργειας από το Power Automate

Προσθέστε ένα έναυσμα Dataverse ή χρησιμοποιήστε ένα προηγούμενο βήμα ροής που παρέχει το αναγνωριστικό μιας υπάρχουσας καρτέλας ηλεκτρονικού ταχυδρομείου.
Προσθέστε το βήμα Microsoft Dataverse Εκτέλεση μη δεσμευμένης ενέργειας.
Για το Όνομα ενέργειας, επιλέξτε msdyn_EmailClassificationCustomAction.
Αντιστοίχιση emailId με το αναγνωριστικό γραμμής email, συνήθως activityid.
Ορίστε doRuleEvaluation σε true, εκτός εάν η ροή εφαρμόζει ισοδύναμο φιλτράρισμα καταλληλότητας.
Ορίστε isSimulationMode σε falseκαι αφήστε additionalInfo το κενό.
Επιβεβαιώστε ότι status δεν είναι κενό και, στη συνέχεια, αναλύστε το ως JSON.
Συνεχίστε μόνο όταν status.code είναι 200 και matchedCategoryId δεν είναι άδειο.
Χρησιμοποιήστε το matchedCategoryId για δρομολόγηση βάσει κατηγορίας ή άλλο αυτοματισμό.

Για να αναλύσετε την κατάσταση, χρησιμοποιήστε την ακόλουθη έκφραση. Αντικαταστήστε Perform_an_unbound_action εάν η ενέργειά σας έχει διαφορετικό όνομα.

json(body('Perform_an_unbound_action')?['status'])

Για να αναλύσετε το αποτέλεσμα ταξινόμησης, χρησιμοποιήστε την ακόλουθη έκφραση:

json(body('Perform_an_unbound_action')?['emailclassificationResponse'])

Σημαντικό

Η ενέργεια ενημερώνει τη σειρά email. Εάν η ροή ενεργοποιείται όταν αλλάζει αυτή η γραμμή, φιλτράρετε τις στήλες εναύσματος ή επιλέξτε Κατάσταση ταξινόμησης πριν καλέσετε την ενέργεια. Διαφορετικά, η ενέργεια μπορεί να ενεργοποιήσει ξανά την ίδια ροή.

Παράδειγμα αιτήματος

POST https://<organization-url>/api/data/v9.2/msdyn_EmailClassificationCustomAction
Accept: application/json
Content-Type: application/json; charset=utf-8
OData-MaxVersion: 4.0
OData-Version: 4.0

{
  "emailId": "<email-guid>",
  "doRuleEvaluation": true,
  "isSimulationMode": false
}

Παράδειγμα επιτυχούς απόκρισης

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.context": "https://<organization-url>/api/data/v9.2/$metadata#Microsoft.Dynamics.CRM.msdyn_EmailClassificationCustomActionResponse",
  "emailclassificationResponse": "{\"index\":1,\"category\":\"Marketing\",\"reason\":\"The email promotes a product or service.\",\"status\":null}",
  "matchedCategoryId": "<category-guid>",
  "status": "{\"code\":200,\"message\":\"Success\"}"
}

Πεδία απόκρισης ταξινόμησης

Η ανάλυση emailclassificationResponse μπορεί να περιέχει τα ακόλουθα πεδία.

Πεδίο	Περιγραφή	Οδηγίες χρήσης
`index`	Μηδενική θέση της επιλεγμένης κατηγορίας στο αίτημα AI.	Μην χρησιμοποιείτε αυτήν την τιμή ως ανθεκτικό αναγνωριστικό.
`category`	Όνομα της επιλεγμένης κατηγορίας.	Χρησιμοποιήστε το για προβολή. Τα ονόματα των κατηγοριών μπορούν να επεξεργαστούν.
`reason`	Εξήγηση που δημιουργείται από AI για την επιλογή.	Χρησιμοποιείται για εμφάνιση ή διαγνωστικά, όχι ντετερμινιστική διακλάδωση.
`selectedPath`	Προαιρετική διαδρομή ιεραρχίας όταν είναι ενεργοποιημένη η ιεραρχική ταξινόμηση.	Χρησιμοποιήστε μόνο όταν υπάρχει η τιμή.
`finalCategory`	Προαιρετικός τελικός κόμβος ιεραρχίας που επιλέγεται από την υπηρεσία.	Η ενέργεια χρησιμοποιεί αυτήν την τιμή για την επίλυση της κατηγορίας Dataverse.
`confidence`	Προαιρετικές πληροφορίες εμπιστοσύνης για ιεραρχικά αποτελέσματα.	Μην υποθέτετε ότι αυτή η τιμή είναι πάντα παρούσα.
`evidence`	Προαιρετικά στοιχεία μοντέλου για ιεραρχικά αποτελέσματα.	Μην υποθέτετε ότι αυτή η τιμή είναι πάντα παρούσα.

Τιμές κατάστασης ταξινόμησης

Τιμή	Ετικέτα	Περιγραφή
`0`	Προεπιλεγμένος	Δεν καταγράφεται κανένα ολοκληρωμένο αποτέλεσμα ταξινόμησης.
`1`	Παράβλεψη	Το email δεν ταξινομήθηκε επειδή δεν πληρούνταν μια απαιτούμενη προϋπόθεση.
`2`	Επιτυχία	Μια κατηγορία αντιστοιχίστηκε και γράφτηκε στην εγγραφή email.
`3`	Απέτυχε	Η προσπάθεια ταξινόμησης αντιμετώπισε σφάλμα.

Χειριστείτε τα αποτελέσματα της δράσης

Ένα επιτυχημένο βήμα ενέργειας Power Automate δεν σημαίνει πάντα ότι η ταξινόμηση ήταν επιτυχής. Η ταξινόμηση είναι επιτυχής μόνο όταν:

Το βήμα δράσης πετυχαίνει.
status είναι παρούσα.
Η αναλυμένη status.code τιμή είναι 200.
matchedCategoryId δεν είναι άδειο.

Χρησιμοποιήστε τις ακόλουθες οδηγίες για άλλα αποτελέσματα:

Σενάριο	Αναμενόμενη συμπεριφορά	Συνιστώμενος χειρισμός ροής
Μια συνθήκη καταλληλότητας δεν ταιριάζει.	Οι συμβολοσειρές απόκρισης μπορεί να είναι κενές και η Κατάσταση ταξινόμησης παραλείπεται.	Τερματίστε τη ροή κανονικά ή χρησιμοποιήστε μια μη ταξινομημένη διαδρομή.
Δεν είναι διαθέσιμο το απαιτούμενο δικαίωμα Copilot ή διαγεωγραφικής τοποθεσίας.	Οι συμβολοσειρές απόκρισης μπορεί να είναι κενές και η Κατάσταση ταξινόμησης παραλείπεται.	Καταγράψτε ένα πρόβλημα περιβάλλοντος ή ρύθμισης παραμέτρων.
Έχουν διαμορφωθεί λιγότερες από δύο ενεργές κατηγορίες.	Η λογική κατάσταση μπορεί να είναι κενή και η Κατάσταση ταξινόμησης είναι Απέτυχε.	Ειδοποιήστε έναν διαχειριστή για να διορθώσει τη διαμόρφωση κατηγορίας.
Η υπηρεσία ταξινόμησης επιστρέφει ένα σφάλμα HTTP.	`status` περιέχει τον κωδικό και το μήνυμα HTTP της υπηρεσίας.	Χρησιμοποιήστε πολιτικές ελεγχόμενης επανάληψης και κλιμάκωσης.
Δεν επιστρέφεται καμία κατηγορία.	`status.code` είναι `500`, και το μήνυμα είναι `No category returned.`	Καταγράψτε την αποτυχία και χρησιμοποιήστε μια ασφαλή εναλλακτική.
Δεν λαμβάνεται απάντηση υπηρεσίας.	`status.code` είναι `500`, και το μήνυμα είναι `No response from API.`	Καταγράψτε την αποτυχία και χρησιμοποιήστε μια ασφαλή εναλλακτική.
Το αναγνωριστικό ηλεκτρονικού ταχυδρομείου δεν είναι έγκυρο ή ο καλών χρήστης δεν διαθέτει ένα απαιτούμενο προνόμιο Dataverse.	Το βήμα ροής μπορεί να αποτύχει ή οι λογικές έξοδοι μπορεί να είναι κενές.	Χρησιμοποιήστε τη Ρύθμιση παραμέτρων εκτέλεσης μετά από για να καταγράψετε και να καταγράψετε την αποτυχία.

Σχόλια

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

Τελευταία ενημέρωση στις 2026-08-21