Tutorial: Implementación de una aplicación web de chat empresarial (clásico)

Solo se aplica a:portal Foundry (clásico). Este artículo no está disponible para el nuevo portal de Foundry. Obtenga más información sobre el nuevo portal.

Nota

Los vínculos de este artículo pueden abrir contenido en la nueva documentación de Microsoft Foundry en lugar de la documentación de Foundry (clásico) que está viendo ahora.

En este artículo, implementará una aplicación web de chat empresarial que usa sus datos con un modelo de lenguaje grande en el portal de Microsoft Foundry.

La fuente de datos fundamenta el modelo con datos específicos. La fundamentación significa que el modelo usa tus datos para comprender el contexto de tu pregunta. No cambias el modelo implementado en sí mismo. Los datos permanecen separados y seguros en el origen de datos original.

Los pasos de este tutorial son:

• Configurar recursos.
• Agregue los datos.
• Pruebe el modelo con los datos.
• Implemente la aplicación web.

Requisitos previos

Importante

En este artículo se proporciona soporte heredado para proyectos basados en concentradores. No funcionará para proyectos de Foundry. Vea ¿Cómo sé qué tipo de proyecto tengo?

SDK nota de compatibilidad: Los ejemplos de código requieren una versión específica del SDK de Microsoft Foundry. Si encuentra problemas de compatibilidad, considere migrar de un proyecto basado en hub a un proyecto Foundry.

• Una cuenta de Azure con una suscripción activa. Si no tiene una, cree una cuenta de free Azure, que incluye una suscripción de evaluación gratuita.
• Si no tiene uno, cree un proyecto basado en hub.

• Un modelo de chat de Azure OpenAI implementado. Finalice el inicio rápido del área de juegos de Foundry para crear este recurso si no tiene uno.

• Una conexión de servicio de búsqueda para indexar los datos del producto de ejemplo. Si no tiene una, siga los pasos para crear y conectar un servicio de búsqueda.

• Una copia local de los datos del producto. El repositorio Azure-Samples/rag-data-openai-python-promptflow en GitHub tiene información de producto comercial de ejemplo para este escenario del tutorial. El product_info_11.md archivo tiene información del producto sobre los zapatos de senderismo TrailWalker para este ejemplo del tutorial. Descargue los datos del producto comercial contoso Trek de ejemplo en un archivo ZIP en la máquina local.

• Un Microsoft. Web proveedor de recursos registrado en la suscripción seleccionada para poder implementar en una aplicación web. Para obtener más información sobre cómo registrar un proveedor de recursos, consulte Registro del proveedor de recursos.

• Permisos necesarios para agregar asignaciones de roles en la suscripción de Azure. Solo el propietario de los recursos de Azure específicos puede conceder permisos por asignación de roles.

Portal de Foundry y Portal de Azure

En este tutorial, realizará algunas tareas en el portal de Foundry y algunas tareas en el portal de Azure.

El portal de Foundry es un entorno basado en web para crear, entrenar e implementar modelos de IA. Como desarrollador, es donde se compila e implementa la aplicación web de chat.

El portal de Azure permite a un administrador administrar y supervisar Azure recursos. Como administrador, se usa el portal para configurar la configuración de diferentes servicios Azure necesarios para el acceso desde la aplicación web.

Configuración de recursos

Importante

Debe tener los permisos necesarios para agregar asignaciones de roles en la suscripción de Azure. La concesión de permisos por asignación de roles solo la permite el propietario de los recursos de Azure específicos. Es posible que tenga que pedir al propietario de la suscripción de Azure (que sea su administrador de TI) que complete esta sección.

Para que los recursos funcionen correctamente en una aplicación web, configure los permisos correctos en el portal de Azure.

En primer lugar, identifique los recursos que necesita configurar en el portal de Foundry.

1. Abra el portal Foundry y, a continuación, seleccione el proyecto basado en concentrador que usó para implementar el modelo de chat de OpenAI de Azure.

2. Seleccione Centro de administración en el panel izquierdo.

3. Seleccione Recursos conectados en el proyecto.

4. Identifique los tres recursos que necesita configurar: el Azure OpenAI, el Búsqueda de Azure AI y el Azure Blob Storage que corresponde a su workspaceblobstore.

   

   Propina

   Si no ve Tipo en la tabla, seleccione Columnas en la esquina superior derecha y agregue o reordene las columnas seleccionadas. Si tiene varios recursos Azure OpenAI, use el que contiene el modelo de chat implementado.

5. Busque cada uno de estos nombres en el portal Azure. Abra cada uno de ellos en una nueva pestaña del explorador para que pueda cambiar entre ellos.

