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

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

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 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.
• agentIdis null and mode isnull: người dùng đang ở trên đường dây chính Microsoft Copilot (không có tác nhân nào hiện hoạt).

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)