getCurrentAgent (odkaz na rozhranie API klienta)

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

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 Copilot nie je povolená.

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

• agentId Je reťazec, ktorý nemá hodnotu null a mode je "agentPage" alebo "mentioned": agent je aktívny.
• agentIdje null a mode je null: používateľ je v hlavnom Microsoft Copilot (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)