getCurrentAgent (sklic na API odjemalca)

Vrne trenutno aktivno Microsoft 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

Ne naredi ničesar, Microsoft Copilot ta funkcija ni omogočena.

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.
  • agentIdje null in mode jenull: uporabnik je na glavni Microsoft Copilot (ni aktivnega agenta).

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

Vmesnik M365CopilotAgent
Xrm.Copilot (sklic na API odjemalca)