Ενσωματώστε προσαρμοσμένους πράκτορες με το Recommended Actions Agent

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

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

Prerequisites

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

  • Μια σταθερή, μοναδική συμβολοσειρά SourceAgentId για τον προσαρμοσμένο παράγοντα. Για περισσότερες πληροφορίες, ανατρέξτε στην ενότητα Προσθήκη προσαρμοσμένων παραγόντων για προτεινόμενες ενέργειες.

  • Απαιτούνται τα ακόλουθα δικαιώματα για την προώθηση των προτεινόμενων ενεργειών:

    Πίνακας Απαιτούμενα δικαιώματα Πεδίο εφαρμογής
    msdyn_rawactioncatalogue Ανάγνωση, εγγραφή, προσάρτηση και προσάρτηση σε Παγκόσμιο
    msdyn_prioritizedactioncatalogue Ανάγνωση, εγγραφή, προσάρτηση και προσάρτηση σε Παγκόσμιο
    msdyn_recommendedactionsourceagentconfig Ανάγνωση Παγκόσμιο
    msdyn_salesagentprofile Ανάγνωση Παγκόσμιο

Αρχιτεκτονική ενοποίησης

Η ενοποίηση του παράγοντα Recommended Actions χρησιμοποιεί μια διοχέτευση επεξεργασίας που απορροφά μη επεξεργασμένες ενέργειες από πράκτορες προέλευσης, τις βαθμολογεί χρησιμοποιώντας μια μηχανή βαθμολόγησης UICE (Urgency, Impact, Confidence, Effort) και εμφανίζει τα αποτελέσματα με προτεραιότητα στο καρουζέλ πωλητή.

Ο αγωγός επεξεργασίας λειτουργεί ως εξής:

  1. Ο προσαρμοσμένος εκπρόσωπος εντοπίζει μια πληροφορία που μπορεί να χρησιμοποιηθεί (για παράδειγμα, έναν κίνδυνο συμφωνίας, μια συμφωνία που έχει σταματήσει ή έναν ενδιαφερόμενο που λείπει).
  2. Ο προσαρμοσμένος παράγοντας καλεί το msdyn_PushActionDataToRecommendedActionAgent προσαρμοσμένο API για να προωθήσει την ενέργεια.
  3. Η ενέργεια αποθηκεύεται στο msdyn_rawactioncatalogue (πίνακας εισόδου).
  4. Για κάθε ενέργεια, η Μηχανή Βαθμολόγησης:
    • Ανακτά σήματα οντότητας από το Dataverse.
    • Λαμβάνει δεδομένα προτεραιότητας συγκεκριμένων παραγόντων από τον κατάλογο ενεργειών.
    • Καλεί το LLM να βαθμολογήσει τη δράση στις διαστάσεις UICE (Επείγον, Αντίκτυπος, Εμπιστοσύνη, Προσπάθεια).
    • Εφαρμόζει κανόνες δαπέδου και οροφής.
    • Υπολογίζει την τελική βαθμολογία προτεραιότητας χρησιμοποιώντας GetRecommendedActionAgentResponseτο .
  5. Η βαθμολογημένη ενέργεια εισάγεται στον msdyn_prioritizedactioncatalogue (πίνακα εξόδου).
  6. Το καρουζέλ Προτεινόμενες ενέργειες ανακτά τις βαθμολογημένες ενέργειες και αποδίδει κάρτες στην προβολή λίστας της οντότητας, υπό την προϋπόθεση ότι το καρουζέλ είναι ενεργοποιημένο για αυτήν την οντότητα.

Βασικά στοιχεία

Η ενοποίηση βασίζεται στους ακόλουθους πίνακες και API Dataverse.

