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

Retorna l'estat actualment actiu de Microsoft 365 Copilot agent, o indefinit 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 fa res si Microsoft 365 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 és null: l'usuari està a la línia principal Microsoft 365 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)