getCurrentAgent (क्लाइंट एपीआई संदर्भ)

वर्तमान में सक्रिय Microsoft Copilot agent, या अपरिभाषित देता है यदि एजेंट स्थिति अभी तक ज्ञात नहीं है।

सिंटैक्स

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

पैरामीटर

पैरामीटर का नाम प्रकार आवश्यक विवरण
successCallback फलन हां ऑपरेशन सफल होने पर कॉल करने के लिए एक फ़ंक्शन।
errorCallback फलन हां ऑपरेशन विफल होने पर कॉल करने के लिए एक फ़ंक्शन।

लौटाया जाने वाला मान

प्रकार: Promise<M365CopilotAgent | undefined> — सक्रिय एजेंट का वर्णन करने वाले M365CopilotAgent ऑब्जेक्ट को हल करता है, या यदि undefined एजेंट स्थिति अभी तक निर्धारित नहीं है।

टिप्पणी

यदि Microsoft Copilot सक्षम नहीं है तो कुछ भी नहीं करता है।

लौटाई गई ऑब्जेक्ट agentId और mode गुण युग्मित हैं:

  • agentId एक गैर-शून्य स्ट्रिंग है और mode है "agentPage" या : "mentioned"एक एजेंट सक्रिय है।
  • agentIdis और nullmode है : nullउपयोगकर्ता मेनलाइन पर है Microsoft 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 (क्लाइंट एपीआई संदर्भ)