Συνθετικός Θέση Περιγραφή
Πίνακας εισόδου msdyn_rawactioncatalogue (Dataverse) Μη επεξεργασμένες ενέργειες που προωθούν οι προσαρμοσμένοι παράγοντες
Πίνακας εξόδου msdyn_prioritizedactioncatalogue (Dataverse) Βαθμολογημένες και ταξινομημένες ενέργειες για το περιβάλλον εργασίας χρήστη
Ρύθμιση παραμέτρων παράγοντα msdyn_recommendedactionsourceagentconfig (Dataverse) Καταχώρηση και ρύθμιση παραμέτρων ανά πράκτορα
API ειδοποιήσεων προώθησης msdyn_PushActionDataToRecommendedActionAgent (Προσαρμοσμένο API) Πράκτορας → Προτεινόμενες ενέργειες Προώθηση ενέργειας πράκτορα

Εγγραφή αντιπροσώπου

Καταχωρίστε προσαρμοσμένους πράκτορες με τον παράγοντα Recommended Actions, ώστε η πλατφόρμα να αναγνωρίζει και να ανακτά τις ενέργειές τους. Για περισσότερες πληροφορίες σχετικά με την καταχώρηση παραγόντων, ανατρέξτε στην ενότητα Προσθήκη προσαρμοσμένων παραγόντων για προτεινόμενες ενέργειες.

Όταν καταχωρείτε έναν εκπρόσωπο, δημιουργείται μια καταχώρηση στο msdyn_recommendedactionsourceagentconfig. Το μοναδικό SourceAgentId ταυτοποιεί την καταχώρηση του προσαρμοσμένου παράγοντα.

Ρύθμιση παραμέτρων πράκτορα

Ο msdyn_recommendedactionsourceagentconfig πίνακας περιέχει τη ρύθμιση παραμέτρων ανά παράγοντα που διέπει τον τρόπο με τον οποίο ο παράγοντας Προτεινόμενες ενέργειες ερμηνεύει τις ενέργειες ενός εκπροσώπου. Τα δύο πιο σημαντικά πεδία για συμπλήρωση είναι και msdyn_internalprioritizationinstructionmsdyn_syncactionexecutionstateapiconfig.

Μπορείτε να εφαρμόσετε ρύθμιση παραμέτρων είτε ενημερώνοντας με μη αυτόματο τρόπο την καρτέλα πίνακα είτε καλώντας το προσαρμοσμένο API UpsertRecommendationAgentConfigRequest.

Σχήμα UpsertRecommendationAgentConfigRequest

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

{
  "agentName": "YourAgentName",
  "agentType": "CustomAgent",
  "isRecommendedActionAgentEnabled": true,
  "salesAgentProfileId": "<SourceAgentId that was configured>",
  "agentImpactMapping": "[]",
  "internalPrioritizationInstruction": "{\"signals\":[...]}",
  "syncActionExecutionStateApiConfig": "{\"syncactionuistatusapiname\":\"your_SyncBackCustomApiName\"}",
  "description": "Brief description of your agent"
}
Πεδίο JSON Τύπος Περιγραφή
agentName string Χάρτες σε msdyn_agentname (έως 850 χαρακτήρες). Απαιτείται για νέες εγγραφές.
Τύπος παράγοντα string Κατηγορία παράγοντα. Χρησιμοποιήστε το "CustomAgent" για να δημιουργήσετε αυτόματα ένα προφίλ.
isRecommendedActionAgentEnabled δυαδική τιμή Χάρτες για msdyn_isrecommendedactionagentenabled. Null = αφήστε το αμετάβλητο.
salesAgentProfileId Guid? Σύνδεσμοι προς msdyn_salesagentprofile. Χρησιμοποιείται για την αναζήτηση εγγραφής σε upsert.
agentImpactMapping string Επίπεδη σειρά JSON με κύρια ονόματα. Χάρτες σε msdyn_agentimpactmapping.
internalPrioritizationInstruction string JSON με συστοιχία σημάτων. Χάρτες σε msdyn_internalprioritizationinstruction.
syncActionExecutionStateApiConfig string Αντικείμενο {"syncactionuistatusapiname":"..."}JSON . Χάρτες για msdyn_syncactionexecutionstateapiconfig.
πηγήAgentUniqueId string Χάρτες σε msdyn_sourceagentuniqueid.
περιγραφή string Χάρτες σε msdyn_sourcedescription (έως 1000 χαρακτήρες).

