getCurrentAgent (ügyfél API-referencia)

Az aktuálisan aktív Microsoft 365-Copilot-ügynök vagy nem definiált értéket adja vissza, ha az ügynök állapota még nem ismert.

Syntax

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

Parameters

Paraméter neve	Típus	Required	Description
successCallback	Funkció	Igen	A művelet sikeres végrehajtása esetén meghívandó függvény.
errorCallback	Funkció	Igen	A művelet sikertelensége esetén meghívandó függvény.

Visszaadott érték

Típus: Promise<M365CopilotAgent | undefined> – Feloldja az aktív ügynököt leíró M365CopilotAgent objektumot, vagy undefined ha még nincs meghatározva az ügynök állapota.

Remarks

Nem tesz semmit, ha Microsoft 365 Copilot nincs engedélyezve.

A visszaadott objektum agentId és mode tulajdonságok párosítva vannak:

• agentId egy nem null sztring, és mode az "agentPage" vagy "mentioned": az ügynök aktív.
• agentId null és modenull: a felhasználó a fővonali Microsoft 365 Copilot (nincs aktív ügynök).

Example

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

Kapcsolódó cikkek

M365CopilotAgent interfész
Xrm.Copilot (Ügyfél API-referencia)