getCurrentAgent (kliento API nuoroda)

Grąžina šiuo metu aktyvią "Microsoft 365" „Copilot“ agentas arba neapibrėžta, jei agento būsena dar nežinoma.

Sintaksė

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

Parametrai

Parametro pavadinimas	Tipas	Būtina	Aprašas
successCallback	Funkcija	Taip	Funkcija, kurią reikia iškviesti, kai operacija sėkminga.
errorCallback	Funkcija	Taip	Funkcija, kurią reikia iškviesti, kai operacija nepavyksta.

Pateikta reikšmė

Tipas: Promise<M365CopilotAgent | undefined> — išsprendžia M365CopilotAgent objektą, aprašantį aktyvųjį agentą, arba undefined jei agento būsena dar nenustatyta.

Pastabos

Nieko nedaro, jei neįgalintas Microsoft 365 Copilot.

Grąžinto agentId objekto ir mode jo ypatybės susietos:

• agentId yra ne nulinė eilutė ir mode yra "agentPage" arba "mentioned": aktyvus agentas.
• agentId yra null, o mode yra null: vartotojas yra pagrindinėje Microsoft 365 Copilot (agentas neaktyvus).

Pavyzdžiui

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

Susiję straipsniai

M365CopilotAgent sąsaja
Xrm.Copilot (kliento API nuoroda)