getCurrentAgent (Informazioni di riferimento sulle API client)

Restituisce il agente Copilot di Microsoft 365 attualmente attivo o non definito se lo stato dell'agente non è ancora noto.

Syntax

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

Parametri

Nome del parametro	TIPO	Obbligatorio	Description
successCallback	Function	Yes	Funzione da chiamare quando l'operazione ha esito positivo.
errorCallback	Function	Yes	Funzione da chiamare quando l'operazione ha esito negativo.

Valore restituito

Tipo: : Promise<M365CopilotAgent | undefined> si risolve in un oggetto M365CopilotAgent che descrive l'agente attivo o undefined se lo stato dell'agente non è ancora determinato.

Remarks

Non esegue alcuna operazione se Microsoft 365 Copilot non è abilitato.

Le proprietà e mode dell'oggetto agentId restituito sono abbinate:

• agentId è una stringa non Null e mode è "agentPage" o "mentioned": un agente è attivo.
• agentId è null e mode è null: l'utente è in Microsoft 365 Copilot mainline (nessun agente attivo).

Example

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

Articoli correlati

Interfaccia M365CopilotAgent
Xrm.Copilot (Informazioni di riferimento sulle API client)