Depuración de un bot primero en el SDK

SE APLICA A: SDK v4

En este artículo se describe cómo depurar el bot mediante un IDE, como Visual Studio o Visual Studio Code, y Bot Framework Emulator. Usa estos métodos para depurar un bot localmente. En este artículo se usa un bot de eco, como el creado en el inicio rápido Creación de un bot.

Nota:

En este artículo, se usa Bot Framework Emulator para enviar y recibir mensajes desde el bot durante la depuración. Si buscas otras maneras de depurar el bot mediante Bot Framework Emulator, lee el artículo Depuración con Bot Framework Emulator.

Nota:

Para crear agentes con su elección de servicios de inteligencia artificial, orquestación y conocimientos, considere la posibilidad de usar el SDK de agentes de Microsoft 365. El SDK de agentes admite C#, JavaScript o Python. Puede obtener más información sobre el SDK de agentes en aka.ms/agents. Si busca una plataforma de agente basada en SaaS, considere Microsoft Copilot Studio. Si tiene un bot existente creado con Bot Framework SDK, puede actualizar el bot al SDK de agentes. Puede revisar los cambios principales y las actualizaciones en la guía de migración del Bot Framework SDK al SDK de Agentes. Las incidencias de soporte técnico del SDK de Bot Framework ya no se atenderán a partir del 31 de diciembre de 2025.

Requisitos previos

• Descargue e instale el emulador de Bot Framework.
• Descarga e instala Visual Studio Code o Visual Studio.

C#

Establecer puntos de interrupción de C# en Visual Studio Code

En Visual Studio Code, se pueden establecer puntos de interrupción y ejecutar el bot en modo de depuración para recorrer el código. Para establecer puntos de interrupción en Visual Studio Code, sigue estos pasos:

1. Inicia Visual Studio Code y abre la carpeta del proyecto de bot.

2. Establezca puntos de interrupción según sea necesario. Para establecer un punto de interrupción, mantén el ratón sobre la columna a la izquierda de los números de línea. Aparecerá un pequeño punto de color rojo. Si selecciona el punto, se establece el punto de interrupción. Si vuelve a seleccionarlo, el punto de interrupción se quita.

   

3. En la barra de menús, selecciona Ejecutar y, a continuación, Iniciar depuración. El bot comenzará a ejecutarse en modo de depuración desde el terminal en Visual Studio Code.

4. Inicia Bot Framework Emulator y conéctate al bot como se describe en Depuración con Bot Framework Emulator.

5. Desde Emulator, envía un mensaje al bot (por ejemplo, envía el mensaje "Hola"). La ejecución se detendrá en la línea donde ha colocado el punto de interrupción.

   

Establece puntos de interrupción de C# en Visual Studio

En Visual Studio puedes establecer puntos de interrupción y ejecutar el bot en modo de depuración para recorrer el código. Para establecer puntos de interrupción en Visual Studio, sigue estos pasos:

1. Navegue hasta la carpeta del bot y abra el archivo .sln. Se abrirá la solución en Visual Studio.

2. En la barra de menús, selecciona Compilar y después Compilar solución.

3. En el Explorador de soluciones, seleccione el archivo .cs y establezca puntos de interrupción según sea necesario. Este archivo define la lógica principal del bot. Para establecer un punto de interrupción, mantén el ratón sobre la columna a la izquierda de los números de línea. Aparecerá un pequeño punto. Si selecciona el punto, se establece el punto de interrupción. Si vuelve a seleccionarlo, el punto de interrupción se quita.

   

4. En el menú, selecciona Depurar y, a continuación, Iniciar depuración. En este momento, el bot se ejecuta de forma local.

5. Inicie el emulador de Bot Framework y conéctese al bot como se describe en la sección anterior.

6. En Emulator, envía un mensaje al bot, como "Hola". La ejecución se detendrá en la línea donde ha colocado el punto de interrupción.

   

JavaScript

Establece puntos de interrupción de JavaScript en Visual Studio Code

En Visual Studio Code, se pueden establecer puntos de interrupción y ejecutar el bot en modo de depuración para recorrer el código. Para establecer puntos de interrupción en Visual Studio Code, sigue estos pasos:

