Herramienta de prueba de aplicaciones de Teams para depurar el bot de chat de IA - Teams

Inicie el desarrollo de aplicaciones de Microsoft Teams con su aplicación de bot de chat de IA de Teams y depure con la herramienta de prueba de aplicaciones de Teams (herramienta de prueba). La herramienta de prueba hace que la depuración de aplicaciones basadas en bots sea sencilla. No necesita una cuenta de desarrollador de Microsoft 365, una tunelización o un registro de aplicaciones y bots de Teams para usar la herramienta de prueba.

Puede chatear con el bot y ver los mensajes y las tarjetas adaptables a medida que aparecen en Teams. También puede simular una actividad en la Herramienta de prueba mediante desencadenadores de actividad.

Nota:

La herramienta de prueba de aplicaciones de Teams solo está disponible en Teams Toolkit v5.4.0.
La herramienta de prueba de aplicaciones de Teams solo se admite para clientes de escritorio y web.

Esta guía paso a paso le ayuda a crear un bot de chat de inteligencia artificial mediante el kit de herramientas de Teams y depurar con la herramienta de prueba. Verá la siguiente salida después de completar esta guía, donde el usuario puede acceder al bot de chat de IA y usarlo:

Requisitos previos

6 minutos restantes

Asegúrese de instalar las siguientes herramientas para compilar e implementar las aplicaciones.

Instalar	Para usar...
Visual Studio Code o Visual Studio	Entornos de compilación de JavaScript, TypeScript o C#. Use la versión más reciente.
Kit de herramientas de Teams	Extensión de Microsoft Visual Studio Code que crea un scaffolding de proyecto para la aplicación. Use Teams Toolkit v5.4.0. Para obtener más información, consulte Instalación del kit de herramientas de Teams.
Node.js	Entorno de tiempo de ejecución de JavaScript de back-end. Para obtener más información, vea Node.js tabla de compatibilidad de versiones para el tipo de proyecto.
OpenAI o Azure OpenAI	En primer lugar, cree la clave de API de OpenAI para usar la GPT de OpenAI. Si desea hospedar la aplicación o acceder a los recursos en Azure, debe crear un servicio Azure OpenAI.
Microsoft Edge (recomendado) o Google Chrome	Un explorador con herramientas de desarrollo.

Creación del área de trabajo del proyecto para la aplicación de bot de chat de IA

5 minutos restantes

Vamos a crear la aplicación de bot de chat de IA.

La funcionalidad de bot de una aplicación de Teams crea un bot de chat o un bot conversacional. Se comunica con un servicio web, facilitando el uso de sus servicios. El bot puede ejecutar tareas sencillas y automatizadas, como la entrega del servicio al cliente. Puede obtener la previsión meteorológica, realizar reservas o cualquier otro servicio ofrecido mediante un bot conversacional.

Captura de pantalla que muestra la aplicación con tres características. El bot está resaltado.

Como ya está preparado para crear estas aplicaciones, puede configurar un nuevo proyecto de Teams para crear la aplicación de bot de chat de IA. En este tutorial, aprenderá lo siguiente:

Cree el área de trabajo del proyecto de bot.
Realice un recorrido por el código fuente de la aplicación de bot.

Creación del área de trabajo del proyecto de bot

Si se cumplen los requisitos previos, comencemos.

Abra Visual Studio Code.
Seleccione el icono Kit de herramientas de Teams en la barra de actividad de Visual Studio Code.
Seleccione Crear una nueva aplicación.
Seleccione Bot.
Seleccione Bot de chat de IA. Si necesita una funcionalidad diferente para el bot, seleccione la opción necesaria.
Seleccione JavaScript.
Seleccione Carpeta predeterminada.

Para cambiar la ubicación predeterminada, siga estos pasos:
1. Seleccione Examinar.
2. Seleccione la ubicación del área de trabajo del proyecto.
3. Seleccione Seleccionar carpeta.
4. Escriba un nombre adecuado para la aplicación y, a continuación, seleccione la tecla Entrar .
  
  Aparece un cuadro de diálogo en el que debe elegir sí o no para confiar en los autores de los archivos de esta carpeta.
  
  Ahora, ha creado correctamente el área de trabajo del proyecto de bot de chat de IA.

