Tutorial: Parte 1: Creación de recursos para desarrollar una aplicación de chat personalizada con el SDK de flujo de avisos

  • Artículo

En este tutorial, usará el SDK de flujo de avisos (y otras bibliotecas) para compilar, configurar, evaluar e implementar una aplicación de chat para su empresa minorista denominada Contoso Trek. Su empresa minorista se especializa en ropa y equipo de camping al aire libre. La aplicación de chat debe responder a preguntas sobre sus productos y servicios. Por ejemplo, la aplicación de chat puede responder a preguntas como "¿Qué tienda es la más impermeable?" o "¿cuál es la mejor bolsa de dormir para tiempo frío?".

Este tutorial es la primera parte de un tutorial que consta de tres partes. Esta primera parte muestra cómo un administrador de una suscripción Azure crea y configura los recursos necesarios para las partes dos y tres de la serie de tutoriales. Las partes dos y tres muestran cómo un desarrollador usa los recursos. En muchas organizaciones, la misma persona podría asumir ambos roles. En esta primera parte, aprenderá a:

  • Creación de un centro de Azure AI Studio
  • Creación de un proyecto
  • Creación de un índice de Búsqueda de Azure AI
  • Configuración del acceso a los recursos de Azure AI Studio y Azure AI Search

Si ha completado otros tutoriales o inicios rápidos, es posible que ya haya creado algunos de los recursos necesarios para este tutorial. Si ya lo ha hecho, no dude en omitir estos pasos.

Este tutorial es la primera parte de un tutorial de tres partes.

Requisitos previos

  • Una cuenta de Azure con una suscripción activa. Si no tiene ninguna cuenta, cree una gratuita.

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 está permitida por el propietario de los recursos específicos de Azure. Es posible que tenga que pedir al propietario de la suscripción Azure (quién podría ser su administrador de TI) que complete este tutorial por usted.

Azure AI Studio y Azure Portal

En este tutorial, usará los recursos de Azure para compilar la aplicación de chat. Usará Azure AI Studio y Azure Portal para crear y configurar estos recursos.

  • Como administrador, usted utiliza Azure Portal para configurar el acceso a los recursos.
  • Como desarrollador, usted utiliza Azure AI Studio para agrupar los recursos necesarios para crear, evaluar e implementar la aplicación de chat. También puede interactuar con los modelos e implementaciones en AI Studio.

Creación de un centro de Azure AI Studio

Nota:

Un centro de Estudio de IA de Azure es un lugar centralizado en el que se administran todas las necesidades del proyecto de IA, como la seguridad y los recursos, lo que permite desarrollar y probar con mayor rapidez. Para obtener más información sobre cómo los centros pueden ayudarle, consulte el artículo Introducción a los centros y proyectos.

Para crear un centro en Inteligencia artificial de Azure Studio, siga estos pasos:

  1. Ir a la páginaInicio en Azure AI Studio e inicie sesión con su cuenta de Azure.

  2. Seleccione Todos los recursos en el panel izquierdo. Si no puede ver esta opción, en la barra superior seleccione Todos los recursos y proyectos. Luego, seleccione + Nuevo centro.

    Captura de pantalla del botón para crear un centro.

  3. En el cuadro de diálogo Crear un nuevo centro, escriba un nombre para el centro (por ejemplo, contoso-hub). Si no tiene un grupo de recursos, se creará un nuevo Grupo de recursos vinculado a la Suscripción proporcionada. Deje seleccionada la opción predeterminada Conectar Servicios de Azure AI.

  4. Seleccione Siguiente. Si no ha reutilizado un grupo de recursos existente, se creará un nuevo grupo de recursos (rg-contoso). También se crea un servicio de Azure AI (ai-contoso-hub) para el centro.

    Captura de pantalla del cuadro de diálogo para conectar servicios al crear un centro.

    Nota:

    Si no ve (nuevo) antes de las entradas de Grupo de recursos y Conectar Servicios de Azure AI, se está usando un recurso existente. Para este tutorial, cree una entidad independiente mediante Crear un grupo de recursos y Crear servicios de IA. Esto le permitirá evitar cargos inesperados mediante la eliminación de las entidades después del tutorial.

  5. Revise la información y seleccione Crear.

    Captura de pantalla del cuadro de diálogo para revisar la configuración del nuevo centro.

  6. Puede ver el progreso de la creación del centro en el asistente.

    Captura de pantalla del cuadro de diálogo para revisar el progreso de la creación de recursos del centro.

