updateContext (Referência da API do cliente) (pré-visualização)

Important

  • Esta é uma funcionalidade de pré-visualização.
  • As funcionalidades de pré-visualização não se destinam a utilização em produção e poderão ter funcionalidade restrita. Estas caraterísticas estão sujeitas aos termos de utilização suplementares e estão disponíveis antes do lançamento oficial para que os clientes possam obter acesso antecipado e fornecer feedback.

(pré-visualização) Envia contexto atualizado da aplicação para o painel lateral do Microsoft 365 Copilot.

Sintaxe

Xrm.Copilot.updateContext(context).then(successCallback, errorCallback);

Parameters

Nome do parâmetro Tipo Obrigatório Description
context PowerAppsContent Yes Um objeto que descreve o contexto atual da aplicação a enviar para o painel lateral do Microsoft 365 Copilot.
successCallback Function Yes Uma função a ser chamada quando a operação for bem-sucedida.
errorCallback Function Yes Uma função para chamar quando a operação falhar.

Valor de retorno

Tipo: Promise<void>

Remarks

A API funde automaticamente os campos de contexto base (appId, appType, orgId, geo, schemaVersion). Não precisa de fornecer estes campos. A API não faz nada se o Microsoft 365 Copilot não estiver ativado. Os agentes que escreveu ainda não conseguem usar o contexto para otimizar as suas respostas.

Example

await Xrm.Copilot.updateContext({
    entity: "account",
    filterXML: "<fetch><entity name='account'><filter><condition attribute='statecode' operator='eq' value='0'/></filter></entity></fetch>"
});

PowerAppsContent
Xrm.Copilot (referência da API do cliente)