getCurrentAgent (Klient-API-referanse)

Returnerer den aktive Microsoft-Copilot-agent, eller ikke definert hvis agenttilstanden ennå ikke er kjent.

Syntaks

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

Parametre

Parameternavn Type Påkrevd Beskrivelse
successCallback Function Yes En funksjon som skal kalles når operasjonen er vellykket.
errorCallback Function Yes En funksjon som skal kalles når operasjonen mislykkes.

Returverdi

Type: Promise<M365CopilotAgent | undefined> – Løser til et M365CopilotAgent-objekt som beskriver den aktive agenten, eller undefined hvis agenttilstanden ikke er bestemt ennå.

Merknader

Gjør ingenting hvis Microsoft Copilot ikke er aktivert.

Objektet og egenskapene som agentId returneresmode, er paret:

  • agentId er en streng som ikke er null, og mode er "agentPage" eller "mentioned": en agent er aktiv.
  • agentIder null og mode ernull: brukeren er på hovedlinjen Microsoft Copilot (ingen agent aktiv).

Eksempel

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-grensesnitt
Xrm.Copilot (klient-API-referanse)

  • Sist oppdatert