6. Cuando haya terminado, tiene tres nuevas pestañas del explorador abiertas: Servicio de búsqueda, Foundry y Contenedor de blobsstore. Mantenga abiertas las tres pestañas porque cambia entre ellas para configurar los recursos.

Habilitación de la identidad administrada

En la pestaña del explorador del recurso Search service en el portal de Azure, habilite la identidad administrada:

1. En el panel izquierdo, en Configuración, seleccione Identidad.
2. Cambie Estado a Activado.
3. Seleccione Guardar.

En la pestaña del explorador del recurso Foundry en el portal de Azure, habilite la identidad administrada:

1. En el panel izquierdo, en Administración de recursos, seleccione Identidad.
2. Cambie Estado a Activado.
3. Seleccione Guardar.

Establecimiento del control de acceso para la búsqueda

En la pestaña del explorador del recurso Search service en el portal de Azure, establezca la directiva de acceso de API:

1. En el panel izquierdo, en Configuración, seleccione Claves.
2. En Control de acceso de API, seleccione Ambos.
3. Cuando se le solicite, seleccione Sí para confirmar.

Asignación de roles

Repita este patrón para cada recurso en los pasos siguientes.

El patrón general para asignar el control de acceso basado en rol (RBAC) para cualquier recurso es:

1. Vaya al portal de Azure para el recurso especificado.
2. En la página izquierda del portal de Azure, seleccione Control de acceso (IAM).
3. Seleccione + Agregar>asignación de roles.
4. Busque el rol que necesita asignar y selecciónelo. A continuación, seleccione Siguiente.
5. Al asignar un rol a sí mismo:
   1. Seleccione Usuario, grupo o entidad de servicio.
   2. Seleccione Seleccionar miembros.
   3. Busque su nombre y selecciónelo.
6. Al asignar un rol a otro recurso:
   1. Seleccione Identidad administrada.
   2. Seleccione Seleccionar miembros.
   3. Use la lista desplegable para buscar el tipo de recurso que desea asignar. Por ejemplo, Foundry Tools o search service.
   4. Seleccione el recurso de la lista que aparece. Es posible que solo haya uno, pero todavía tienes que seleccionarlo.
7. Continúe con el asistente y seleccione Revisar y asignar para agregar la asignación de roles.

Siga estos pasos para asignar roles a los recursos que configuró en este tutorial:

• Asigne estos roles en la pestaña del explorador para Search service en el portal de Azure:

  • Lector de datos del índice de búsqueda para la identidad administrada de Foundry
  • Colaborador del servicio de búsqueda para la identidad administrada de Foundry
  • Colaborador a sí mismo (para buscar colaborador, cambie a la pestaña Roles de administrador con privilegios en la parte superior. Todos los demás roles se encuentran en la pestaña Roles de función de trabajo ).

• Asigne estos roles en la pestaña del explorador para Foundry en el portal de Azure:

  • Colaborador de los servicios Cognitivos de OpenAI para la identidad administrada del servicio de Búsqueda
  • Colaborador contigo mismo.

• Asigne estos roles en la pestaña del explorador para Azure Blob Storage en el portal de Azure:

  • Colaborador de datos de Storage Blob a la identidad administrada de Foundry
  • Lector de datos de Storage Blob a la identidad administrada del servicio de búsqueda
  • Colaborador a sí mismo

Ya ha terminado de configurar los recursos. Ahora puede cerrar las pestañas del explorador del portal de Azure si lo desea.

Agregar los datos e intentar el modelo de chat de nuevo

En el inicio rápido del área de juegos de Foundry (es un requisito previo para este tutorial), ves cómo responde tu modelo sin tus datos. Agregue los datos al modelo para que pueda responder a preguntas sobre sus productos.

Para completar esta sección, necesita una copia local de los datos del producto. El repositorio Azure-Samples/rag-data-openai-python-promptflow en GitHub contiene información de producto comercial de ejemplo que es relevante para este escenario del tutorial. En concreto, el product_info_11.md archivo contiene información del producto sobre los zapatos de senderismo TrailWalker que son relevantes para este ejemplo del tutorial. Descargue los datos del producto comercial contoso Trek de ejemplo en un archivo ZIP en la máquina local.

Siga estos pasos para agregar sus datos en el entorno de chat y ayudar al asistente a responder preguntas sobre sus productos. No va a cambiar el propio modelo implementado. Los datos se almacenan de forma independiente y segura en la suscripción de Azure.

1. Vaya al proyecto en Microsoft Foundry.

2. Seleccione Áreas de juegos en el panel izquierdo.

3. Seleccione Probar el área de juegos de chat.

4. Seleccione el modelo de chat implementado en la lista desplegable Implementación .

   

