Migración de QnA Maker a respuesta personalizada a preguntas

Respuesta personalizada a preguntas, una característica de Azure Cognitive Service para lenguaje, se presentó en mayo de 2021 con varias características nuevas, como la relevancia mejorada mediante un clasificador de aprendizaje profundo, las respuestas precisas y la compatibilidad completa con regiones. Cada proyecto de respuesta personalizada a preguntas es equivalente a una base de conocimiento en QnA Maker. Puede migrar fácilmente las bases de conocimiento de un recurso de QnA Maker a proyectos de respuesta personalizada a preguntas dentro de un recurso de idioma. También puede optar por migrar bases de conocimiento de varios recursos de QnA Maker a un recurso de idioma específico.

Para migrar correctamente las bases de conocimiento, la cuenta que realiza la migración necesita acceso de colaborador al recurso de QnA Maker y de idioma seleccionados. Cuando se realiza la migración de una base de conocimiento, se copian los detalles siguientes en el nuevo proyecto de respuesta personalizada a preguntas:

  • Pares de pregunta y respuesta, incluidas sugerencias de aprendizaje activo.
  • Sinónimos y respuesta predeterminada del recurso de QnA Maker.
  • El nombre de la base de conocimiento se copia en el campo de descripción del proyecto.

Los valores de nivel de recurso, como el control de acceso basado en rol (RBAC), no se migra al recurso nuevo. Estos valores de nivel de recurso tendrían que volver a configurarse para el recurso de idioma después de la migración. También tendrá que volver a habilitar el análisis para el recurso de idioma.

Pasos para migrar los SDK

Esta guía de migración del SDK está pensada para ayudar en la migración a la nueva biblioteca cliente de preguntas y respuestas, Azure.AI.Language.QuestionAnswering, desde la anterior, Microsoft.Azure.CognitiveServices.Knowledge.QnAMaker. Se centrará en comparaciones en paralelo para operaciones similares entre los dos paquetes.

Pasos para migrar bases de conocimiento

Puede seguir los pasos siguientes para migrar las bases de conocimiento:

  1. Cree un recurso de idioma con la característica de respuesta personalizada a preguntas habilitada. Al crear el recurso de idioma en Azure Portal, verá la opción para habilitar respuesta personalizada a preguntas. Al seleccionar esa opción y continuar, se le pedirán detalles de Azure Search para guardar las bases de conocimiento.

  2. Si quiere agregar bases de conocimiento en varios idiomas al recurso de idioma, visite Language Studio para crear el primer proyecto de respuesta personalizada a preguntas y seleccione la primera opción, como se muestra a continuación. La configuración de idioma del recurso de idioma solo se puede especificar al crear un proyecto. Si quiere migrar las bases de conocimiento existentes en un único idioma al recurso de idioma, puede omitir este paso.

    Screenshot of choose language UI screen

  3. Visite https://www.qnamaker.ai y seleccione Iniciar migración en la nota de migración de la página de la knowledge base. Se abrirá un cuadro de diálogo para iniciar la migración.

    Start Migration button that appears in a banner on qnamaker.ai

  4. Rellene los detalles necesarios para iniciar la migración. El inquilino se seleccionará de forma automática. Puede elegir cambiar el inquilino.

    Migrate QnAMaker with red selection box around the tenant selection option

  5. Seleccione el recurso de QnA Maker que contiene las bases de conocimiento que se van a migrar.

    Migrate QnAMaker with red selection box around the QnAMaker resource selection option

  6. Seleccione el recurso de idioma al que quiera migrar las bases de conocimiento. Solo podrá ver los recursos de idioma que tienen habilitada la respuesta personalizada a preguntas. La configuración de idioma para el recurso de idioma se muestra en las opciones. No podrá migrar bases de conocimiento en varios idiomas desde recursos de QnA Maker a un recurso de idioma si no se especifica su configuración de idioma.

    Migrate QnAMaker with red selection box around the language resource option currently selected resource contains the information that language is unspecified

    Si quiere migrar bases de conocimiento en varios idiomas al recurso de idioma, debe habilitar la configuración de varios idiomas al crear el primer proyecto de respuesta personalizada a preguntas para el recurso de idioma. Para ello, siga las instrucciones del paso 2. Si no se especifica la configuración de idioma para el recurso de idioma, se le asigna el idioma del recurso de QnA Maker seleccionado.

  7. Seleccione todas las bases de conocimiento que quiera migrar > seleccione Siguiente.

    Migrate QnAMaker with red selection box around the knowledge base selection option with a drop-down displaying three knowledge base names

  8. Puede revisar las bases de conocimiento que planea migrar. Puede haber algunos errores de validación en los nombres de proyecto, ya que para los proyectos de respuesta personalizada a preguntas se siguen reglas de validación más estrictas. Para resolver estos errores debido a caracteres no válidos, active la casilla (en rojo) y haga clic en Siguiente. Se trata de un método de un solo clic para reemplazar los caracteres problemáticos en el nombre por los caracteres aceptados. Si hay un duplicado, el sistema genera un nuevo nombre de proyecto único.

    Precaución

    Si migra una base de conocimiento con el mismo nombre que un proyecto que ya existe en el recurso de idioma de destino, el contenido del proyecto se reemplazará por el de la base de conocimiento seleccionada.

    Screenshot of an error message starting project names can't contain special characters

  9. Después de resolver los errores de validación, seleccione Iniciar migración

    Screenshot with special characters removed

  10. La migración tardará unos minutos. No cancele la migración mientras está en curso. Puede navegar a los proyectos migrados dentro de Language Studio después de la migración.

    Screenshot of successfully migrated knowledge bases with information that you can publish by using Language Studio

    Si alguna base de conocimiento no se puede migrar a proyectos de respuesta personalizada a preguntas, se mostrará un error. Los errores de migración más comunes se producen cuando:

    • Los recursos de origen y destino no son válidos.
    • Se intenta migrar una base de conocimiento (KB) vacía.
    • Se ha alcanzado el límite de una instancia de Azure Search vinculada a los recursos de destino.

    Screenshot of a failed migration with an example error

    Una vez que resuelva estos errores, puede volver a ejecutar la migración.

  11. La migración solo copiará las instancias de prueba de las bases de conocimiento. Una vez que se haya completado la migración, tendrá que implementar manualmente las bases de conocimiento para copiar el índice de prueba en el índice de producción.

Pasos siguientes