Compartir por


Recursos de Azure para QnA Maker

QnA Maker usa varios orígenes de Azure, cada uno con un propósito diferente. Entender cómo se usan individualmente le permite planear y seleccionar el plan de tarifa correcto o saber cuándo debe cambiar el plan de tarifa. Entender cómo se usan en combinación le permite encontrar y corregir los problemas cuando se producen.

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 a preguntas, consulte la guía de migración.

Planeamiento de recursos

Cuando se desarrolla por primera vez una base de conocimiento QnA Maker, en la fase de prototipo, es habitual tener un único recurso de QnA Maker para las pruebas y la producción.

Al pasar a la fase de desarrollo del proyecto, debe tener en cuenta lo siguiente:

  • ¿Cuántos idiomas tendrá su sistema de knowledge base?
  • ¿En cuántas regiones necesita que la knowledge base esté disponible?
  • ¿Cuántos documentos de cada dominio contendrá el sistema?

Planee tener un único recurso de QnA Maker que contenga todas las bases de conocimiento que tengan el mismo idioma, la misma región y la misma combinación de dominio de sujeto.

Consideraciones sobre planes de tarifa

Normalmente hay tres parámetros que necesita tener en cuenta:

  • Rendimiento que se precisa del servicio:

    • seleccione el plan de aplicación apropiado para App Service en función de sus necesidades. Puede escalar o reducir verticalmente la aplicación.
    • Esto debería influir también en la selección de la SKU de Azure Cognitive Search; consulte más detalles aquí. Además, es posible que necesite ajustar la capacidad de Cognitive Search con réplicas.
  • Tamaño y número de bases de conocimiento: Elija la SKU de Azure Search adecuada para su escenario. Normalmente, puede decidir el número de bases de conocimiento que necesita en función del número de dominios de sujeto distintos. Si el dominio de sujeto (para un único idioma) debe estar en una base de conocimiento.

El recurso de servicio Azure Search debe haberse creado después de enero de 2019 de enero y no puede estar en el nivel gratis (compartido). No se admite la configuración de claves administradas por el cliente en Azure Portal.

Importante

Puede publicar N-1 bases de conocimiento en un nivel particular, donde N se corresponde con los índices máximos permitidos en el nivel. Compruebe también el tamaño y el número máximos de documentos permitidos por cada nivel.

Por ejemplo, si el nivel tiene 15 índices permitidos, puede publicar 14 bases de conocimiento (un índice por cada base de conocimiento publicada). El decimoquinto índice se utiliza para crear y probar todas las bases de conocimiento.

  • Número de documentos como orígenes: la SKU gratuita del servicio de administración de QnA Maker limita el número de documentos que puede administrar mediante el portal y las API a 3 (de 1 MB cada uno). La SKU estándar no tiene ningún límite en relación con el número de documentos que puede administrar. Puede consultar más información aquí.

En la tabla siguiente se proporcionan algunas directrices de alto nivel.

Administración de QnA Maker App Service Azure AI Search Limitaciones
Experimentación SKU gratuita Nivel Gratis Nivel Gratis Publicar hasta 2 KB; tamaño de 50 MB
Entorno de desarrollo/pruebas SKU Estándar Compartido Básico Publicaciones de hasta 14 KB; tamaño de 2 GB
Entorno de producción SKU Estándar Básico Estándar Publicar hasta 49 KB; tamaño de 25 GB
QPS de destino App Service Azure AI Search
3 S1, una réplica S1, una réplica
50 S3, 10 réplicas S1, 12 réplicas
80 S3, 10 réplicas S3, 12 réplicas
100 P3V2, 10 réplicas S3, 12 réplicas y 3 particiones
200 a 250 P3V2, 20 réplicas S3, 12 réplicas y 3 particiones

Cuándo cambiar un plan de tarifa

Actualizar Motivo
Actualización de la SKU de administración de QnA Maker Desea tener más pares de QnA o orígenes de documento en la base de conocimiento.
Actualización de la SKU de App Service y comprobación del nivel de Azure AI Search y creación de réplicas de Cognitive Search Su base de conocimiento debe atender más solicitudes de la aplicación cliente, como un bot de chat.
Actualización del servicio Azure AI Search Planea tener muchas bases de conocimiento.