5. En el lado izquierdo del área de juegos de chat, seleccione Agregar los datos>+ Agregar un nuevo origen de datos.

   

6. En la lista desplegable Origen de datos , seleccione Cargar archivos.

   

7. Seleccione Cargar>carga de archivos para examinar los archivos locales.

8. Seleccione los archivos que desea cargar. Seleccione los archivos de información del producto que descargó o creó anteriormente. Agregue todos los archivos ahora. No podrá agregar más archivos más adelante en la misma sesión de área de juegos.

9. Seleccione Upload para cargar el archivo en la cuenta de Blob Storage de Azure. A continuación, seleccione Siguiente.

   

10. Seleccione el servicio Búsqueda de Azure AI.

11. En El nombre del índice vector, escriba product-info y seleccione Siguiente.

12. En la página Configuración de búsqueda en Configuración de vectores, anule la selección de la casilla Agregar búsqueda de vectores a este recurso de búsqueda . Esta configuración ayuda a determinar cómo responde el modelo a las solicitudes. A continuación, seleccione Siguiente.

    Nota

    Si agrega búsqueda de vectores, habrá más opciones disponibles aquí para un costo adicional.

13. Revise la configuración y seleccione Crear índice de vectores.

14. En el área de juegos, puede ver que la ingesta de datos está en curso. Este proceso puede tardar varios minutos. Antes de continuar, espere hasta que vea el origen de datos y el nombre del índice en lugar del estado.

    

15. Ahora puede chatear con el modelo haciendo la misma pregunta que antes ("¿Cuánto cuestan los zapatos de senderismo TrailWalker?"), y esta vez el modelo usa información de tus datos para construir la respuesta. Puede expandir el botón referencias para ver los datos que se usaron.

Implementación de la aplicación web

Cuando esté satisfecho con la experiencia en el portal de Foundry, implemente el modelo como una aplicación web independiente.

Búsqueda del grupo de recursos en el portal de Azure

En este tutorial, implemente la aplicación web en el mismo grupo de recursos que el centro de Foundry. Configurará la autenticación para la aplicación web en el portal de Azure.

Siga estos pasos para ir al grupo de recursos en el portal de Azure:

1. Diríjase a su proyecto en Foundry. Seleccione Centro de administración en el panel izquierdo.

2. En el encabezado Project, seleccione Overview.

3. Seleccione el nombre del grupo de recursos para abrir el grupo de recursos en el portal de Azure. En este ejemplo, el grupo de recursos se denomina rg-sdg-ai.

   

4. Ahora está en el portal de Azure, viendo el contenido del grupo de recursos donde ha desplegado el concentrador. Anote el nombre y la ubicación del grupo de recursos. Usarás esta información en la siguiente sección.

5. Mantenga esta página abierta en una pestaña del explorador. Volverá a él más adelante.

Implementación de la aplicación web

La publicación crea un Azure App Service en tu suscripción. Puede incurrir en costos en función del plan de precios que seleccione. Cuando haya terminado con la aplicación, elimínela desde el portal de Azure.

Para implementar la aplicación web:

Importante

Registre Microsoft. Web como proveedor de recursos antes de implementar en una aplicación web.

1. Complete los pasos de la sección anterior para agregar tus datos al espacio de prueba. Puede implementar una aplicación web con o sin sus propios datos, pero necesita un modelo desplegado tal como se describe en el quickstart del entorno de Foundry.

2. Seleccione Implementar > ... como aplicación web.

   

3. En la página Implementar en una aplicación web , escriba los detalles siguientes:

   • Nombre: un nombre único para la aplicación web.
   • Subscription: su suscripción de Azure. Si no ve ninguna suscripción disponible, primero registre Microsoft.Web como proveedor de recursos.
   • Grupo de recursos: seleccione un grupo de recursos en el que implementar la aplicación web. Use el mismo grupo de recursos que el centro.
   • Ubicación: seleccione una ubicación en la que implementar la aplicación web. Use la misma ubicación que el centro.
   • Plan de precios: elija un plan de precios para la aplicación web.
   • Habilitar el historial de chat en la aplicación web: en el tutorial, el cuadro historial de chat no está seleccionado. Si habilita la característica, los usuarios tienen acceso a sus consultas y respuestas anteriores individuales. Para obtener más información, consulte comentarios del historial de chat.

4. Seleccione Implementar.

5. Espere a que se implemente la aplicación. Este proceso puede tardar unos minutos.

6. Cuando esté listo, el botón Iniciar está habilitado en la barra de herramientas. Aún no inicies la aplicación y no cierres la página del área de juegos de chat; volverás a ella más adelante.

