getCurrentAgent (odkaz na rozhranie API klienta)

Vráti aktuálne aktívnu agent Copilota služby Microsoft 365 alebo nedefinovanú, ak ešte nie je známy stav agenta.

Syntax

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

Parametre

Názov parametra	Type	Požaduje sa	Popis
successCallback	Function	Yes	Funkcia, ktorá sa volá po úspešnej operácii.
errorCallback	Function	Yes	Funkcia, ktorá sa volá v prípade zlyhania operácie.

Vrátená hodnota

Typ: Promise<M365CopilotAgent | undefined> — Riešenie pre objekt M365CopilotAgent popisujúci aktívny agent alebo undefined ak ešte nie je určený stav agenta.

Poznámky

Robiť nič, ak Microsoft 365 Copilot nie je povolená.

Vlastnosti a mode vrátené objekty agentId sú spárované:

• agentId Je reťazec, ktorý nemá hodnotu null a mode je "agentPage" alebo "mentioned": agent je aktívny.
• agentId sa null a mode sa null: používateľ sa nachádza v Microsoft 365 Copilot v hlavnej linke (bez agenta aktívny).

Príklad

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

Súvisiace články

Rozhranie M365CopilotAgent
Xrm.Copilot (odkaz na klientske rozhranie API)