Οδηγία εσωτερικής προτεραιότητας

Η εσωτερική οδηγία ιεράρχησης περιέχει μεταδεδομένα σήματος για συγκεκριμένους πράκτορες που λένε στη μηχανή βαθμολόγησης πώς να ερμηνεύσει τα πεδία δεδομένων ιεράρχησης ενός πράκτορα. Είναι ένα αντικείμενο JSON με πίνακα ανώτατου επιπέδου signals . Κάθε σήμα αποσειριοποιείται με AgentSignalInstructionConfig τα ακόλουθα πεδία:

Πεδίο Τύπος Περιγραφή
όνομα string Αναγνωριστικό σήματος — χρησιμοποιείται ως κλειδί στην ενότητα Αναφορά σήματος της προτροπής βαθμολόγησης
type string Τύπος δεδομένων: "string", "number", "boolean"
πηγή string Περιγραφική ετικέτα από την οποία προέρχεται το σήμα. Δεν χρησιμοποιείται για δρομολόγηση — fetch_info.fetch_type ελέγχει τον πραγματικό μηχανισμό ανάκτησης. Συνήθως "action_data" για σήματα που ωθούνται από πράκτορες.
επιρροή_διάστασης {διάσταση: δύναμη} Ποιες διαστάσεις UICE επηρεάζει αυτό το σήμα και πόσο έντονα. Κλειδιά: «επείγον», «αντίκτυπος», «εμπιστοσύνη», «προσπάθεια». δυνατά: "δυνατός", "μέτριος", "αδύναμος"
Ερμηνεία string Περιγραφή σε φυσική γλώσσα του τι σημαίνει το σήμα για τη βαθμολόγηση — εισάγεται στην προτροπή LLM
Αξιοπιστία string Πόσο αξιόπιστο είναι αυτό το σήμα: "υψηλό", "μεσαίο", "χαμηλό"
απαιτείται δυαδική τιμή Εάν το σήμα πρέπει να είναι παρόν για βαθμολόγηση
fetch_info αντικείμενο Ελέγχει πού και πώς ανακτάται η τιμή του σήματος κατά τον χρόνο βαθμολόγησης.

Παράδειγμα αποκλεισμού σημάτων:

{
  "signals": [
    {
      "name": "risk_type",
      "type": "string",
      "source": "action_data",
      "dimension_influence": { "urgency": "moderate", "confidence": "weak" },
      "interpretation": "Risk category code assigned by the source agent (e.g. 8 = Missing BANT Info). Used for pre-filter rule matching and prompt context.",
      "reliability": "high",
      "required": false,
      "fetch_info": { "fetch_type": "action_data", "crm_field": "riskType" }
    },
    {
      "name": "risk_label",
      "type": "string",
      "source": "action_data",
      "dimension_influence": { "urgency": "weak", "confidence": "weak" },
      "interpretation": "Human-readable risk name from the source agent (e.g. 'Missing BANT Info', 'Stalled Pipeline'). Useful for prompt context and seller explanation.",
      "reliability": "high",
      "required": false,
      "fetch_info": { "fetch_type": "action_data", "crm_field": "risk" }
    }
  ]
}

Ρύθμιση παραμέτρων API για την κατάσταση εκτέλεσης ενεργειών συγχρονισμού

Η ρύθμιση παραμέτρων API κατάστασης εκτέλεσης ενέργειας συγχρονισμού είναι ένα αντικείμενο JSON που καθορίζει το προσαρμοσμένο όνομα API που καλεί ο παράγοντας Προτεινόμενες ενέργειες όταν ένας πωλητής ενεργεί σε μια κάρτα (για παράδειγμα, την επισημαίνει ως ολοκληρωμένη ή άσχετη). Αυτό το API ορίζει την κατάσταση της ενέργειας στον προσαρμοσμένο παράγοντα προέλευσης.