Configuración de la autenticación de aplicaciones web

De forma predeterminada, solo puede acceder a la aplicación web. En este tutorial, agregue autenticación para restringir el acceso a los miembros del inquilino de Azure. Los usuarios inician sesión con su cuenta de Microsoft Entra para acceder a la aplicación. Si lo prefiere, puede seguir un proceso similar para agregar otro proveedor de identidades. La aplicación solo usa la información de inicio de sesión del usuario para comprobar que es miembro del inquilino.

1. Vuelva a la pestaña del explorador con el portal de Azure o abra la Azure portal en una nueva pestaña del explorador. Vea el contenido del grupo de recursos donde implementó la aplicación web. Es posible que tenga que actualizar la vista para ver la aplicación web.

2. Seleccione el recurso de App Service en la lista de recursos del grupo de recursos.

3. En el menú izquierdo contraíble en Configuración, seleccione Autenticación.

   

4. Si ve que Microsoft aparece como un proveedor de identidades en esta página, no se necesita nada más. Puede omitir el paso siguiente.

5. Agregue un proveedor de identidades con la siguiente configuración:

   • Proveedor de identidades: seleccione Microsoft como proveedor de identidades. La configuración predeterminada de esta página restringe la aplicación solo al inquilino, por lo que no es necesario cambiar nada más aquí.
   • Tipo de inquilino: Workforce
   • Registro de aplicaciones: creación de un nuevo registro de aplicaciones
   • Nombre: el nombre del servicio de aplicación web
   • Tipos de cuenta admitidos: inquilino actual: inquilino único
   • Restringir el acceso: requiere autenticación
   • Solicitudes no autenticadas: redireccionamiento encontrado HTTP 302: recomendado para sitios web

Uso de la aplicación web

Casi estás ahí. Ahora puede probar la aplicación web.

1. Si ha cambiado la configuración, espere unos 10 minutos para que la configuración de autenticación surta efecto.

2. Vuelva a la pestaña del explorador con la página del área de juegos de chat en el portal de Foundry.

3. Seleccione Iniciar para abrir la aplicación web implementada. Si se le solicita, acepte la solicitud de permisos.

4. Si no ve Iniciar en el área de juegos, seleccione Aplicaciones web en el panel izquierdo y, a continuación, seleccione la aplicación en la lista para abrirla.

   Si la configuración de autenticación aún no está activa, cierre la pestaña del explorador de la aplicación web y vuelva al área de juegos de chat en el portal de Foundry. Espere un poco más y vuelva a intentarlo.

5. En la aplicación web, haga la misma pregunta que antes ("Cuánto son los zapatos de senderismo TrailWalker"). Esta vez, la aplicación usa información de los datos para construir la respuesta. Expanda el botón de referencia para ver los datos usados.

   

Comprender el historial de chat

Con la característica historial de chat, los usuarios pueden ver sus consultas y respuestas anteriores.

Habilite el historial de chats al implementar la aplicación web. Seleccione la casilla Habilitar historial de chats en la aplicación web.

Importante

Al habilitar el historial de chat, se crea una instancia de Cosmos DB en el grupo de recursos y se incurre en cargos adicionales por el almacenamiento usado. La eliminación de la aplicación web no elimina automáticamente la instancia de Cosmos DB. Para eliminar la instancia de Cosmos DB y todos los chats almacenados, vaya al recurso asociado en el portal de Azure y elimínelo.

Después de habilitar el historial de chats, los usuarios pueden mostrarlo u ocultarlo en la esquina superior derecha de la aplicación. Cuando se muestra el historial, pueden cambiar el nombre o eliminar conversaciones. A medida que inician sesión en la aplicación, las conversaciones se ordenan de la más reciente a la más antigua y se denominan en función de la primera consulta de la conversación.

Si elimina el recurso de Cosmos DB pero mantiene habilitada la opción historial de chat en Studio, los usuarios ven un error de conexión, pero pueden seguir usando la aplicación web sin historial de chat.

Actualización de la aplicación web

Use el área de juegos para agregar más datos o probar el modelo con diferentes escenarios. Cuando esté listo para actualizar la aplicación web con el nuevo modelo, seleccione Implementar > ... como aplicación web de nuevo. Seleccione Actualizar una aplicación web existente y elija la aplicación web existente en la lista. El nuevo modelo se implementa en la aplicación web existente.

Limpieza de recursos

Para evitar costos de Azure innecesarios, elimine los recursos que creó en este inicio rápido si no los necesita. Administrar recursos en el portal Azure.

Contenido relacionado

• Introducción a la creación de una aplicación de chat
• Crear una aplicación de chat personalizada con el SDK de Azure AI