Αναζήτηση καρτελών οντότητας

Ισχύει για: Dynamics 365 Customer Service και Dynamics 365 Sales

Note

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

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

Τι κάνει

Ο βοηθός αναζητά καρτέλες του Dynamics 365 χρησιμοποιώντας την καλύτερη διαθέσιμη μέθοδο αναζήτησης. Εάν η αναζήτηση συνάφειας είναι ενεργοποιημένη στο περιβάλλον σας, χρησιμοποιείται. Διαφορετικά, ο βοηθός επιστρέφει σε μια αναζήτηση αντιστοίχισης δευτερεύουσας συμβολοσειράς. Τα αποτελέσματα επιστρέφονται με τη σειρά που τα παρέχει το Dynamics 365 — το πρώτο αποτέλεσμα δεν είναι απαραίτητα η πλησιέστερη αντιστοίχιση.

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

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

Δοκιμάστε προτροπές όπως

• Αναζητήστε τα αρχεία CRM για τον αριθμό τηλεφώνου 555-0134.
• Βρείτε την καρτέλα επαφής με τη διεύθυνση jordan@contoso.comηλεκτρονικού ταχυδρομείου.
• Αναζητήστε την Contoso σε όλες τις επαφές και τους λογαριασμούς.
• Ποιος πελάτης έχει τη διεύθυνση billing@fabrikam.comemail;
• Βρείτε εγγραφές που ταιριάζουν με το πρόβλημα του εκτυπωτή.
• Αναζητήστε καρτέλες σχετικά με τη διακοπή δικτύου.

Τι θα δείτε στη συνομιλία

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

Χρήσιμες συμβουλές

• Μπορείτε να κάνετε αναζήτηση σε πολλούς τύπους οντοτήτων ταυτόχρονα, για παράδειγμα "αναζήτηση επαφών και λογαριασμών για την Contoso". Αυτή είναι η καλύτερη επιλογή όταν ένας αριθμός τηλεφώνου ή μια διεύθυνση ηλεκτρονικού ταχυδρομείου μπορεί να ανήκει σε οποιοδήποτε από τα δύο.
• Οι αριθμοί τηλεφώνου αντιστοιχίζονται ευέλικτα όταν η αναζήτηση συνάφειας είναι ενεργοποιημένη στο περιβάλλον σας — μπορείτε να πληκτρολογήσετε 5550134 ακόμα κι αν η εγγραφή αποθηκεύει (555)-0134. Χωρίς αναζήτηση συνάφειας, πληκτρολογήστε τον αριθμό καθώς είναι αποθηκευμένος.
• Για την καταχώριση λογαριασμών κατά κατάσταση ή κάτοχο, χρησιμοποιήστε τον όρο "λογαριασμοί λίστας". Η αναζήτηση είναι καλύτερη όταν δεν γνωρίζετε ήδη ποια εγγραφή θέλετε.
• Για να ανοίξετε μια καρτέλα που μπορείτε ήδη να ονομάσετε, πείτε "άνοιγμα του λογαριασμού Contoso".
• Για αναζητήσεις για συγκεκριμένες περιπτώσεις, πείτε "περιπτώσεις αναζήτησης" για μια πιο στοχευμένη εμπειρία.
• Το κείμενο αναζήτησης περιορίζεται στους 500 χαρακτήρες.
• Ο βοηθός σάς λέει εάν χρησιμοποίησε αναζήτηση συνάφειας ή αντιστοίχιση υποσυμβολοσειρών.

Συμβουλή

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

Τι συμβαίνει στη συνέχεια

Αφού εμφανιστούν τα αποτελέσματα αναζήτησης, μπορείτε να συνεχίσετε με μηνύματα όπως:

• Ανοίξτε το πρώτο αποτέλεσμα.
• Εμφάνιση λεπτομερειών για αυτήν την εγγραφή.
• Συνοψίστε αυτήν την αφήγηση.
• Αναζητήστε ξανά με διαφορετικές λέξεις-κλειδιά.

Αλλάζει αυτό τα δεδομένα;

Όχι, η αναζήτηση δεν αλλάζει τα δεδομένα.

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

Prerequisites

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

Σύνοψη εργαλείου

Ιδιοκτησία	Τιμή
Όνομα χρήστη	Αναζήτηση καρτελών οντότητας
Όνομα εσωτερικού εργαλείου	search_entities
Σκοπός	Πραγματοποιεί αναζήτηση σε καρτέλες Dataverse κατά λέξη-κλειδί, αριθμό τηλεφώνου ή διεύθυνση ηλεκτρονικού ταχυδρομείου χρησιμοποιώντας την καλύτερη διαθέσιμη μέθοδο αναζήτησης (αναζήτηση συνάφειας όταν είναι ενεργοποιημένη ή εναλλακτική αντιστοίχιση δευτερεύουσας συμβολοσειράς OData)

Συμπεριφορά εργαλείου