{
  "syncactionuistatusapiname": "your_SyncBackCustomApiName"
}

Συμβόλαιο ώθησης δράσης

Οι προσαρμοσμένοι πράκτορες ωθούν ενέργειες χρησιμοποιώντας το προσαρμοσμένο API msdyn_PushActionDataToRecommendedActionAgent. Το API καλείται κάθε φορά που ο εκπρόσωπος δημιουργεί ή ενημερώνει μια ενέργεια για μια οντότητα προορισμού.

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

Παράμετρος Τύπος Υποχρεωτικό Περιγραφή
msdyn_ActionId string Ναι Το μοναδικό αναγνωριστικό του πράκτορα για αυτή την ενέργεια. Χρησιμοποιείται για αποδιπλοποίηση και συγχρονισμό κατάστασης. Πρέπει να είναι ντετερμινιστικό (ίδια ενέργεια = ίδιο αναγνωριστικό). Παράδειγμα μορφής: DealRisk_{opportunityId}_{riskType}
msdyn_SourceAgentId string Ναι Αναγνωριστικό πράκτορα. Πρέπει να συμφωνεί με το msdyn_agentname στην καρτέλα ρύθμισης παραμέτρων εκπροσώπου. Παράδειγμα: "DealClosingAgent"
msdyn_TargetEntityId μοναδικό αναγνωριστικό (GUID) Ναι GUID της καρτέλας προορισμού (Ευκαιρία, Υποψήφιος πελάτης) με την οποία σχετίζεται αυτή η ενέργεια
msdyn_TargetEntityTypeName string Ναι Λογικό όνομα της οντότητας προορισμού. Παράδειγμα: "ευκαιρία", "δυνητικός πελάτης"
msdyn_ActionReason string Ναι Λόγος για τον οποίο δημιουργήθηκε η ενέργεια. Χρησιμοποιείται από τη μηχανή βαθμολόγησης για την αντιστοίχιση αρχών.
msdyn_ActionUIPayload string Αρ. Ωφέλιμο φορτίο JSON για απόδοση κάρτας. Εάν παραλειφθεί, ο παράγοντας Προτεινόμενες ενέργειες δεν μπορεί να εμφανίσει την κάρτα.
msdyn_ActionPrioritizationData string Αρ. JSON με δεδομένα ειδικά για πράκτορες για βαθμολόγηση
msdyn_ActionCTA string Αρ. Συμβολοσειρά τύπου CTA. Παράδειγμα: "Email", "Review", "Call"
msdyn_PrioritizationPrinciples string Αρ. Πίνακας αρχών προτεραιότητας JSON στον οποίο αντιστοιχίζεται αυτή η συγκεκριμένη ενέργεια (μπορεί να παρακάμψει την αντιστοίχιση σε επίπεδο παράγοντα)

Παράδειγμα: Κλήση προσθήκης C#

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

var request = new OrganizationRequest("msdyn_PushActionDataToRecommendedActionAgent")
{
    ["msdyn_ActionId"] = $"DealRisk_{opportunityId}_{riskType}",
    ["msdyn_SourceAgentId"] = "DealClosingAgent",
    ["msdyn_TargetEntityId"] = opportunityId, // Guid
    ["msdyn_TargetEntityTypeName"] = "opportunity",
    ["msdyn_ActionReason"] = "Customer has not responded in 14 days, deal is at risk of stalling",

    ["msdyn_ActionUIPayload"] = JsonConvert.SerializeObject(new
    {
        version = "1.0",
        payload = new
        {
            header = "Follow up with Contoso",
            description = "No customer response in 14 days. Deal may stall without re-engagement.",
            oncardClickActionType = "Navigate",
            oncardClickActionTypeParameters =
                "{etn=\"opportunity\", id=\"aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb\", pagetype=\"entityrecord\"}"
        }
    }),

    ["msdyn_ActionPrioritizationData"] = JsonConvert.SerializeObject(new
    {
        riskType = "14",
        risk = "low"
    })
};

var response = orgService.Execute(request);

