getCurrentAgent (İstemci API başvurusu)

Şu anda etkin olan Microsoft 365 Copilot aracısı veya aracı durumu henüz bilinmiyorsa tanımlanmamış değerini döndürür.

Syntax

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

Parameters

Parametre Adı	Türü	Zorunlu	Description
successCallback	Function	Evet	İşlem başarılı olduğunda çağrılacak bir işlev.
errorCallback	Function	Evet	İşlem başarısız olduğunda çağrılacak bir işlev.

Dönüş Değeri

Tür: Promise<M365CopilotAgent | undefined> — Etkin aracıyı undefined açıklayan veya aracı durumu henüz belirlenmemiş bir M365CopilotAgent nesnesine çözümler.

Remarks

Microsoft 365 Copilot etkinleştirilmediyse hiçbir şey yapmaz.

Döndürülen nesnenin agentId ve mode özellikleri eşleştirilir:

• agentIdnull olmayan bir dizedir "agentPage" ve mode veya "mentioned": bir aracı etkindir.
• agentId null ve modenull: kullanıcı ana hat Microsoft 365 Copilot (etkin aracı yok) üzerindedir.

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

İlgili makaleler

M365CopilotAgent arabirimi
Xrm.Copilot (İstemci API başvurusu)