Compartir a través de

Agregar respuesta del agente con el diseñador de formularios (versión preliminar)

[Este artículo es documentación preliminar y está sujeto a modificaciones].

Agregue el componente de respuesta del agente a un formulario de aplicación basada en modelo, que puede llamar directamente a un Microsoft Copilot Studio tema y mostrar la respuesta al usuario. Este componente se basa en la API del agente executeEvent y simplifica el uso al no requerir un nuevo componente personalizado. El contexto implícito de la aplicación, la página y el registro están disponibles en Copilot Studio.

Este componente admite las siguientes respuestas de Copilot Studio:

  • Markdown
  • Tarjeta adaptable
  • Image
  • Video

Importante

  • Esta es 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.

Requisitos previos

Requiere la configuración Permitir que los usuarios analicen datos mediante una experiencia de chat impulsada por IA en lienzo habilitada para aplicaciones basadas en modelo. Más información: Configuración del entorno Copilot

Agregar un componente de respuesta de agente a un formulario

  1. Abra el diseñador de formularios para crear o editar un formulario. Más información: Crear un formulario o Editar un formulario

  2. En el diseñador de formularios, seleccione Componente en la barra de comandos.

  3. En el panel Componentes, expanda Inteligencia artificial

  4. Arrastre Respuesta del agente al lienzo del formulario.

    Respuesta del agente en el panel de componentes.

  5. En el cuadro de diálogo Agregar respuesta del agente, escriba el nombre del evento en el tema Copilot Studio en el cuadro de Valor estático. Más información: Buscar el nombre del evento para un tema en Copilot StudioConfigurar el nombre del evento de respuesta del agente

    Nota

    La opción Enlazar a columna de tabla no se admite para este componente.

  6. En la barra de comandos, seleccione Guardar y publicar.

  7. Abra el formulario en una aplicación basada en modelo para probar el componente.

    Nota

    La vista previa del diseñador de formularios muestra el mensaje de advertencia "La respuesta del agente solo está disponible cuando ejecuta la aplicación", ya que la vista previa en vivo aún no es compatible.

Más información: Buscar el nombre del evento para un tema en Copilot Studio

  1. Abra el tema en Copilot Studio y busque el nodo Gatillo.

  2. Compruebe que el tipo de gatillo es Se produce un evento de cliente personalizado o Evento recibido.

  3. Dentro del nodo Gatillo, seleccione Editar.

    Evento de cliente personalizado de disparador Copilot Studio

  4. En el panel propiedades de la actividad On Event, copie el valor del nombre del evento de la cadena de propiedad que se pasará desde el componente de respuesta del agente. Más información: Cambiar el desencadenador de un tema

    Copilot Studio Panel de propiedades En evento de desencadenador.

Acceso al contexto de la aplicación

Cuando el componente de respuesta del agente llama al tema, pasa el Copilot Studio contexto de la aplicación a través de un conjunto de variables. A continuación, se muestran variables de contexto disponibles como Copilot Studio variables globales.

Variables Description
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ID del registro de la tabla en el formulario principal
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Nombre lógico de la tabla en la página principal
Global.PA__Copilot_Model_PageContext.pageContext.pageName Nombre de la página principal
Global.PA__Copilot_Model_PageContext.pageContext.pageType Tipo de página principal
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Nombre único de la aplicación basada en modelos

Accesibilidad

Cuando la Copilot Studio respuesta es una tarjeta adaptable, asegúrese de que se siguen los siguientes procedimientos recomendados para tener una experiencia accesible.

Limitaciones

  • Actualmente no se admiten las propiedades del componente de respuesta del agente:

    • Label
    • Ocultar etiqueta
    • Ocultar en el teléfono
    • Bloquear
    • Solo lectura
    • Ancho del componente
    • Alto del componente
    • Enlazar a columna de tabla

  • El componente de respuesta del agente no admite pasar contexto adicional a Copilot Studio. Cree un componente personalizado mediante la API del agente executeEvent para permitir proporcionar más contexto.

  • El componente de respuesta del agente solo admite una tarjeta adaptable de solo lectura. Cree un componente personalizado mediante la API del agente executeEvent para admitir la lógica del lado cliente.

  • El componente de respuesta del agente no se admite para tabletas o móviles.

Preguntas más frecuentes sobre las API del agente y el componente de respuesta del agente

ExecuteEvent de la API del agente

Información general del diseñador de formularios controlado por modelos
Agregar, configurar, mover o eliminar componentes de un formulario

  • Last updated on