bool success = (bool)response["msdyn_IsSuccess"];

Σύμβαση φορτίου δεδομένων για το περιβάλλον εργασίας χρήστη ενεργειών

Το msdyn_ActionUIPayload πεδίο περιέχει ένα φορτίο JSON που ελέγχει τον τρόπο με τον οποίο εμφανίζεται μια κάρτα ενέργειας στο καρουζέλ παράγοντα προτεινόμενων ενεργειών.

{
  "version": 1.0,
  "header": "Follow up with Contoso on pricing proposal",
  "description": "Stakeholder engagement has dropped. The customer expressed interest in the enterprise tier but hasn't responded to the last proposal sent 10 days ago.",
  "oncardClickActionType": "Navigate",
  "oncardClickActionTypeParameters": "{\"etn\":\"opportunity\",\"id\":\"<guid>\",\"pagetype\":\"entityrecord\"}",
  "onctaClickActionType": "Navigate",
  "onctaClickActionTypeParameters": "{\"etn\":\"opportunity\",\"id\":\"<guid>\",\"pagetype\":\"entityrecord\"}"
}

Σύμβαση δεδομένων ιεράρχησης προτεραιοτήτων

Το msdyn_prioritizationdata πεδίο επιτρέπει σε έναν πράκτορα να περάσει σήματα για συγκεκριμένους πράκτορες που επηρεάζουν τον τρόπο με τον οποίο η μηχανή βαθμολόγησης UICE δίνει προτεραιότητα σε μια ενέργεια.

[
  { "signalName": "risk", "value": "low" },
  { "signalName": "riskType", "value": "4" }
]

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

Ενεργοποιήστε το καρουζέλ Προτεινόμενες ενέργειες για να εμφανίζεται στην προβολή λίστας μιας οντότητας. Η aiinsightcard οντότητα ελέγχει την κατάσταση ενεργοποίησης του καρουζέλ για κάθε οντότητα. Βεβαιωθείτε ότι η αντίστοιχη aiinsightcard καρτέλα για την οντότητα έχει οριστεί σε ενεργή.

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

Κατάσταση κάρτας statecode statuscode
Ενεργό 0 1
Inactive 1 2

Εκδόσεις ενεργειών και ακύρωση ενεργειών

Όταν ένας εκπρόσωπος ενημερώνει δεδομένα για μια ενέργεια που προωθήθηκε προηγουμένως, δημιουργεί μια νέα καρτέλα με την ίδια msdyn_ActionId καλώντας msdyn_PushActionDataToRecommendedActionAgent ξανά. Το σύστημα δημιουργεί μια νέα γραμμή στο msdyn_rawactioncatalogue με την ίδια msdyn_actionid αλλά νέα msdyn_rawactioncatalogueid. Ο παράγοντας Recommended Actions συνεχίζει να εμφανίζει την παλιά έκδοση μέχρι να επεξεργαστεί τη νέα.

Για να ακυρώσει μια ενέργεια (για παράδειγμα, όταν επιλύεται ένας κίνδυνος), ο εκπρόσωπος καλεί το msdyn_RAAgent_RemoveActionsV2 προσαρμοσμένο API με το actionId. Αυτή η ενέργεια επισημαίνει όλες τις msdyn_rawactioncatalogue εγγραφές για αυτήν την ενέργεια ως ανενεργές και η κάρτα εξαφανίζεται από το καρουζέλ.

Αμφίδρομος συγχρονισμός κατάστασης

