Solución de problemas para QnA Maker
La lista de las preguntas frecuentes seleccionadas sobre QnA Maker le ayudará a adoptar este servicio de forma más rápida y a obtener mejores resultados.
Nota
El servicio QnA Maker se retirará del mercado el 31 de marzo de 2025. Ya hay disponible una versión más reciente de la funcionalidad de preguntas y respuestas como parte de Lenguaje de Azure AI. Para más información sobre las funcionalidades de respuesta a preguntas en el servicio de lenguaje, consulte Respuesta a preguntas. A partir del 1 de octubre de 2022 no podrá crear nuevos recursos de QnA Maker. Para obtener información sobre la migración de knowledge bases existentes de QnA Maker a respuesta de preguntas, consulte la guía de migración.
Administración de predicciones
¿Cómo puedo mejorar el rendimiento de las predicciones de consulta?
Respuesta: Los problemas de rendimiento indican que es necesario realizar un escalado vertical de sus instancias de App Service y Cognitive Search. Considere la posibilidad de agregar una réplica a su instancia de Cognitive Search para mejorar el rendimiento.
Obtenga más información sobre los planes de tarifa.
Cómo obtener el punto de conexión de servicio de QnAMaker
Respuesta: El punto de conexión de servicio de QnAMaker es útil para fines de depuración cuando se ponga en contacto con el soporte técnico de QnAMaker o UserVoice. El punto de conexión es una dirección URL en este formato: https://your-resource-name.azurewebsites.net.
Vaya a su servicio QnAMaker (grupo de recursos) en Azure Portal
Seleccione la instancia de App Service asociada al recurso de QnA Maker. Normalmente, los nombres son los mismos.
La dirección URL del punto de conexión está disponible en la sección Información general
Administrar la base de conocimiento
Eliminé por accidente una parte de QnA Maker, ¿qué debo hacer?
Respuesta: No elimine ninguno de los servicios de Azure creados junto con el recurso de QnA Maker, como Search o Web App. Estos son necesarios para que QnA Maker funcione; si elimina uno, QnA Maker dejará de funcionar correctamente.
Todas las eliminaciones son permanentes, incluidos los pares de preguntas y respuestas, archivos, direcciones URL, preguntas y respuestas personalizadas, bases de conocimiento o recursos de Azure. Asegúrese de exportar la base de conocimiento desde la página Settings (Configuración) antes de eliminar cualquier de sus partes.
¿Por qué mis direcciones URL o archivos no extraen pares de preguntas y respuestas?
Respuesta: Es posible que QnA Maker no pueda extraer automáticamente algún contenido de preguntas y respuestas (QnA) de las direcciones URL de P+F válidas. En tales casos, puede pegar el contenido de QnA en un archivo .txt y ver si la herramienta puede ingerirlo. Como alternativa, puede redactar contenido y agregarlo a la knowledge base a través del portal de QnA Maker.
¿Cuál es el tamaño máximo para crear una base de conocimiento?
Respuesta: El tamaño de la knowledge base depende de la SKU de Azure Search que elija al crear el servicio QnA Maker. Obtenga más detalles aquí.
¿Por qué no se ve nada en el menú desplegable cuando intento crear una nueva base de conocimiento?
Respuesta: Todavía no ha creado ningún servicio QnA Maker en Azure. Lea aquí para saber cómo hacerlo.
¿Cómo se puede compartir una base de conocimiento con otros usuarios?
Respuesta: El uso compartido funciona en el nivel de un servicio QnA Maker, es decir, todas las knowledge bases de los servicios se compartirán. Obtenga información aquí para colaborar en una knowledge base.
¿Puede compartir una base de conocimiento con un colaborador que no esté en el mismo inquilino de AAD, para modificarla?
Respuesta: El uso compartido se basa en el control de acceso basado en rol de Azure. Si puede compartir cualquier recursos en Azure con otro usuario, también puede compartir QnA Maker.
Si tiene un plan de App Service con cinco bases de conocimiento de QnAMaker, ¿puede asignar derechos de lectura o escritura a cinco usuarios distintos para que cada uno de ellos pueda acceder solo a una base de conocimiento de QnAMaker?
Respuesta: Puede compartir un servicio completo de QnAMaker, no bases de conocimiento individuales.
¿Cómo se puede cambiar el mensaje predeterminado cuando no se encuentra ninguna buena coincidencia?
Respuesta: El mensaje predeterminado es parte de la configuración de App Service.
- Vaya al recurso de App Service en Azure Portal.
- Seleccione la opción Configuración.
- Cambie el valor del parámetro DefaultAnswer.
- Reiniciar App Service
¿Por qué mi vínculo de SharePoint no se extrae?
Respuesta: Para más información, consulte Ubicaciones de orígenes de datos.
Las actualizaciones que realizo en mi knowledge base no se publican. ¿Por qué no?
Respuesta: Cada edición, ya sea para actualizar la tabla, hacer pruebas o cambiar la configuración, debe guardarse para poder publicarla. Asegúrese de seleccionar el botón Guardar y entrenar después de cada edición que realice.
¿Knowledge base admite datos enriquecidos o multimedia?
Respuesta:
Extracción automática multimedia para archivos y direcciones URL
- Direcciones URL: capacidad limitada de conversión de HTML a Markdown.
- Archivos: no compatibles.
Texto de respuesta en formato Markdown
Una vez que los pares de QnA estén en knowledge base, puede editar el texto de Markdown de la respuesta para incluir vínculos a los elementos multimedia disponibles desde direcciones URL públicas.
¿Admite QnA Maker otros idiomas aparte de inglés?
Respuesta: Obtenga más detalles acerca de los idiomas admitidos.
Si tiene contenido en varios idiomas, asegúrese de crear un servicio independiente para cada idioma.
Administración de servicios
¿Cuándo debo reiniciar mi instancia de App Service?
Respuesta: Actualice su instancia de App Service cuando el icono de precaución aparezca junto al valor de versión de knowledge base en la tabla Endpoint keys (Claves de punto de conexión) de la página User Settings(Configuración de usuario).
Eliminé mi servicio Search existente. ¿Cómo lo puedo corregir?
Respuesta: si elimina un índice de Azure AI Search, la operación es definitiva y no es posible recuperar el índice.
He eliminado mi índice "testkb" en mi servicio Search. ¿Cómo puedo solucionarlo?
Respuesta: En caso de que haya eliminado el índice testkb en el servicio Search, puede restaurar los datos desde la última KB publicada. Use la herramienta de recuperación RestoreTestKBIndex disponible en GitHub.
Recibo el siguiente error: "Compruebe si la configuración de CORS de App Service de QnA Maker permite https://www.qnamaker.ai o si hay restricciones de red específicas de la organización". ¿Cómo puedo resolverlo?
Respuesta: En la sección API del panel de App Service, actualice el valor de CORS a * o "https://www.qnamaker.ai". Si el problema no se resuelve, compruebe si hay restricciones específicas de la organización.
¿Cuándo debo actualizar mis claves de punto de conexión?
Respuesta: Actualice las claves de punto de conexión si sospecha que han sido objeto de alguna acción fraudulenta.
¿Se puede usar el mismo recurso de Azure AI Search para bases de conocimiento que emplean varios idiomas?
Respuesta: Para usar varios idiomas y varias bases de conocimiento, el usuario tiene que crear un recurso de QnA Maker para cada idioma. De esta manera, se creará un servicio de Azure Search independiente por idioma. La combinación de bases de datos de distintos idiomas en un único servicio de Azure Search dará lugar a una importancia degradada de los resultados.
¿Cómo se puede cambiar el nombre del recurso de Azure AI Search usado por QnA Maker?
Respuesta: el nombre del recurso de Azure AI Search es el nombre del recurso de QnA Maker con algunas letras aleatorias colocadas al final. Esto hace que sea más difícil distinguir entre varios recursos de Search en QnA Maker. Cree un servicio de búsqueda independiente (asígnele el nombre que desee) y conéctelo a su servicio de QnA. Los pasos son similares a los que debe hacer para actualizar una instancia de Azure Search.
Si QnA Maker devuelve el mensaje "Runtime core is not initialized" (El núcleo del entorno en tiempo de ejecución no se ha inicializado), ¿cómo puedo resolverlo?
Respuesta: Es posible que el espacio en disco para el servicio de aplicaciones esté lleno. Pasos para corregir el espacio en disco:
En Azure Portal, seleccione el servicio de aplicaciones de QnA Maker y, a continuación, detenga el servicio.
En el servicio de aplicaciones, seleccione Herramientas de desarrollo, Herramientas avanzadas y, a continuación, Ir. Se abre una nueva ventana del explorador.
Seleccione Depurar consola y, a continuación, CMD para abrir una herramienta de línea de comandos.
Vaya al directorio site/wwwroot/Data/QnAMaker/ .
Quite todas las carpetas cuyo nombre comience por
rd.No elimine lo siguiente:
- Archivo KbIdToRankerMappings.txt
- Archivo EndpointSettings.json
- Carpeta EndpointKeys
Inicie el servicio de aplicaciones.
Obtenga acceso a la base de conocimiento para comprobar que funcione ahora.
¿Por qué no funciona mi instancia de Application Insights?
Respuesta: Para solucionar el problema, compruebe y actualice los pasos siguientes:
En App Service-> Grupo de valores -> Sección de configuración -> Configuración de la aplicación->, los parámetros de nombre "UserAppInsightsKey" se han configurado correctamente y se han establecido en el GUID de la pestaña correspondiente de información general de Application Insights ("clave de instrumentación").
En App Service -> Grupo de valores -> sección "Application Insights" -> asegúrese de que App Insights se haya habilitado y conectado al recurso correspondiente de Application Insights.
Mi instancia de Application Insights está habilitada, pero ¿por qué no funciona correctamente?
Respuesta: Siga los pasos indicados a continuación:
Copie el valor del nombre "APPINSIGHTS_INSTRUMENTATIONKEY" en el nombre "UserAppInsightsKey" mediante un reemplazo si ya existe algún valor.
Si la clave "UserAppInsightsKey" no existe en la configuración de la aplicación, agregue una nueva clave con ese nombre y copie el valor.
Guarde el valor y App Service se reiniciará automáticamente. De este modo, se debería resolver el problema.
Integración con otros servicios, como bots
¿Es necesario utilizar Bot Framework para usar QnA Maker?
Respuesta: No, no es necesario usar Bot Framework con QnA Maker. Sin embargo, QnA Maker se ofrece como una de las diversas plantillas del Servicio de Bot de Azure AI. Bot Service permite el desarrollo rápido de bots inteligentes mediante Microsoft Bot Framework y se ejecuta en un entorno sin servidor.
¿Cómo se puede crear un bot con QnA Maker?
Respuesta: Siga las instrucciones de esta documentación para crear su Bot con el Servicio de Bot de Azure AI.
¿Cómo se usa una base de conocimiento diferente con un Servicio de Bot de Azure AI existente?
Respuesta: Debe tener la siguiente información sobre la base de conocimiento:
- Id. de base de conocimiento.
- Nombre de subdominio personalizado del punto de conexión publicado de la base de conocimiento, conocido como
host, que se encuentra en la página Configuración después de la publicación. - Clave del punto de conexión publicado de la base de conocimiento; se encuentra en Settings (Configuración) después de publicarlo.
Con esta información, vaya al servicio de aplicaciones del bot en Azure Portal. En Configuración -> Configuración -> Configuración de la aplicación, cambie esos valores.
La clave del punto de conexión de la base de conocimiento se llama QnAAuthkey en el servicio ABS.
¿Pueden dos o más aplicaciones cliente compartir una knowledge base?
Respuesta: Sí, la base de conocimiento se puede consultar desde cualquier número de clientes. Si la respuesta de la base de conocimiento parece lenta o se agota el tiempo de espera, considere la posibilidad de actualizar el nivel de servicio del servicio de aplicaciones asociado a la base de conocimiento.
¿Cómo puedo insertar el servicio QnA Maker en mi sitio web?
Respuesta: Siga estos pasos para insertar el servicio QnA Maker como control de chat en web en su sitio web:
Almacenamiento de datos
¿Qué datos se almacenan y dónde?
Respuesta:
Cuando se crea el servicio de QnA Maker, se selecciona una región de Azure. Sus bases de conocimiento y los archivos de registro se almacenan en esta región.