getCurrentAgent (Bezeroaren API erreferentzia)

Microsoft Copilot agent aktiboa 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 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.
• agentIdis null eta mode is null: erabiltzailea Microsoft Copilot nagusian (ez agente 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.");
}

Erlazionatutako artikuluak

M365CopilotAgent interfazea
Xrm.Copilot (Bezeroaren APIaren erreferentzia)