getCurrentAgent (Referència a l'API del client)

Retorna l'estat actual de Microsoft Copilot agent, o no està definit si encara no es coneix l'estat de l'agent.

Sintaxi

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

Paràmetres

Nom del paràmetre	Tipus	Necessari	Descripció
successCallback	Funció	Sí	Una funció per cridar quan l'operació té èxit.
errorCallback	Funció	Sí	Una funció per cridar quan l'operació falla.

Valor retornat

Tipus: Promise<M365CopilotAgent | undefined> — Resol a un objecte M365CopilotAgent que descriu l'agent actiu, o undefined si l'estat de l'agent encara no està determinat.

Observacions

No serveix de res si Microsoft Copilot no està activat.

Els objectes agentId retornats i mode les propietats estan aparellats:

• agentId és una cadena no nul·la i mode és "agentPage" o "mentioned": un agent és actiu.
• agentIdés null i mode ésnull: l'usuari està a la línia principal de Microsoft Copilot (sense agent actiu).

Exemple

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

Articles relacionats

Interfície M365CopilotAgent
Xrm.Copilot (Referència de l'API del client)