Creación de un proyecto

Para crear un proyecto en Azure AI Studio, siga estos pasos:

  1. Vaya a la página Inicio de Azure AI Studio.
  2. Seleccione + Nuevo proyecto.
  3. Escriba un nombre para el proyecto.
  4. Seleccione el centro que creó en el paso anterior.

Una vez creado un proyecto, puede acceder al área de juegos, las herramientas y otros recursos en el panel de navegación izquierdo.

Creación de un índice de Búsqueda de Azure AI

El objetivo de esta aplicación es establecer las respuestas del modelo en los datos personalizados. El índice de búsqueda se usa para recuperar documentos relevantes en función de la pregunta del usuario.

Necesita un servicio y una conexión de Búsqueda de Azure AI para crear un índice de búsqueda.

Nota:

La creación de un servicio de Búsqueda de Azure AI y los índices de búsqueda posteriores tienen costos asociados. Puede ver detalles sobre los planes de tarifa y precios del servicio de Búsqueda de Azure AI en la página de creación para confirmar el costo antes de crear el recurso.

Creación de un servicio de Búsqueda de Azure AI

Si ya tiene un servicio de Búsqueda de Azure AI, puede ir directamente a la sección siguiente.

De lo contrario, puede crear un servicio de Búsqueda de Azure AI mediante Azure Portal.

  1. Creación de un servicio de Búsqueda de Azure AI en Azure Portal.
  2. Seleccione los detalles del grupo de recursos y de la instancia. Puede ver detalles sobre los planes de tarifa y precios en esta página.
  3. Continúe con el asistente y seleccione Revisar y asignar para crear el recurso.
  4. Confirme los detalles del servicio de Búsqueda de Azure AI, incluido el costo estimado.
  5. Seleccione Crear para crear el servicio de Búsqueda de Azure AI.

Conexión de Azure AI Search al proyecto

Si ya tiene una conexión de Búsqueda de Azure AI en el proyecto, puede ir directamente a configurar el acceso para el servicio de Búsqueda de Azure AI.

En Inteligencia artificial de Azure Studio, compruebe si hay un recurso conectado de Búsqueda de Azure AI.

  1. En AI Studio, vaya al proyecto y seleccione Configuración en el panel izquierdo.
  2. En la sección Recursos conectados, busque si tiene una conexión de tipo Búsqueda de Azure AI.
  3. Si dispone de una conexión Azure AI Search, puede pasar a configurar el acceso a los recursos.
  4. De lo contrario, seleccione Nueva conexión y, a continuación, Búsqueda de Azure AI.
  5. Busque el servicio de Búsqueda de Azure AI en las opciones y seleccione Agregar conexión.
  6. Continúe con el asistente para crear la conexión. Para obtener más información sobre cómo agregar conexiones, consulte esta guía paso a paso.

Configuración del acceso para los recursos

En esta sección se muestra cómo configurar los distintos controles de acceso necesarios para los recursos que ha creado en las secciones anteriores.

Se recomienda usar Microsoft Entra ID en lugar de usar claves de API. Para usar esta autenticación, debe establecer los controles de acceso adecuados y asignar los roles adecuados para los servicios.

Configuración del acceso para los Servicios de Azure AI

Comience en el proyecto para buscar el recurso de AI Services:

  1. En AI Studio, vaya al proyecto y seleccione Configuración en el panel izquierdo.
  2. Seleccione Recursos conectados.
  3. Seleccione el nombre de AI Services o Azure OpenAI en la lista de recursos conectados para abrir la página de detalles del recurso. A continuación, vuelva a seleccionar el nombre del recurso en la página Detalles de conexión, que abre el recurso en Azure Portal.

