getCurrentAgent (Klient-API-referanse)

Returnerer den aktive Microsoft 365-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 365 Copilot ikke er aktivert.

Objektet og egenskapene som mode returneresagentId, er paret:

  • agentId er en streng som ikke er null, og mode er "agentPage" eller "mentioned": en agent er aktiv.
  • agentId er null og mode er null: brukeren er på hovedlinjen Microsoft 365 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)

  • Last updated on