getCurrentAgent (مرجع واجهة برمجة تطبيقات العميل)

إرجاع عامل Copilot Microsoft النشطة حاليا، أو غير معرفة إذا لم تكن حالة العامل معروفة بعد.

إعراب

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

Parameters

اسم المعلمة	النوع	مطلوب	الوصف
successCallback	الدالة	‏‏نعم‬	وظيفة للاتصال عند نجاح العملية.
errorCallback	الدالة	‏‏نعم‬	وظيفة للاتصال عند فشل العملية.

القيمة المرجعة

النوع: Promise<M365CopilotAgent | undefined> — يتم الحل إلى كائن M365CopilotAgent الذي يصف العامل النشط، أو undefined إذا لم يتم تحديد حالة العامل بعد.

الملاحظات

لا تفعل شيئا إذا لم يتم تمكين Microsoft Copilot.

يتم إقران خصائص و agentId للكائن mode الذي تم إرجاعه:

• agentId هي سلسلة غير خالية وهي mode"agentPage" أو "mentioned": عامل نشط.
• agentIdهو null وmode: 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 (مرجع واجهة برمجة تطبيقات العميل)