getCurrentAgent (การอ้างอิง API ไคลเอ็นต์)

ส่งกลับ เอเจนต์ Copilot Microsoft 365 ที่ใช้งานอยู่ในปัจจุบัน หรือไม่ได้ระบุถ้ายังไม่ทราบสถานะของตัวแทน

ไวยากรณ์

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

พารามิเตอร์

ชื่อพารามิเตอร์	Type	จำเป็นต้องระบุ	คำอธิบาย
successCallback	Function	Yes	ฟังก์ชันที่จะเรียกใช้เมื่อการดําเนินการสําเร็จ
errorCallback	Function	Yes	ฟังก์ชันที่จะเรียกใช้เมื่อการดําเนินการล้มเหลว

ค่าส่งกลับ

ชนิด: Promise<M365CopilotAgent | undefined> — แก้ไขวัตถุ M365CopilotAgent ที่อธิบายตัวแทนที่ใช้งานอยู่ หรือ undefined ถ้ายังไม่กําหนดสถานะตัวแทน

หมาย เหตุ

ไม่ทําอะไรถ้าไม่ได้เปิดใช้งาน Microsoft 365 Copilot

คุณสมบัติและmodeของagentIdวัตถุที่ส่งกลับจะถูกจับคู่:

• agentId เป็นสตริงที่ไม่ใช่ null และ mode เป็น "agentPage" หรือ "mentioned": ตัวแทนทํางานอยู่
• agentId คือ null และ 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 (การอ้างอิง API ไคลเอ็นต์)