getCurrentAgent (sklic na API odjemalca)

Vrne trenutno aktivno microsoft 365 posrednik storitve Copilot ali ni določeno, če stanje agenta še ni znano.

Sintaksa

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

Parametri

Ime parametra	Tip	Zahtevano	Opis
successCallback	Funkcija	Da	Funkcija, ki jo pokličete, ko je operacija uspešna.
errorCallback	Funkcija	Da	Funkcija, ki jo pokličete, ko operacija ne uspe.

Vrnjena vrednost

Vrsta: Promise<M365CopilotAgent | undefined> – razreši v predmet M365CopilotAgent , ki opisuje aktivnega agenta, undefined ali če stanje agenta še ni določeno.

Pripombe

Če možnost Microsoft 365 Copilot ni omogočena, ne naredi ničesar.

Vrnjene lastnosti in lastnosti agentId predmeta mode so seznanjene:

• agentId je niz, ki ni ničeln, mode in je "agentPage" ali "mentioned": agent je aktiven.
• agentId je null in mode je null: uporabnik je na glavnem mestu Microsoft 365 Copilot (agent ni aktiven).

Primer

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

Sorodni članki

Vmesnik M365CopilotAgent
Xrm.Copilot (sklic na API odjemalca)