getCurrentAgent (αναφορά API προγράμματος-πελάτη)

Επιστρέφει το τρέχον ενεργό Microsoft 365 παράγοντας Copilot ή δεν έχει οριστεί εάν η κατάσταση του παράγοντα δεν είναι ακόμα γνωστή.

Σύνταξη

Xrm.Copilot.getCurrentAgent().then(successCallback, errorCallback);

Παράμετροι

Όνομα παραμέτρου	Type	Υποχρεωτικό	Περιγραφή
successCallback	Function	Yes	Μια συνάρτηση για κλήση όταν η λειτουργία είναι επιτυχής.
errorCallback	Function	Yes	Μια λειτουργία για κλήση όταν αποτύχει η λειτουργία.

Τιμή επιστροφής

Τύπος: Promise<M365CopilotAgent | undefined> — Επιλύει σε ένα αντικείμενο M365CopilotAgent που περιγράφει τον ενεργό παράγοντα ή undefined εάν η κατάσταση του παράγοντα δεν έχει προσδιοριστεί ακόμα.

Remarks

Δεν ενεργοποιείται τίποτα αν το Microsoft 365 Copilot δεν είναι ενεργοποιημένο.

Οι ιδιότητες και του agentId αντικειμένου που mode επιστρέφονται συνδυάζονται:

• agentId Το είναι μια συμβολοσειρά που δεν είναι null και mode είναι "agentPage" ή "mentioned": ένας παράγοντας είναι ενεργός.
• Το agentId είναι null και mode έχει null: ο χρήστης βρίσκεται σε Microsoft 365 Copilot κύριας γραμμής (δεν υπάρχει ενεργός παράγοντας).

Παράδειγμα

const agent = await Xrm.Copilot.getCurrentAgent();
if (agent && agent.agentId) {
    console.log(`Active agent: ${agent.agentId}, mode: ${agent.mode}`);
} else if (agent) {
    console.log("User is on mainline M365 Copilot (no agent).");
} else {
    console.log("Agent state not yet determined.");
}

Σχετικά άρθρα

Διασύνδεση M365CopilotAgent
Xrm.Copilot (αναφορά API προγράμματος-πελάτη)