getCurrentAgent (Tài liệu tham khảo về API máy khách)

Trả về trạng thái hiện đang hoạt động của Microsoft 365 Trợ lý ảo Copilot, hoặc không xác định nếu trạng thái tác nhân chưa được biết.

Cú pháp

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

Tham số

Tên tham số	Loại	Bắt buộc	Mô tả
successCallback	Hàm	Có	Một hàm để gọi khi thao tác thành công.
errorCallback	Hàm	Có	Một hàm để gọi khi hoạt động không thành công.

Giá trị trả về

Loại: Promise<M365CopilotAgent | undefined> — Giải quyết đối tượng M365CopilotAgent mô tả tác nhân hiện hoạt hoặc undefined nếu trạng thái tác nhân chưa được xác định.

Nhận xét

Không làm gì nếu Microsoft 365 Copilot không được bật.

Thuộc tính và của đối tượng được agentId trả mode về được ghép nối:

• agentId là một chuỗi không phải là null và mode là "agentPage" hoặc "mentioned": một tác nhân hiện hoạt.
• agentId là null và mode là null: người dùng đang ở trên đường dây chính Microsoft 365 Copilot (không hiện hoạt tác nhân).

Ví dụ:

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.");
}

Bài viết liên quan

Giao diện M365CopilotAgent
Xrm.Copilot (Tài liệu tham khảo về API máy khách)