Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este artículo se muestra cómo integrar un modelo CLU en un agente.
Nota
Asegúrese de que el entorno del agente está en una región compatible con Copilot Studio con una región CLU equivalente.
No todas las regiones compatibles con Copilot Studio tienen una región CLU equivalente.
Prerrequisitos
- Un modelo CLU totalmente entrenado, incluidas las intenciones para todos los temas del sistema y para cualquier tema personalizado que quiera crear
- La clave y la dirección URL de predicción del modelo implementado
- El nombre del proyecto CLU y el nombre de implementación
- Una clave de cuenta para Cognitive Services
- Una dirección URL del sitio para el lenguaje de Azure AI
- Una cuenta de Copilot Studio
- Un agente de Copilot Studio configurado para usar la orquestación clásica
- Un conector de lenguaje Copilot Studio configurado para usar credenciales proporcionadas por el creador
Prepara tu proyecto de CLU
Si no tiene una suscripción a Azure, cree una cuenta gratuita.
Cree un recurso de lenguaje en Language Studio, con la característica conversational language understanding habilitada.
Para asegurarse de que el agente de Copilot Studio funciona correctamente, el modelo CLU que cree debe tener intenciones para todos los temas del sistema y para todos los temas personalizados que agregue al agente.
Defina las entidades que desea que use el agente de Copilot Studio.
Entrene e implemente el proyecto CLU en la misma región que el agente de Copilot Studio.
Preparación del agente
Vaya a la página Configuración del agente. Aparece la configuración de la categoría Generative AI .
Si la orquestación generativa está activada, cambie a orquestación clásica: en Orquestación, seleccione No.
Seleccione Language Understanding en el panel lateral.
Seleccione Usar NLU de Azure precompilado.
Si el entorno aún no está conectado al lenguaje de Azure AI o si desea usar una nueva conexión, seleccione Administrar conexiones, vaya a Power Apps y cree una conexión CLU.
Seleccione la conexión CLU deseada.
Haga clic en Guardar. Aparece una ventana solicitándole guardar una instantánea de su agente antes de proceder a la eliminación de todas las frases activadoras existentes para sus temas.
Seleccione Guardar instantánea y guarde el archivo ZIP resultante (botContent.zip) en la ubicación deseada. El archivo ZIP contiene un único archivo YAML (botContent.yml) con el contenido del agente, incluidas las frases de desencadenador y los mensajes.
Seleccione Sí, elimine mis frases de desencadenador y, a continuación, seleccione Continuar.
Escriba el nombre y la información de implementación del modelo para el proyecto de lenguaje de Azure AI adecuado y seleccione Guardar. Una vez completada esta operación, puede ver un nuevo tema del sistema denominado Analizar texto. Este tema está conectado al modelo CLU y su propósito es reconocer intenciones y entidades en conversaciones entre los clientes y el agente.
Nota
Al cambiar la configuración de Language Understanding del agente a Microsoft Copilot Studio NLU, se quita el tema del sistema Analizar texto. También requiere que agregue manualmente frases de ejemplo para temas actualmente asignados a intenciones externas.
Mapear intenciones y entidades de CLU
En su agente de Copilot Studio, comience a mapear los temas existentes a las intenciones de CLU. Puede asignar manualmente intenciones y entidades, o realizar asignaciones masivas.
Asignar manualmente intenciones de CLU a temas
Vaya a la página Temas del agente.
Seleccione el tema deseado.
En el nodo Desencadenador , seleccione Editar. Aparece el panel Frases .
En Nombre de intención, escriba el nombre de la intención CLU que desea asignar a este tema. El nombre de la intención aparece en el nodo Desencadenador en Intención externa.
Nota
El nombre de la intención CLU debe escribirse exactamente como se almacena en el modelo CLU, incluido el caso coincidente.
Haga clic en Guardar.
Repita estos pasos para cualquier tema restante que desee asignar a una intención CLU externa.
Asignar entidades manualmente
Vaya a la página Configuración del agente.
Seleccione Entidades.
Seleccione Agregar una entidad>Registrar una entidad externa.
En el panel que se abre, escriba el nombre deseado y una descripción (opcional).
En Tipo de datos, seleccione Desde datos de ejemplo.
Seleccione Obtener esquema de JSON de ejemplo, escriba un fragmento de código JSON para la entidad CLU y seleccione Confirmar. Busque fragmentos de código JSON de ejemplo en Registración de Entidades para la integración de Comprensión del Lenguaje Conversacional.
Seleccione Guardar y cierre el panel.
Repita estos pasos para cualquier entidad restante que desee asignar a una entidad CLU externa.
Realizar la asignación masiva
Vaya a la página Configuración del agente.
Seleccione Comprensión del idioma.
Seleccione Agregar temas y entidades de los datos del modelo. Aparece el asistente Agregar intenciones y entidades.
Seleccione Elegir archivo para seleccionar el archivo con los datos del modelo CLU.
Los datos del modelo aparecen en el panel Vista previa .
Seleccione Siguiente. Aparece la pantalla Mapear temas existentes.
Seleccione la intención CLU deseada para cada tema.
Revise las selecciones y seleccione Siguiente. Aparece la pantalla Crear nuevos temas , en la que se muestran las intenciones que no están asignadas a un tema existente.
Si lo desea, cree un tema para cada una de estas intenciones: en Crear un tema nuevo, escriba un nombre para cada tema que quiera crear.
Nota
El asistente omite cualquier campo que deje en blanco.
Seleccione Siguiente. Aparece la pantalla Registrar entidades , en la que se muestran las entidades CLU del archivo de datos del modelo.
Seleccione el tipo de datos adecuado para las entidades que desea usar y, a continuación, seleccione Siguiente. Aparece la pantalla Revisar .
Revise las asignaciones de la pestaña Temas existentes, Nuevos temas y Nuevas entidades y seleccione Guardar.
Revise la información de la pantalla Correcto y seleccione Listo.
Una vez que haya terminado con este procedimiento, puede ir a la página Temas para revisar los temas. Para obtener más información, consulte Administrar temas.
Crear una conexión CLU nueva en Power Apps
En Power Apps, si la página Conexiones aún no está en el foco, seleccione Conexiones en el panel izquierdo.
Seleccione Nueva conexión.
Seleccione Azure Cognitive Service para lenguaje (use el campo de búsqueda para limitar la lista si es necesario). Aparece una ventana que le solicita información de autenticación.
Para el tipo de autenticación, seleccione Clave de API e introduzca la clave de cuenta requerida.
Introduzca la URL del sitio raíz adecuada, si corresponde.
Seleccione Crear. La nueva conexión, con el nombre predeterminado "Azure Cognitive Service para lenguaje", aparece en la lista de conexiones de su entorno.
Seleccione los tres puntos (⋮) junto a esta conexión y seleccione Editar.
En la ventana que aparece, reemplace el nombre para mostrar predeterminado por otra cosa, para distinguir esta conexión de otras conexiones CLU y seleccione Actualizar.