getCurrentAgent (Klienta API atsauce)

Atgriež pašlaik aktīvo Microsoft Copilot aģents vai nenoteiktu, 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

Tas neko nedara, ja Microsoft Copilot nav ieslēgts.

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

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

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)