getCurrentAgent (Клиент API сілтемесі)

Қазіргі уақытта белсенді Microsoft 365 Copilot agent қайтарады, немесе агент күйі әлі белгісіз болса, анықталмаған.

Синтаксис

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

Параметрлер

Параметр атауы Түр Қажетті Сипаттама
successCallback Функция Иә Операция табысқа жеткенде қоңырау шалуға арналған функция.
errorCallback Функция Иә Операция істен шыққанда қоңырау шалу функциясы.

Қайтару мәні

Типі: Promise<M365CopilotAgent | undefined> — Белсенді агентті сипаттайтын M365CopilotAgent объектісіне немесе undefined агент күйі әлі анықталмаған жағдайға шешіледі.

Ескертпелер

Егер Microsoft 365 Copilot қосылмаған болса, ештеңе істемейді.

Қайтарылатын объектілер agentId мен mode қасиеттері жұптасқан:

  • agentId нөлдік емес жол және mode немесе "agentPage""mentioned": агент белсенді.
  • agentId — null және mode — null: пайдаланушы негізгі желіде Microsoft 365 Copilot (агент белсенді емес).

Мысал

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

M365CopilotAgent интерфейсі
Xrm.Copilot (Клиент API анықтамасы)

  • Last updated on