Para obtener las últimas actualizaciones del entorno de ejecución, actualice la instancia de App Service en Azure Portal.

Claves de QnA Maker

El servicio de QnA Maker se ocupa de dos tipos de claves: claves de creación y claves de punto de conexión de consulta que se utilizan con el entorno de ejecución hospedado en la instancia de App Service.

Use estas claves al realizar solicitudes al servicio mediante las API.

Administración de claves

Nombre Location Propósito
Clave de autorización o suscripción Azure Portal estas claves se usan para acceder a las API del servicio de administración de QnA Maker. Estas API permiten editar las preguntas y respuestas de una base de conocimiento y publicar una base de conocimiento. Estas claves se crean al crear al mismo tiempo que los servicios QnA Maker.

Busque estas claves en el recurso de los servicios de Azure AI de la página Claves y punto de conexión.
Clave de punto de conexión de consulta Portal de QnA Maker Estas claves se usan para consultar el punto de conexión de la base de conocimiento publicado para obtener una respuesta para una pregunta de un usuario. Este punto de conexión de consulta normalmente se usa en un bot de chat o el código de la aplicación cliente que se conecta el servicio QnA Maker. Estas claves se crean al publicar una base de conocimiento de QnA Maker.

Busque estas claves en la página Configuración del servicio. Busque esta página en el menú del usuario de la parte superior derecha de la página, en el menú desplegable.

Búsqueda de claves de creación en Azure Portal

Puede ver y restablecer las claves de creación desde Azure Portal, donde creó el recurso de QnA Maker.

  1. Vaya al recurso de QnA Maker en Azure Portal y seleccione el recurso que tiene el tipo servicios de Azure AI:

    Lista de recursos de QnA Maker

  2. Vaya a Keys and Endpoint (Claves y punto de conexión):

    clave de suscripción de QnA Maker administrado (versión preliminar)

Búsqueda de claves de punto de conexión de consulta en el portal de QnA Maker

El punto de conexión está en la misma región que el recurso porque las claves del punto de conexión se utilizan para efectuar una llamada a la base de conocimiento.

Las claves de punto de conexión se pueden administrar desde el portal de QnA Maker.

  1. Inicie sesión en el portal de QnA Maker, vaya a su perfil y seleccione Service settings (Configuración del servicio):

    Clave de punto de conexión

  2. Vea o restablezca las claves:

    Administrador de claves de punto de conexión

    Nota

    Actualice las claves si cree que han estado en peligro. Esto puede requerir realizar los cambios correspondientes en el código del bot o de la aplicación cliente.

Región del servicio de administración

El servicio de administración de QnA Maker solo se usa para el portal de QnA Maker y para el procesamiento de datos inicial. Este servicio solo está disponible en la región Oeste de EE. UU. En este servicio de Oeste de EE. UU., no se almacena ningún dato de cliente.

Consideraciones de nomenclatura de recursos

El nombre del recurso QnA Maker, como qna-westus-f0-b, también se usa para asignar un nombre a los demás recursos.

La ventana de creación de Azure Portal le permite crear un recurso de QnA Maker y seleccionar los planes de tarifa para los demás recursos.

Captura de pantalla de Azure Portal para la creación de recursos de QnA Maker

Una vez creados los recursos, tienen el mismo nombre, excepto el recurso opcional de Application Insights, que pospone caracteres al nombre.

Captura de pantalla con las listas de recursos de Azure Portal

Sugerencia

Cree un nuevo grupo de recursos al crear un recurso de QnA Maker. Esto le permite ver todos los recursos asociados al recurso de QnA Maker al buscar por grupo de recursos.

Sugerencia

Utilice una convención de nomenclatura para indicar los planes de tarifa en el nombre del recurso o del grupo de recursos. Si recibe errores al crear una nueva base de conocimiento o al agregar nuevos documentos, el límite del plan de tarifa de Cognitive Search es un problema común.