Especifique el control de acceso en Azure Portal:

  1. En la página izquierda de Azure Portal, seleccione Control de acceso (IAM)>+ Agregar>Agregar asignación de roles.
  2. Busque el rol Usuario de OpenAI de Cognitive Services y luego selecciónelo. Seleccione Siguiente.
  3. Seleccione Usuario, grupo o entidad de servicio. A continuación, seleccione Seleccionar miembros.
  4. En el panel Seleccionar miembros que se abre, busque el nombre del usuario para el que desea agregar la asignación de roles. Seleccione el usuario y luego seleccione Seleccionar.
  5. Continúe con el asistente y seleccione Revisar + asignar para agregar la asignación de roles.

Ahora vuelva a Configuración AI Studio> Recursos conectados. Esta vez, seleccione el nombre deAzure AI Search en la lista de recursos conectados para abrir la página de detalles del recurso. A continuación, vuelva a seleccionar el nombre del recurso en la página Detalles de conexión, que abre el recurso en Azure Portal.

Para habilitar el control de acceso basado en rol para el servicio de Búsqueda de Azure AI, siga estos pasos:

  1. En el servicio de Búsqueda de Azure AI de Azure Portal, seleccione Configuración > Claves en el panel izquierdo.

  2. Seleccione Ambos para asegurarse de que las claves de API y el control de acceso basado en roles estén habilitados para el servicio de Búsqueda de Azure AI.

    Recorte de pantalla que muestra la configuración de control de acceso de API.

Advertencia

Puede usar el control de acceso basado en rol localmente porque ejecuta az login más adelante en esta serie de tutoriales. Pero cuando implementa su aplicación en la 3 parte del tutorial, la implementación se autentica mediante claves de API de su servicio de Búsqueda de Azure AI. La compatibilidad con la autenticación de Microsoft Entra ID de la implementación estará disponible próximamente. Por ahora, debe habilitar las claves y los puntos de conexión.

A continuación, conceda la identidad del usuario (o la identidad del desarrollador que completará las partes dos y tres) los roles Colaborador de datos del índice de búsqueda y Colaborador del servicio Search en el servicio Azure AI Search. Estos roles le permiten llamar al servicio de Búsqueda de Azure AI la identidad de usuario asociada.

Todavía en Azure Portal para el servicio de Búsqueda de Azure AI, asigne el rol Colaborador de datos de índice de búsqueda al servicio de Búsqueda de Azure AI. (Estos son los mismos pasos que ha hecho anteriormente para el servicio Azure OpenAI.)

  1. En la página izquierda de Azure Portal, seleccione Control de acceso (IAM)>+ Agregar>Agregar asignación de roles.
  2. Busque el rol Colaborador de datos del índice de búsqueda y, a continuación, selecciónelo. Luego, seleccione Siguiente.
  3. Seleccione Usuario, grupo o entidad de servicio. A continuación, seleccione Seleccionar miembros.
  4. En el panel Seleccionar miembros que se abre, busque el nombre del usuario para el que desea agregar la asignación de roles. Seleccione el usuario y luego seleccione Seleccionar.
  5. Continúe con el asistente y seleccione Revisar + asignar para agregar la asignación de roles.

Repita estos pasos para agregar también el rol Colaborador del servicio de búsqueda al servicio de Búsqueda de Azure AI.

Ya está listo para entregar el proyecto a un desarrollador para compilar la aplicación de chat. El desarrollador usará el SDK de flujo de avisos para compilar, configurar, evaluar e implementar la aplicación de chat para su empresa minorista llamada Contoso Trek.

Limpieza de recursos

Para evitar incurrir en costos innecesarios de Azure, debe eliminar los recursos que creó en este tutorial si ya no son necesarios. Para administrar recursos, puede usar Azure Portal.

Pero aún no los elimine, si desea compilar una aplicación de chat en la siguiente parte de esta serie de tutoriales.

Paso siguiente

Parte 2: Compilación de una aplicación de chat personalizada con el SDK de flujo de avisos