Η κατάσταση της ενέργειας συγχρονίζεται τόσο στο καρουζέλ του παράγοντα "Προτεινόμενες ενέργειες" όσο και στον προσαρμοσμένο παράγοντά σας, ώστε οι πωλητές να βλέπουν συνεπείς πληροφορίες ανεξάρτητα από το πού εκτελούν μια ενέργεια.
Προτεινόμενος πράκτορας ενεργειών → προσαρμοσμένος πράκτορας (ο πωλητής ενεργεί στο καρουζέλ): Όταν ένας πωλητής επισημαίνει μια ενέργεια ως ολοκληρωμένη ή απορριφθείσα στο καρουζέλ:

  1. Ο Παράγοντας προτεινόμενων ενεργειών ενημερώνει το στο msdyn_actionuistatusmsdyn_prioritizedactioncatalogue.
  2. Προτεινόμενες ενέργειες Ο παράγοντας διαβάζει το msdyn_syncactionexecutionstateapiconfig από τη διαμόρφωση του παράγοντα.
  3. Προτεινόμενες ενέργειες Ο παράγοντας καλεί το προσαρμοσμένο API του εκπροσώπου με:
Παράμετρος Τύπος Περιγραφή
actionid GUID Το αναγνωριστικό ενέργειας
κράτος string "Επισημάνθηκε" ή "Απορρίφθηκε"

Ο παράγοντας πρέπει να υλοποιήσει ένα προσαρμοσμένο API που αποδέχεται αυτές τις δύο παραμέτρους και ενημερώνει την κατάσταση ενέργειας στον δικό του χώρο αποθήκευσης δεδομένων.

Προσαρμοσμένος παράγοντας → Προτεινόμενος παράγοντας ενεργειών (ο πωλητής ενεργεί στο περιβάλλον εργασίας χρήστη του εκπροσώπου): Όταν ένας πωλητής ενεργεί σε μια ενέργεια στο περιβάλλον εργασίας χρήστη του εκπροσώπου (για παράδειγμα, την επισημαίνει ως μετριασμένη σε μια προσαρμοσμένη σελίδα εκπροσώπου), ο πράκτορας συγχρονίζει αυτήν την κατάσταση με τον παράγοντα Προτεινόμενες ενέργειες καλώντας msdyn_SyncActionExecutionStateFromAgent. Αυτή η ενέργεια ενημερώνει την κατάσταση στον πίνακα εξόδου του παράγοντα «Προτεινόμενες ενέργειες», ώστε να αποκρύπτεται από το καρουζέλ.

Παράμετρος Τύπος Υποχρεωτικό Περιγραφή
msdyn_ActionId string Ναι Το αναγνωριστικό ενέργειας (ίδιο με αυτό που προωθήθηκε)
msdyn_ActionState ακέραιος Ναι Νέα κατάσταση — τιμές (αντιστοιχισμένες στο MarkAsDone/Dismissed)
msdyn_TargetEntityId μοναδικό αναγνωριστικό Ναι GUID της οντότητας προορισμού
TargetEntityTypeName string Ναι Λογικό όνομα οντότητας προορισμού
msdyn_TrackingId string Αρ. Προαιρετικό αναγνωριστικό παρακολούθησης/συσχέτισης

Δοκιμές και επικύρωση

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

Επαληθεύστε τη διαμόρφωση του πράκτορα:

GET [org-url]/api/data/v9.2/msdyn_recommendedactionsourceagentconfigs
?$filter=msdyn_agentname eq 'YourAgentName'
&$select=msdyn_agentname,msdyn_agentimpactmapping,msdyn_internalprioritizationinstruction,msdyn_syncactionexecutionstateapiconfig

Προωθήστε μια δοκιμαστική ενέργεια καλώντας msdyn_PushActionDataToRecommendedActionAgent και επαληθεύστε ότι είναι αληθής και ότι msdyn_IsSuccess εμφανίζεται μια νέα εγγραφή στο msdyn_rawactioncatalogue.

Ενεργοποιήστε τη βαθμολογία κατ' απαίτηση καλώντας msdyn_RAAgent_TriggerRecommendedActionsAgentOrchestration (αντί να περιμένετε το χρονόμετρο 4 ωρών).

Επαληθεύστε το βαθμολογημένο αποτέλεσμα:

    GET [org-url]/api/data/v9.2/msdyn_prioritizedactioncatalogues
    ?$filter=msdyn_actionid eq 'your-action-id'
    &$select=msdyn_actionid,msdyn_actionscore,msdyn_actionuipayload,msdyn_hascrossedceiling,msdyn_hascrossedfloor,msdyn_actionuistatus,msdyn_scoredetails

