getCurrentAgent (referință API client)

Returnează agent Copilot Microsoft 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 Copilot nu este activat.

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

• agentId este un șir non-nul și mode este "agentPage" sau "mentioned": un agent este activ.
• agentIdis null and mode is null: the user is on mainline Microsoft Copilot (no agent active).

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

Articole asociate

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