getCurrentAgent (referenca klijentskog API-ja)

Vraća trenutno aktivnu verziju sustava Microsoft 365 agent usluge Copilot ili nedefiniranu ako stanje agenta još nije poznato.

Sintaksa

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

Parametri

Naziv parametra Vrsta Obavezno Opis
successCallback Funkcija Da Funkcija koja se poziva kada operacija uspije.
errorCallback Funkcija Da Funkcija za pozivanje kada operacija ne uspije.

Vrijednost vraćanja

Vrsta: Promise<M365CopilotAgent | undefined> – rješava problem s objektom M365CopilotAgentundefined koji opisuje aktivnog agenta ili još nije određeno stanje agenta.

Napomene

Ne čini ništa Microsoft 365 Copilot nije omogućen.

Vraćeni su objekt i agentId svojstva mode upareni:

  • agentId je niz koji nije null i mode je ili "agentPage""mentioned": agent je aktivan.
  • agentId je null, a modenull: korisnik je na glavnoj Microsoft 365 Copilot (nijedan agent nije aktivan).

Primjer

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

M365CopilotAgent interface
Xrm.Copilot (referenca klijentskog API-ja)