getCurrentAgent (Bezeroaren API erreferentzia)

Microsoft 365 Copilot agent aktibo dagoena itzultzen du, edo agentearen egoera oraindik ezagutzen ez bada, zehaztu gabe.

Sintaxia

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

Parametroak

Parametroaren izena Mota Beharrezkoa Deskribapenak
successCallback Funtzioa Bai Eragiketa behar bezala egiten denean deitzen zaion funtzioa.
errorCallback Funtzioa Bai Eragiketan akats bat gertatzen denean deitzen zaion funtzioa.

Itzultze-balioa

Mota: Promise<M365CopilotAgent | undefined> — M365CopilotAgent objektu batera konpontzen da, agente aktiboa deskribatzen duena, edo undefined agentearen egoera oraindik zehaztu ez bada.

Oharrak

Ez du ezer egiten Microsoft 365 Copilot gaituta ez badago.

Itzuli diren objektuak agentId eta mode propietateak parekatzen dira:

  • agentId kate ez-nulua da eta mode edo "agentPage""mentioned": agente bat aktiboa da.
  • agentId null eta modenull: erabiltzailea Microsoft 365 Copilot nagusian (ez agenterik aktiborik).

Adibidea

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

M365CopilotAgent interfazea
Xrm.Copilot (Bezeroaren APIaren erreferentzia)

  • Last updated on