Αναμενόμενες τιμές:

  • msdyn_actionscore Η συμπληρώνεται με μια τιμή στην περιοχή 0–10.
  • msdyn_hascrossedfloor είναι ψευδής (η δράση είναι πάνω από το πάτωμα και εμφανίζεται στο καρουζέλ).
  • msdyn_actionuistatus είναι 1 (Ενεργό).
  • msdyn_scoredetails Περιέχει την επεξήγηση που δημιουργείται από το LLM.

Επαληθεύστε την εμφάνιση καρουζέλ ανοίγοντας μια φόρμα ευκαιρίας στο Dynamics 365 Sales και ελέγχοντας την ενότητα Προτεινόμενες ενέργειες. Επαληθεύστε τον συγχρονισμό κατάστασης απορρίπτοντας μια ενέργεια στο καρουζέλ (το API συγχρονισμού θα πρέπει να καλείται με state = "Dismissed") και επισημαίνοντας μια ενέργεια στο περιβάλλον εργασίας χρήστη του παράγοντα (η καρτέλα του πίνακα εξόδου θα πρέπει να αντικατοπτρίζει το ενημερωμένο msdyn_actionuistatus).

Παράδειγμα: Αντιπρόσωπος ευκαιριών πωλήσεων

Το Sales Opportunity Agent είναι ο πρώτος πράκτορας που ενσωματώνεται στο Recommended Actions Agent και η ενσωμάτωσή του χρησιμεύει ως υλοποίηση αναφοράς.

Τιμές ρύθμισης παραμέτρων παράγοντα:

Πεδίο ρύθμισης παραμέτρων Τιμή αντιπροσώπου ευκαιρίας πωλήσεων (από OraDefaults.cs)
msdyn_agentname Πράκτορας Ευκαιριών Πωλήσεων
msdyn_agentimpactmapping ["DealRisk","Ταχύτητα συμφωνίας"]
msdyn_syncactionexecutionstateapiconfig {"syncactionuistatusapiname":"msdyn_SyncDealRiskActionFromNba"}
msdyn_internalprioritizationinstruction Δείτε την αξία παραγωγής του Sales Opportunity Agent

Όταν η έρευνα του Παράγοντα ευκαιριών πωλήσεων ολοκληρώσει και εντοπίσει κινδύνους συμφωνιών, DealRiskToNBAService ωθεί κάθε κίνδυνο ως ξεχωριστή ενέργεια:

Παράμετρος ώθησης Αξία αντιπροσώπου ευκαιριών πωλήσεων
msdyn_ActionId DealRisk_{opportunityId}_{riskType}
msdyn_SourceAgentId "DealRiskAgent"
msdyn_TargetEntityTypeName "ευκαιρία"
msdyn_ActionReason Περιγραφή κινδύνου από έρευνα
msdyn_ActionUIPayload Κάρτα με κεφαλίδα κινδύνου + περιγραφή
msdyn_ActionPrioritizationData {"riskType":"8","risk":"Missing BANT Info"} (παράδειγμα)

Συμπεριφορά συγχρονισμού κατάστασης:

  • Αντιπρόσωπος Ευκαιριών Πωλήσεων → Πράκτορας Προτεινόμενων Ενεργειών: Όταν ένας πωλητής επισημαίνει έναν κίνδυνο ως ολοκληρωμένο στη σελίδα έρευνας, ο πράκτορας καλεί msdyn_SyncActionExecutionStateFromAgent.
  • Συνιστώμενες ενέργειες Πράκτορας → Αντιπρόσωπος Ευκαιριών Πωλήσεων: Όταν ένας πωλητής απορρίπτει μια κάρτα στο καρουζέλ, καλεί ora_UpdatedActionStateFromRAAgent ο παράγοντας Προτεινόμενες ενέργειες (έχει ρυθμιστεί στη ρύθμιση παραμέτρων του παράγοντα).
  • Τελευταία ενημέρωση στις