getCurrentAgent (Klienta API atsauce)

Atgriež pašreiz aktīvo Microsoft 365 Copilot aģents vai nedefinētu, ja aģenta stāvoklis vēl nav zināms.

Sintakse

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

Parametri

Parametra nosaukums	Tips	Obligāts	Apraksts
successCallback	Funkcija	Jā	Funkcija, kas jāizsauc, kad operācija ir veiksmīga.
errorCallback	Funkcija	Jā	Funkcija, kas jāizsauc, ja operācija neizdodas.

Atgrieztā vērtība

Tips: Promise<M365CopilotAgent | undefined> — tiek atrisināts par objektu M365CopilotAgent , kas apraksta aktīvo aģentu vai undefined ja aģenta stāvoklis vēl nav noteikts.

Piezīmes

Neko nedara, ja Microsoft 365 Copilot nav iespējots.

Atgrieztie objekti un rekvizīti tiek mode savienoti agentId pārī:

• agentIdir virkne, kas nav nulle, un tā "agentPage" ir mode vai "mentioned": aģents ir aktīvs.
• agentId ir null un mode ir null: lietotājs ir galvenajā Microsoft 365 Copilot (nav aktīva aģenta).

Piemērs

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

Saistītie raksti

M365CopilotAgent interfeiss
Xrm.Copilot (klienta API atsauce)