getCurrentAgent (Informazioni di riferimento sulle API client)

Restituisce il agente Copilot Microsoft 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 Copilot non è abilitato.

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

• agentId è una stringa non Null e mode è "agentPage" o "mentioned": un agente è attivo.
• agentIdè e mode è nullnull : l'utente si trova sul Microsoft 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)