Realice un recorrido por el código fuente de la aplicación bot.

Después de finalizar el scaffolding, explore los directorios y archivos del proyecto en la sección EXPLORER de Visual Studio Code.

Captura de pantalla que muestra la estructura de la carpeta del bot de ejemplo del kit de herramientas de Teams.

Nombre de archivo o carpeta	Contenido
`env/.env.testtool`	Archivo de configuración con variables de entorno que se pueden confirmar en Git.
`env/.env.testtool.user`	El archivo de configuración con variables de entorno, incluidas las credenciales, que no se confirman en Git de forma predeterminada.
`appPackage`	Archivos de plantilla de manifiesto de aplicación e iconos de aplicación (color.png y outline.png).
`appPackage/manifest.json`	Manifiesto de aplicación para ejecutar la aplicación en un entorno local y remoto.
`src/app.js`	Controla las lógicas empresariales del bot de chat de IA.
`teamsapp.yml`	Este es el archivo de proyecto principal del kit de herramientas de Teams. El archivo de proyecto define dos elementos principales: propiedades y definiciones de configuración y fase.
`teamsapp.local.yml`	Esto invalida `teamsapp.yml` con acciones que habilitan la ejecución y depuración locales.
`teamsapp.testtool.yml`	Esto invalida `teamsapp.yml` con acciones que habilitan la ejecución y depuración locales en la herramienta de prueba.

Compilación y ejecución de la aplicación de bot de chat de IA

4 minutos restantes

Después de configurar el área de trabajo del proyecto con Teams Toolkit, compile el proyecto del bot de chat de IA.

Creación de una clave y un punto de conexión de Open AI para el bot de chat de IA

Acceda a Portal Azure.
Seleccione Crear un recurso y busque Azure Open AI.
Seleccione Azure Open AI (Azure Open AI ) y seleccione Crear.
Rellene los detalles necesarios y seleccione Siguiente.
Seleccione Todas las redes, incluido Internet, para acceder a este recurso y, a continuación, seleccione Siguiente.
Rellene los detalles necesarios y seleccione Siguiente.
Seleccione Crear.

Ha creado correctamente la clave y el punto de conexión para el bot de chat de IA.

Nota:

También puede obtener la clave de API de OpenAI para depurar el bot de chat de IA. Para obtener más información, consulte Configuración de la clave de API.

Obtención de claves y puntos de conexión de Azure Open AI

Seleccione Ir a recursos.
Seleccione Claves y punto de conexión en el panel izquierdo y copie la clave y el punto de conexión. Puede copiar KEY 1 o KEY 2.

Guarde la clave y el punto de conexión para su uso adicional.
Seleccione Implementaciones de modelos en el panel izquierdo y seleccione Administrar implementaciones.

Aparece la ventana Azure Open AI Studio.
Seleccione Implementaciones en el panel izquierdo y seleccione + Crear nuevas implementaciones.
Seleccione los detalles siguientes:
1. Seleccione gpt-35-turbo en la lista desplegable Seleccionar un modelo .
  
  Nota:
  
  Solo se admite el modelo gpt-35-turbo para el bot de chat de IA.
2. Seleccione 0301 (valor predeterminado) en la lista desplegable Versión del modelo .
3. Escriba El nombre de la implementación y seleccione Crear.
Copie y guarde el nombre de la implementación para su uso posterior.

Actualización de la clave y los puntos de conexión de Azure Open AI

Abra el proyecto en Visual Studio Code.
En EXPLORADOR, vaya al archivo env.env.testtool.user>.

Escriba su SECRET_AZURE_OPENAI_API_KEY y SECRET_AZURE_OPENAI_ENDPOINT.

...
SECRET_AZURE_OPENAI_API_KEY=<azure-openai-api-key>
SECRET_AZURE_OPENAI_ENDPOINT=<azure-openai-endpoint>

