Compartir a través de


Depuración en el cliente de escritorio de Teams

Microsoft 365 Agents Toolkit (anteriormente conocido como Kit de herramientas de Teams) le ayuda a depurar y obtener una vista previa de la aplicación de Microsoft Teams en el cliente de escritorio. Durante el proceso de depuración, Agents Toolkit inicia automáticamente app services, abre depuradores y carga la aplicación Teams. Puede obtener una vista previa de la aplicación de Teams en el cliente de escritorio de Teams después de la depuración.

A continuación se muestran las ventajas del cliente de escritorio de Teams:

  • Mejora el rendimiento.
  • Reduce el tiempo a F5.
  • Mejora la cobertura de destinos de depuración.

Funcionalidades del cliente de escritorio de Teams

El cliente de escritorio de Teams incorpora funcionalidades de depuración en las siguientes plantillas de aplicación con scaffolding de Agents Toolkit:

  • Bot.
  • Agente.
  • Agente de motor personalizado.
  • Extensión de mensaje.

Requisitos previos

Asegúrese de instalar las siguientes herramientas para compilar e implementar la aplicación en el cliente de escritorio de Teams:

  Instalar Para usar...
  Kit de herramientas de agentes de Microsoft 365 Extensión de Microsoft Visual Studio Code que crea un scaffolding de proyecto para la aplicación. Use la versión preliminar más reciente.
  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.
  Visual Studio Code Entornos de compilación de JavaScript, TypeScript o SharePoint Framework (SPFx). Use la versión más reciente.
  Cuenta de desarrollador de Microsoft 365 Acceso a la cuenta de Teams con los permisos adecuados para instalar una aplicación.

Depuración en el cliente de escritorio de Teams

Para depurar la aplicación de agente de motor personalizada en el cliente de escritorio de Teams

  1. Abra Visual Studio Code (VS Code) e inicie sesión en su cuenta de Microsoft 365 a través de Agents Toolkit.

  2. Abra el agente de Teams o el proyecto de aplicación.

    Para obtener más información sobre cómo crear un nuevo agente o aplicación, consulte Compilación de su primer agente o aplicaciones en Teams.

  3. En el panel izquierdo, seleccione Ejecutar y depurar (Ctrl+Shift+D) y seleccione Depurar en Teams (escritorio) en la lista desplegable.

    Captura de pantalla que muestra la opción para seleccionar la depuración en Teams (escritorio).

  4. Asegúrese de que el inicio de sesión de escritorio de Teams coincide con la cuenta de Microsoft 365 que se usa en agents toolkit y, a continuación, seleccione Continuar.

    Captura de pantalla que muestra el inicio de sesión del escritorio.

    Solicitudes de cliente de escritorio de Teams para agregar la aplicación.

  5. Seleccione Agregar.

    Captura de pantalla que muestra el botón Agregar para agregar la aplicación al cliente de escritorio de Teams.

    Se abre una ventana de chat.

  6. Desde el área de redacción del mensaje, envíe un mensaje para invocar el bot.

    Captura de pantalla que muestra la aplicación agregada al cliente de escritorio de Teams.

    Nota:

    La notificación de nivel de sistema para la coincidencia de cuentas solo aparece una vez por proyecto. En sesiones de depuración posteriores, Agents Toolkit envía recordatorios sobre la cuenta a través de notificaciones de VS Code.

    Captura de pantalla que muestra la notificación de inicio de sesión de escritorio posterior en vs code.

  7. Puede agregar puntos de interrupción y volver a cargar los cambios en caliente. En el ejemplo siguiente, el punto de interrupción se resalta con el punto rojo junto al número de fila.

    Captura de pantalla que muestra un ejemplo de los puntos de interrupción de la aplicación.

    Captura de pantalla que muestra un ejemplo después de la recarga activa de una aplicación.

Puede seguir depurando la aplicación de agente de motor personalizada en el cliente de escritorio de Teams.

Vea también