1. Inicia Visual Studio Code y abre la carpeta del proyecto de bot.

2. En la barra de menús, selecciona Depurar y, después, Iniciar depuración. Si se te pide que selecciones un motor de tiempo de ejecución para ejecutar el código, selecciona Node.js. En este momento, el bot se ejecuta de forma local.

3. Seleccione el archivo .js y establezca los puntos de interrupción según sea necesario. Para establecer un punto de interrupción, mantén el ratón sobre la columna a la izquierda de los números de línea. Aparecerá un pequeño punto de color rojo. Si selecciona el punto, se establece el punto de interrupción. Si vuelve a seleccionarlo, el punto de interrupción se quita.

   

4. Inicie Bot Framework Emulator y conéctese al bot como se describe en el artículo Depuración con Bot Framework Emulator.

5. Desde Emulator, envía un mensaje al bot (por ejemplo, envía el mensaje "Hola"). La ejecución se detendrá en la línea donde ha colocado el punto de interrupción.

   

Java

Establece puntos de interrupción en Visual Studio Code

En Visual Studio Code, se pueden establecer puntos de interrupción y ejecutar el bot en modo de depuración para recorrer el código. Consulta también Creación de un bot con Bot Framework SDK para Java.

1. Si todavía no lo has hecho, instala el paquete de extensión de Java en Visual Studio Code. Esta extensión proporciona una amplia compatibilidad con Java en Visual Studio Code, incluida la depuración.

2. Inicia Visual Studio Code y abre la carpeta del proyecto de bot.

3. Establezca puntos de interrupción según sea necesario. Para establecer un punto de interrupción, mantén el ratón sobre la columna a la izquierda de los números de línea. Aparecerá un pequeño punto de color rojo. Si selecciona el punto, se establece el punto de interrupción. Si vuelve a seleccionarlo, el punto de interrupción se quita.

   

4. Selecciona el archivo EchoBot.java y agrega un punto de interrupción a una ubicación deseada.

5. En la barra de menús, selecciona Ejecutar y, después, Iniciar depuración.

6. Selecciona Java si se te pide que depures el archivo seleccionado actualmente.

7. Inicie Bot Framework Emulator y conéctese al bot como se describe en el artículo Depuración con Bot Framework Emulator.

8. Desde Emulator, envía un mensaje al bot (por ejemplo, envía el mensaje "Hola"). La ejecución se detendrá en la línea donde ha colocado el punto de interrupción.

   

Para más información, consulte Ejecución y depuración en Java.

Pitón

Establece puntos de interrupción de Python en Visual Studio Code

En Visual Studio Code, se pueden establecer puntos de interrupción y ejecutar el bot en modo de depuración para recorrer el código. Consulte también Creación de un bot con Bot Framework SDK para Python.

1. Instala la extensión de Python en Visual Studio Code si todavía no lo has hecho. Esta extensión proporciona una amplia compatibilidad con Python en Visual Studio Code, incluida la depuración.

2. Inicia Visual Studio Code y abre la carpeta del proyecto de bot.

3. Establezca puntos de interrupción según sea necesario. Para establecer un punto de interrupción, mantén el ratón sobre la columna a la izquierda de los números de línea. Aparecerá un pequeño punto de color rojo. Si selecciona el punto, se establece el punto de interrupción. Si vuelve a seleccionarlo, el punto de interrupción se quita.

   

4. Seleccione el archivo app.py.

5. En la barra de menús, selecciona Depurar y, después, Iniciar depuración.

6. Seleccione Archivo de Python para depurar el archivo seleccionado actualmente.

7. Inicie Bot Framework Emulator y conéctese al bot como se describe en el artículo Depuración con Bot Framework Emulator.

8. Desde Emulator, envía un mensaje al bot (por ejemplo, envía el mensaje "Hola"). La ejecución se detendrá en la línea donde ha colocado el punto de interrupción.

   

Para más información, consulte Depuración de código Python.

Recursos adicionales

• Solución de problemas al configurar el bot y otros artículos de solución de problemas en esa sección.
• Depuración con el emulador.

Pasos siguientes

Depuración del bot mediante archivos de transcripción.