Vaya a src>app.js archivo.
Comente el OpenAI código y quite la marca de comentario del Azure OpenAI código.

Escriba el nombre de la implementación de Azure Open AI en azureDefaultDeployment.

...
// Use OpenAI
// apiKey: config.openAIKey,
// defaultModel: "gpt-3.5-turbo",

azureApiKey: config.azureOpenAIKey,
azureDefaultDeployment: "gpt-35-turbo",
azureEndpoint: config.azureOpenAIEndpoint,
...

Depuración y ejecución de la aplicación de bot de chat de IA

En el panel izquierdo, seleccione EJECUTAR y DEPURAR (Ctrl+Mayús+D) y seleccione Depurar en herramienta de prueba (versión preliminar) en la lista desplegable.
La herramienta de prueba abre el bot de chat de IA en una página web.

Desencadenadores de actividad

3 minutos restantes

Puede simular una actividad en la herramienta de prueba mediante desencadenadores de actividad. Hay dos tipos de desencadenadores de actividad:

Desencadenadores de actividad predefinidos
Desencadenadores de actividad personalizados

Desencadenadores de actividad predefinidos

La herramienta de prueba proporciona desencadenadores de actividad predefinidos para probar las funcionalidades del bot.

Categoría	Actividad	Controlador
Actividad de actualización de instalación del desencadenador	Instalación del bot Desinstalar bot	`onInstallationUpdate` `onInstallationUpdateAdded` `onInstallationUpdate` `onInstallationUpdateRemove`
Desencadenar actividad de actualización de conversación	Agregar usuario Agregar bot Agregar canal	`onMembersAdded` `onTeamsMembersAddedEvent` `onMembersAdded` `onTeamsMembersAddedEvent` `onTeamsChannelCreatedEvent`
	Quitar usuario Eliminación del bot Quitar canal Quitar equipo	`onMembersRemoved` `onTeamsMembersRemovedEvent` `onMembersRemoved` `onTeamsMembersRemovedEvent` `onTeamsChannelDeletedEvent` `onTeamsTeamDeletedEvent`
	Cambiar el nombre del canal Cambiar el nombre del equipo	`onTeamsChannelRenamedEvent` `onTeamsTeamRenamedEvent`

Nota:

Todos los tipos de actividades no están disponibles en todos los ámbitos. Por ejemplo, no puede agregar ni quitar un canal en un chat personal o un chat de grupo.

Los desencadenadores de actividad predefinidos están disponibles en el menú Simular una actividad de la Herramienta de prueba.

Para simular una actividad Agregar usuario , siga estos pasos:

En Herramienta de prueba, vaya a Simular unusuario de adiciónde actividad>.

Aparece un cuadro de diálogo para obtener una vista previa del controlador de actividad.
Seleccione Enviar actividad.

El bot envía la siguiente respuesta:

Desencadenadores de actividad personalizados

Puede usar la actividad Personalizada para personalizar los desencadenadores de actividad, por ejemplo, reactionsAdded para cumplir los requisitos de la aplicación de bot. La herramienta de prueba rellena automáticamente las propiedades necesarias de la actividad. También puede modificar el tipo de actividad y agregar más propiedades.

Seleccione Simular unaactividad personalizada de actividad>.

Agregue messageReaction para personalizar la actividad en la type propiedad :

{
  "type": "messageReaction",
  "reactionsAdded": [
    {
      "type": "like"
    }
  ],
  "replyToId": "d60fd1cb-3e8f-44ef-849c-404806ba1b47"
}

Seleccione Enviar actividad.

El bot envía un onReactionsAdded controlador en respuesta.

Desafío completo

2 minutos restantes

¿Se le ocurrió una salida así?

Enhorabuena.

100 % completado.

Ha creado correctamente una aplicación de bot de chat de IA. Ahora, ha aprendido a depurar la aplicación de bot de chat de inteligencia artificial en La herramienta de prueba de aplicaciones de Teams.

Compartir a través de

Depuración del bot de chat de IA mediante la herramienta de prueba de aplicaciones de Teams