Usa Tarjetas adaptables en Copilot Studio

Note

Este artículo describe características utilizadas en agentes o flujos de agentes alimentados por el arnés estándar.

Tarjetas adaptables describen el contenido de la interfaz de usuario en JSON. Una aplicación anfitriona, como Microsoft Teams, renderiza la tarjeta en su propia interfaz. Usa tarjetas en agentes para recopilar la información de los usuarios o mostrar información.

La aplicación anfitriona determina qué versiones y funciones de tarjeta son compatibles. Elige una versión de esquema que funcione en todos los canales donde publiques tu agente.

Note

Copilot Studio admite las versiones 1.6 y anteriores del esquema de Tarjetas adaptables. Sin embargo, la versión de esquema adecuada depende de la aplicación host de destino:

  • Bot Framework Chat en web componente (es decir, el patrón de integración de sitios web predeterminado) admite la versión 1.6, pero no admite Action.Execute
  • El widget de chat en directo (que se usa para Omnichannel para el servicio al cliente) está limitado a la versión 1.5.
  • Teams también está limitado a la versión 1.5

Además, Copilot Studio solo renderiza tarjetas version-1.6 en el chat de prueba, no en el lienzo.

Más información en AdaptiveCard.

Elige el nodo que se adapte a tu tarea:

Tip

Crea tarjetas con el diseñador integrado descrito en Haz preguntas con Tarjetas adaptables, o reutiliza una tarjeta de otro tema y adáptala a tu tarea.

Descubre más sobre el esquema y los ejemplos en Tarjetas adaptables.

Procedimientos recomendados para tarjetas interactivas

Cuando utilices tarjetas Tarjetas adaptables interactivas (tarjetas con botones Submit), incluye datos que identifiquen la tarjeta o la acción en cada acción de envío. Valida dichos datos al procesar la respuesta, especialmente cuando las tarjetas anteriores siguen siendo visibles. Un identificador de acción fija distingue acciones; por sí solo no impide envíos duplicados ni identifica cada instancia renderizada de una tarjeta.

Obtenga más información en Comportamiento del botón de envío para agentes con tarjetas consecutivas.