executePrompt (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 un array de tipo MCSResponse.

Disponible para

Aplicaciones basadas en modelo

Syntax

context.copilot.executeEvent(promptText).then(successCallback, errorCallback);

Parámetros

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

Valor devuelto

Tipo: Promise<MCSResponse>

Consulte Promise y MCSResponse.

Example

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

const response = await context.copilot.executePrompt("hello");

Respuesta

[
    {
        "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?"
    }
]

Artículos relacionados

Copiloto
executeEvent
Referencia de la API del framework de componentes de Power Apps
Introducción al marco de componentes de Power Apps