getCurrentAgent (referință API client)

Returnează agent Copilot Microsoft 365 activ sau nedefinit dacă starea agentului nu este cunoscută încă.

Sintaxă

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

Parametri

Nume parametru Tip Obligatoriu Descriere
successCallback Funcție Da O funcție de apelat atunci când operațiunea reușește.
errorCallback Funcție Da O funcție de apelat atunci când operațiunea eșuează.

Valoare retur

Tip: Promise<M365CopilotAgent | undefined> — Rezolvă la un obiect M365CopilotAgent care descrie agentul activ sau undefined dacă starea agentului nu este determinată încă.

Observații

Nu face nimic dacă Microsoft 365 Copilot nu este activat.

Proprietățile și mode obiectele returnate agentId sunt asociate:

  • agentId este un șir non-nul și mode este "agentPage" sau "mentioned": un agent este activ.
  • agentId este null și mode este null: utilizatorul se află în Microsoft 365 Copilot principală (niciun agent activ).

Exemplu

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

Interfața M365CopilotAgent
Xrm.Copilot (referință API client)

  • Last updated on