Αναζητά καρτέλες Dataverse κατά λέξη-κλειδί, αριθμό τηλεφώνου ή διεύθυνση ηλεκτρονικού ταχυδρομείου χρησιμοποιώντας την καλύτερη διαθέσιμη μέθοδο αναζήτησης (αναζήτηση συνάφειας όταν είναι ενεργοποιημένη ή εναλλακτική αντιστοίχιση δευτερεύουσας συμβολοσειράς OData). Υποστηρίζει οποιονδήποτε τύπο οντότητας και πολλούς τύπους σε μία κλήση. Οι στήλες τηλεφώνου και ηλεκτρονικού ταχυδρομείου αποκρύπτονται από τα αποτελέσματα για κάθε τύπο οντότητας. Όπου το κύριο όνομα μιας καρτέλας είναι το ίδιο μια τέτοια τιμή, αυτό το όνομα μπορεί να εξακολουθεί να αναφέρεται ως το όνομα της καρτέλας. Τα αποτελέσματα επαφών και λογαριασμών εμπλουτίζονται με μια επιμελημένη λεπτομέρεια που ορίζεται μέσω μιας δεύτερης αναζήτησης με την καλύτερη δυνατή προσπάθεια — όταν αυτή η αναζήτηση αποτύχει, το αποτέλεσμα αναζήτησης επιστρέφεται χωρίς εμπλουτισμό και όχι αποτυχία. Άλλοι τύποι οντοτήτων δεν λαμβάνουν κανένα επιμελημένο σύνολο και ενδέχεται να φέρουν τα υπόλοιπα πεδία που παρέχονται από το επιλεγμένο παρασκήνιο. Αυτό είναι ένα εργαλείο μόνο κειμένου χωρίς γραφικό στοιχείο εφαρμογής σε συνομιλία.

Σχολιασμούς

Σχόλια	Τιμή	Έννοια
readOnlyHint	true	Αυτό το εργαλείο δεν τροποποιεί δεδομένα.
destructiveHint	Δεν έχει οριστεί	Άνευ αντικειμένου (εργαλείο μόνο για ανάγνωση).
idempotentHint	Δεν έχει οριστεί	Άνευ αντικειμένου (εργαλείο μόνο για ανάγνωση).
openWorldHint	Δεν έχει οριστεί	Χρησιμοποιεί προεπιλογή (ερωτήματα Dataverse).

Έννοιες εισόδου

Πεδίο εφαρμογής οντότητας (μεμονωμένη)

Δεδομένα εισόδου	Περιγραφή	Απαιτείται
entityLogicalName	entityLogicalName (συμβολοσειρά, προαιρετική). Ένας τύπος μεμονωμένης οντότητας για αναζήτηση. Αγνοείται εάν entityLogicalNames παρέχεται.	Αρ.

Πεδίο εφαρμογής οντότητας (πολλαπλάσια)

Δεδομένα εισόδου	Περιγραφή	Απαιτείται
entityLogicalNames	entityLogicalNames (πίνακας συμβολοσειρών, προαιρετικό). Πολλοί τύποι οντοτήτων για ταυτόχρονη αναζήτηση. Έχει προτεραιότητα έναντι του entityLogicalName.	Αρ.

Αναζήτηση κειμένου

Δεδομένα εισόδου	Περιγραφή	Απαιτείται
searchText	searchText (συμβολοσειρά, απαιτείται, έως 500 χαρακτήρες). Ερώτημα αναζήτησης φυσικής γλώσσας ή λέξεων-κλειδιών.	Ναι

Όριο αποτελεσμάτων

Δεδομένα εισόδου	Περιγραφή	Απαιτείται
top	top (ακέραιος, προαιρετικός). Μέγιστα αποτελέσματα ανά τύπο οντότητας. Προεπιλογή στη ρύθμιση μεγέθους σελίδας οργανισμού.	Αρ.

Απόκριση και συμπεριφορά περιβάλλοντος εργασίας χρήστη

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

Αυτό το εργαλείο MCP υποστηρίζεται από μια εφαρμογή MCP.

Τύπος απόκρισης

Λίστα κειμένου των αντίστοιχων εγγραφών

Η απόκριση περιλαμβάνει αντιστοιχισμένες καρτέλες με το κύριο όνομα, τον τύπο οντότητας και τη βαθμολογία συνάφειας. Υποδεικνύεται το επίπεδο αναζήτησης (συνάφεια ή OData που περιέχει).

Σημειώσεις δρομολόγησης

Χρήση search_entities για:

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

Μην το χρησιμοποιείτε search_entities όταν η προτροπή λέει ρητά:

• Ανοίξτε ή επεξεργαστείτε μια εγγραφή που μπορείτε ήδη να ονομάσετε—δρομολόγηση προς get_contact ή get_account.
• Λίστα εγγραφών με κριτήρια όπως η κατάσταση ή ο κάτοχος—δρομολόγηση προς list_accounts ή list_contacts.
• Αναζήτηση υποθέσεων—διαδρομή προς search_cases (ίδια μηχανή, εμβέλεια στο περιστατικό).
• Συσχέτιση πεδίου αναζήτησης—δρομολόγηση προς search_lookup_records.
• Αφήγηση χρονοδιαγράμματος που δημιουργείται από AI—διαδρομή προς summarize_entity_timeline ή get_case_highlights.

Σχετικά εργαλεία

Εργαλείο	Σχέση
search_cases	Ίδια μηχανή αναζήτησης, με εμβέλεια σε οντότητες υπόθεσης
search_lookup_records	Αναζητά καρτέλες για συσχέτιση πεδίων αναζήτησης
list_accounts	Αποκλειστική λίστα λογαριασμών με φίλτρα
list_contacts	Ειδική λίστα επαφών με φίλτρα
list_entity_records	Γενικό πλέγμα οντοτήτων για περιήγηση σε καρτέλες
get_entity_record	Ανοίγει μία μόνο λεπτομέρεια καρτέλας από τα αποτελέσματα αναζήτησης

Ταξινόμηση μεταλλάξεων δεδομένων

Μόνο για ανάγνωση.

Αυτό το εργαλείο δεν αλλάζει δεδομένα. Εκτελεί ερωτήματα αναζήτησης στο Dataverse.