Propósitos de los recursos

Cada recurso de Azure creado con QnA Maker tiene un propósito específico:

  • Recurso QnA Maker
  • Recurso de Cognitive Search
  • App Service
  • Plan de App Service
  • Servicio Application Insights

Recurso QnA Maker

El recurso QnA Maker proporciona acceso a las API de creación y publicación.

Opciones de configuración de recursos de QnA Maker

Al crear una nueva base de conocimiento en el portal de QnA Maker, el valor de idioma es el único valor que se aplica en el nivel de recursos. El idioma se selecciona al crear la primera base de conocimiento en el recurso.

Recurso de Cognitive Search

El recurso de Cognitive Search se usa para:

  • Almacenar los pares de QnA
  • Proporcionar la clasificación inicial (número 1 del clasificador) de los pares de QnA en el runtime

Uso de índices

El recurso mantiene un índice para que actúe como índice de prueba y los índices restantes se correlacionan con una base de conocimiento publicada.

Un recurso con un precio para contener 15 índices, mantendrá 14 bases de conocimiento publicadas y se utiliza un índice para probar todas las bases de conocimiento. La base de conocimiento divide este índice de prueba para que una consulta que usa el panel de prueba interactiva utilice el índice de prueba, pero solo devolverá los resultados de la partición específica asociada a la base de conocimiento concreta.

Uso de idiomas

La primera base de conocimiento creada en el recurso de QnA Maker se utiliza para determinar el único conjunto de idiomas para el recurso de Cognitive Search y todos sus índices. Solo puede tener un conjunto de idiomas para un servicio de QnA Maker.

Uso de un servicio único de Cognitive Search

Si crea un servicio QnA y sus dependencias (como, Search) en el portal, se creará el servicio Search de inmediato y se vinculará al servicio QnA Maker. Después de crear estos recursos puede actualizar el valor de App Service para usar un servicio Search existente y eliminar el que acaba de crear.

Aprenda cómo configurar QnA Maker para usar un recurso de servicio de Azure AI diferente del que se creó como parte del proceso de creación de recursos de QnA Maker.

App Service y plan de App Service

La aplicación cliente usa App Service para tener acceso a las bases de conocimiento publicadas a través del punto de conexión del entorno de ejecución. App Service incluye la segunda capa de clasificación basada en el procesamiento de lenguaje natural (NLP) (clasificador n.º 2) de los pares de QnA en tiempo de ejecución. La segunda clasificación aplica filtros inteligentes que pueden incluir metadatos y mensajes de seguimiento.

Para consultar la knowledge base publicada, todas las knowledge base publicadas usan el mismo punto de conexión de dirección URL, pero especifican el identificador de knowledge base dentro de la ruta.

{RuntimeEndpoint}/qnamaker/knowledgebases/{kbId}/generateAnswer

Application Insights

Application Insights se usa para recopilar registros y telemetría de chat. Revise las consultas de Kusto comunes para obtener información sobre el servicio.

Uso compartido de los servicios con QnA Maker

QnA Maker crea varios recursos de Azure. Para simplificar la administración y beneficiarse del uso compartido de los costos, use la siguiente tabla para saber lo que puede y no puede compartir:

Servicio Compartir Motivo
Servicios de Azure AI X No es posible por diseño
Plan de App Service Espacio en disco fijo asignado para un plan de App Service. Si otras aplicaciones que comparten el mismo plan de App Service usan un espacio en disco significativo, la instancia de App Service en QnAMaker tendrá problemas.
App Service X No es posible por diseño
Application Insights Se puede compartir
Servicio de búsqueda 1. testkb es un nombre reservado para el servicio QnAMaker; no lo pueden usar otros.
2. La asignación de sinónimo por el nombre synonym-map está reservada para el servicio QnAMaker.
3. El número de bases de conocimiento publicadas está limitado por el nivel del servicio Search. Si hay índices libres disponibles, otros servicios pueden utilizarlos.

Pasos siguientes