नोट
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप साइन इन करने या निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
इस पेज तक पहुँच के लिए प्रमाणन की आवश्यकता होती है. आप निर्देशिकाओं को बदलने का प्रयास कर सकते हैं.
वर्तमान में सक्रिय Microsoft 365 Copilot agent, या अपरिभाषित देता है, यदि एजेंट स्थिति अभी तक ज्ञात नहीं है।
सिंटैक्स
Xrm.Copilot.getCurrentAgent().then(successCallback, errorCallback);
पैरामीटर
| पैरामीटर का नाम | प्रकार | आवश्यक | विवरण |
|---|---|---|---|
successCallback |
फलन | हां | ऑपरेशन सफल होने पर कॉल करने के लिए एक फ़ंक्शन। |
errorCallback |
फलन | हां | ऑपरेशन विफल होने पर कॉल करने के लिए एक फ़ंक्शन। |
लौटाया जाने वाला मान
प्रकार: Promise<M365CopilotAgent | undefined> — सक्रिय एजेंट का वर्णन करने वाले M365CopilotAgent ऑब्जेक्ट को हल करता है, या यदि undefined एजेंट स्थिति अभी तक निर्धारित नहीं है।
टिप्पणी
यदि Microsoft 365 Copilot सक्षम नहीं है तो कुछ भी नहीं करता है।
लौटाई गई ऑब्जेक्ट agentId और mode गुण युग्मित हैं:
-
agentIdएक गैर-शून्य स्ट्रिंग है औरmodeहै"agentPage"या :"mentioned"एक एजेंट सक्रिय है। -
agentIdnullहै औरmodenullहै: उपयोगकर्ता मेनलाइन 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 (क्लाइंट एपीआई संदर्भ)