Compartir a través de


executePrompt (referencia de API de cliente) (versión preliminar)

Importante

  • Se trata de una característica en versión preliminar.
  • Las características en vista previa no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están sujetas a condiciones de uso adicionales y están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.

Ejecuta un tema de Microsoft Copilot Studio en función de las consultas desencadenadoras registradas en el tema. Devuelve la matriz de tipo MCSResponse.

Syntax

Xrm.Copilot.executePrompt(promptText).then(successCallback, errorCallback);

Parámetros

Nombre de parámetro Tipo Obligatorio Description
promptText cuerda / cadena Texto que se registra como una consulta de desencadenador en el tema MCS.
successCallback Función Una función para llamar a la operación es correcta.
errorCallback Función Una función a la que se llama cuando la operación tiene error.

Valor devuelto

Una matriz de MCSResponse

Example

En Microsoft Copilot Studio, las consultas como "hello" o "hi" desencadenan un tema. Cuando executePrompt se ejecuta con promptText coincidente, activa el tema y devuelve una actividad Message con el texto de respuesta.

const response = await Xrm.Copilot.executePrompt("hello"); 

Respuesta

Este es un ejemplo de la respuesta que se puede devolver.

[
    {
        "type": "message",
        "timestamp": "2025-02-05T16:46:07.7799759+00:00",
        "replyToId": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
        "attachments": [],
        "textFormat": "markdown",
        "text": "Hello, how can I help you today?",
        "speak": "Hello, <break strength=\"medium\" /> how can I help?"
    }
]

Xrm.Copilot (referencia de la API Cliente)