Compartir a través de

Guía de inicio rápido de la biblioteca de inteligencia artificial de Teams

  • Artículo

Empiece a trabajar con la biblioteca de inteligencia artificial de Teams mediante el ejemplo LightBot, que está diseñado para ayudarle a través del proceso de creación de aplicaciones que pueden controlar las luces, como activarlas y desactivarlas mediante la biblioteca de inteligencia artificial de Teams. El bot usa el modelo gpt-3.5-turbo para chatear con los usuarios de Microsoft Teams y responder de forma educada y respetuosa, manteniéndose dentro del ámbito de la conversación.

Requisitos previos

Para empezar, asegúrese de que tiene las herramientas siguientes:

Instalar Para usar...
Visual Studio Code Entornos de compilación de JavaScript, TypeScript y Python. Use la versión más reciente.
Kit de herramientas de Teams Microsoft Visual Studio Code extensión que crea un scaffolding de proyecto para la aplicación. Use la versión más reciente.
Git Git es un sistema de control de versiones que le ayuda a administrar diferentes versiones de código dentro de un repositorio.
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.
Microsoft Teams Para colaborar con todos, trabaja con aplicaciones para chat, reuniones y llamadas a todo en un solo lugar.
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 Microsoft Azure, debe crear un servicio Azure OpenAI.
Microsoft Edge (recomendado) o Google Chrome Un explorador con herramientas de desarrollo.
Cuenta de desarrollador de Microsoft 365 Acceso a la cuenta de Teams con los permisos adecuados para instalar una aplicación, habilitar aplicaciones personalizadas de Teams y activar la carga de aplicaciones personalizadas.

Si ya ha ejecutado los ejemplos antes o ha encontrado un error en tiempo de ejecución, siga estos pasos para empezar de nuevo:
  • Compruebe todos los .env archivos y env/.env.*.* del ejemplo y elimine los valores rellenados automáticamente para asegurarse de que Teams Toolkit genera nuevos recursos automáticamente.
  • Si no desea que teams Toolkit genere el identificador de aplicación y la contraseña, actualice y BOT_IDBOT_PASSWORD en el .env archivo con sus propios valores.
  • Quite los valores o deje los valores en blanco para SECRET_BOT_PASSWORD y TEAMS_APP_UPDATE_TIME en el .env archivo para evitar conflictos.

El kit de herramientas de Teams aprovisiona y BOT_PASSWORD recursos BOT_ID automáticamente. Si desea usar sus propios recursos, debe agregarlos manualmente al .env archivo. Teams Toolkit no genera automáticamente los siguientes recursos:

  • Una clave OpenAI o OpenAI de Azure
  • Una base de datos o opciones de almacenamiento similares

Compilación y ejecución de la aplicación de ejemplo

Introducción a la biblioteca de inteligencia artificial de Teams mediante el ejemplo LightBot. Permite al host local del equipo ejecutar rápidamente un ejemplo basado en biblioteca de IA de Teams.

  1. Vaya al ejemplo.

  2. Ejecute el siguiente comando para clonar el repositorio:

    git clone https://github.com/microsoft/teams-ai.git

  3. Ve a Visual Studio Code.

  4. Seleccione Archivo>Abrir carpeta.

  5. Vaya a la ubicación donde clonó el repositorio teams-ai y seleccione la carpeta teams-ai .

  6. Seleccione Seleccionar carpeta.

    Captura de pantalla que muestra la carpeta teams-ai y la opción Seleccionar carpeta.

  7. Seleccione Ver>terminal. Se abre una ventana de terminal.

  8. En la ventana del terminal, ejecute el siguiente comando para ir a la carpeta js :

    cd .\js\

  9. Ejecute el siguiente comando para instalar dependencias:

    yarn install

  10. Ejecute el siguiente comando para compilar dependencias:

    yarn build

  11. Una vez instaladas las dependencias, seleccione Abrir>carpeta.

  12. Vaya a teams-ai > js > samples> 03.ai-concepts> c.actionMapping-lightBot y seleccione Seleccionar carpeta. Todos los archivos del ejemplo LightBot aparecen en la sección EXPLORER de Visual Studio Code.

  13. Actualice los pasos siguientes en función de los servicios de inteligencia artificial que seleccione.

    1. Vaya a la env carpeta y actualice el código siguiente en el ./env/.env.local.user archivo:

       SECRET_OPENAI_KEY=<your OpenAI key>

    2. Vaya a la infra carpeta y asegúrese de que se comentan las líneas siguientes del azure.bicep archivo:

          // {
    //   name: 'AZURE_OPENAI_KEY'
    //   value: azureOpenAIKey
    // }
    // {
    //   name: 'AZURE_OPENAI_ENDPOINT'
    //   value: azureOpenAIEndpoint
    // }

  14. En el panel izquierdo, seleccione Kit de herramientas de Teams.

  15. En CUENTAS, inicie sesión en lo siguiente:

    • Cuenta de Microsoft 365
    • Cuenta de Azure

  16. Para depurar la aplicación, seleccione la tecla F5 .

    Una pestaña del explorador abre un cliente web de Teams que solicita agregar el bot al inquilino.

  17. Seleccione Agregar.

    Captura de pantalla que muestra cómo agregar la aplicación LightBot.

    Se abre una ventana de chat.

  18. En el área de redacción de mensajes, envíe un mensaje para invocar el bot.

    Captura de pantalla que muestra un ejemplo de la salida de LightBot.

Nota:

Si va a compilar un bot por primera vez, se recomienda usar la extensión del kit de herramientas de Teams para Visual Studio Code para compilar un bot, consulte Compilación de la primera aplicación de bot mediante JavaScript.

Requisitos previos

Para empezar, asegúrese de que tiene las herramientas siguientes:

Instalar Para usar...
Visual Studio Entornos de compilación de C Sharp. Use la versión más reciente.
Kit de herramientas de Teams Microsoft Visual Studio Code extensión que crea un scaffolding de proyecto para la aplicación. Use la versión más reciente.
Git Git es un sistema de control de versiones que le ayuda a administrar diferentes versiones de código dentro de un repositorio.
Microsoft Teams Para colaborar con todos, trabaje con a través de aplicaciones para chat, reuniones y llamadas a todos en un solo lugar.
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 Microsoft Azure, debe crear un servicio Azure OpenAI.
Microsoft Edge (recomendado) o Google Chrome Un explorador con herramientas de desarrollo.
Cuenta de desarrollador de Microsoft 365 Acceso a la cuenta de Teams con los permisos adecuados para instalar una aplicación, habilitar aplicaciones personalizadas de Teams y activar la carga de aplicaciones personalizadas.

Si ya ha ejecutado los ejemplos antes o ha encontrado un error en tiempo de ejecución, siga estos pasos para empezar de nuevo:
  • Compruebe todos los .env archivos y env/.env.*.* del ejemplo y elimine los valores rellenados automáticamente para asegurarse de que Teams Toolkit genera nuevos recursos automáticamente.
  • Si no desea que teams Toolkit genere el identificador de aplicación y la contraseña, actualice y MicrosoftAppIdMicrosoftAppPassword en el .env archivo con sus propios valores.
  • Quite los valores o deje los valores en blanco para SECRET_BOT_PASSWORD y TEAMS_APP_UPDATE_TIME en el .env archivo para evitar conflictos.

El kit de herramientas de Teams aprovisiona y MicrosoftAppPassword recursos MicrosoftAppId automáticamente. Si desea usar sus propios recursos, debe agregarlos manualmente al .env archivo. Teams Toolkit no genera automáticamente los siguientes recursos:

  • Una clave OpenAI o OpenAI de Azure
  • Una base de datos o opciones de almacenamiento similares

Compilación y ejecución de la aplicación de ejemplo

  1. Vaya al ejemplo.

  2. Clone el repositorio para probar la aplicación de ejemplo.

    git clone https://github.com/microsoft/teams-ai.git

  3. Vaya a la carpeta dotnet .

    cd teams-ai/dotnet

  4. Vaya a la carpeta donde ha clonado el repositorio y seleccione 04.ai.c.actionMapping.lightBot.

  5. Seleccione LightBot.sln. La solución se abre en Visual Studio.

  6. En Visual Studio, actualice la configuración relacionada con OpenAI en el appsettings.Development.json archivo.

    "Azure": {
"OpenAIApiKey": "<your-azure-openai-api-key>",
"OpenAIEndpoint": "<your-azure-openai-endpoint>"
},

  7. Vaya a Prompts/sequence/skprompt.txt y actualice el código siguiente en el skprompt.txt archivo:

    The following is a conversation with an AI assistant. 
The assistant can turn a light on or off.
The assistant must return the following JSON structure:

{"type":"plan","commands":[{"type":"DO","action":"<name>","entities":{"<name>":<value>}},{"type":"SAY","response":"<response>"}]}

The following actions are supported:

- LightsOn
- LightsOff
- Pause time=<duration in ms>
- LightStatus

The lights are currently {{getLightStatus}}.

Always respond in the form of a JSON based plan. Stick with DO/SAY.

  8. En el menú desplegable de depuración, seleccione Dev Tunnels>Create a Tunnel...

    Captura de pantalla que muestra un ejemplo de la opción Túnel de desarrollo y Crear un túnel en Visual Studio.

  9. Seleccione la cuenta que se va a usar para crear el túnel. Se admiten las cuentas de Azure, Microsoft Account (MSA) y GitHub. Actualice las siguientes opciones:

    1. Nombre: escriba un nombre para el túnel.
    2. Tipo de túnel: seleccione Persistente o Temporal.
    3. Acceso: seleccione Público.
    4. Seleccione Aceptar. Visual Studio muestra un mensaje de confirmación de que se crea un túnel.

    El túnel que ha creado aparece en Túneles > de desarrollo (nombre del túnel).

  10. Vaya a Explorador de soluciones y seleccione el proyecto.

  11. Haga clic con el botón derecho en el menú y seleccione Kit de herramientas> de TeamsPreparar dependencias de aplicaciones de Teams.

    Captura de pantalla que muestra un ejemplo de la opción Dependencias de aplicaciones preparadas de Teams en la sección Kit de herramientas de Teams en Visual Studio.

    Si se le solicita, inicie sesión en su cuenta de Microsoft 365. Recibirá un mensaje en el que se indica que las dependencias de la aplicación de Teams están preparadas correctamente.

  12. Seleccione Aceptar.

  13. Seleccione F5 o seleccione Depurar>inicio.

  14. Seleccione Agregar. La aplicación se agrega a Teams y se abre una ventana de chat.

    Captura de pantalla que muestra cómo agregar la aplicación LightBot.

  15. En el área de redacción de mensajes, envíe un mensaje para invocar el bot.

    Captura de pantalla que muestra un ejemplo de la salida de LightBot.

También puede implementar los ejemplos en Azure mediante el kit de herramientas de Teams. Para realizar la implementación, siga estos pasos:

  1. En Visual Studio, vaya a Explorador de soluciones y seleccione el proyecto.
  2. Haga clic con el botón derecho en el menú y seleccione Aprovisionamiento del kit de herramientas> de Teamsen la nube. El kit de herramientas aprovisiona el ejemplo en Azure.
  3. Haga clic con el botón derecho en el menú y seleccione Teams Toolkit>Deploy to the Cloud (Implementar en la nube).

Requisitos previos

Para empezar, asegúrese de que tiene las herramientas siguientes:

Instalar Para usar...
Visual Studio Code Entornos de compilación de JavaScript, TypeScript y Python. Use la versión más reciente.
Kit de herramientas de Teams Microsoft Visual Studio Code extensión que crea un scaffolding de proyecto para la aplicación. Use la versión más reciente.
Python Python es un lenguaje de programación interpretado y orientado a objetos con semántica dinámica. Use versiones entre 3.8 y 4.0.
Poesía Herramienta de empaquetado y administración de dependencias para Python.
Extensión VSCode de Python Proporciona compatibilidad enriquecida con Python en VSCode.
Git Git es un sistema de control de versiones que le ayuda a administrar diferentes versiones de código dentro de un repositorio.
Microsoft Teams Para colaborar con todos, trabaje con a través de aplicaciones para chat, reuniones y llamadas a todos en un solo lugar.
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 Microsoft Azure, debe crear un servicio Azure OpenAI.
Microsoft Edge (recomendado) o Google Chrome Un explorador con herramientas de desarrollo.
Cuenta de desarrollador de Microsoft 365 Acceso a la cuenta de Teams con los permisos adecuados para instalar una aplicación, habilitar aplicaciones personalizadas de Teams y activar la carga de aplicaciones personalizadas.

Si ya ha ejecutado los ejemplos antes o ha encontrado un error en tiempo de ejecución, siga estos pasos para empezar de nuevo:
  • Compruebe todos los .env archivos y env/.env.*.* del ejemplo y elimine los valores rellenados automáticamente para asegurarse de que Teams Toolkit genera nuevos recursos automáticamente.
  • Si no desea que teams Toolkit genere el identificador de aplicación y la contraseña, actualice y BOT_IDBOT_PASSWORD en el .env archivo con sus propios valores.
  • Quite los valores o deje los valores en blanco para SECRET_BOT_PASSWORD y TEAMS_APP_UPDATE_TIME en el .env archivo para evitar conflictos.

El kit de herramientas de Teams aprovisiona y BOT_PASSWORD recursos BOT_ID automáticamente. Si desea usar sus propios recursos, debe agregarlos manualmente al .env archivo. Teams Toolkit no genera automáticamente los siguientes recursos:

  • Una clave OpenAI o OpenAI de Azure
  • Una base de datos o opciones de almacenamiento similares

Compilación y ejecución de la aplicación de ejemplo

  1. Vaya al ejemplo.

  2. Clone el repositorio para probar la aplicación de ejemplo.

    git clone https://github.com/microsoft/teams-ai.git

  3. Vaya a la carpeta python .

    cd teams-ai/python

  4. Vaya a la carpeta donde ha clonado el repositorio y seleccione 04.ai.c.actionMapping.lightBot. Todos los archivos del ejemplo LightBot aparecen en la sección EXPLORER de Visual Studio Code.

  5. En EXPLORADOR, duplique el archivo sample.env y actualice el archivo duplicado a .env.

    Vaya a la env carpeta y actualice el código siguiente en el ./env/.env.local.user archivo:

    SECRET_OPENAI_KEY=<your OpenAI key>

  6. Para instalar las siguientes dependencias, vaya a Ver>terminal y ejecute los siguientes comandos:

    Dependencias Get-Help
    python-dotenv pip install python-dotenv
    load-dotenv pip install load-dotenv
    teams-ai pip install teams-ai
    botbuilder-core pip install botbuilder-core

  7. Actualice config.json y bot.py con el nombre de implementación del modelo.

  8. Vaya a Ver>paleta de comandos... o seleccione Ctrl+Mayús+P.

  9. Escriba Python: Crear entorno para crear un entorno virtual.

  10. Para depurar la aplicación, seleccione la tecla F5 .

    Una pestaña del explorador abre un cliente web de Teams que solicita agregar el bot al inquilino.

  11. Seleccione Agregar.

    Captura de pantalla que muestra cómo agregar la aplicación LightBot.

    Se abre una ventana de chat.

  12. En el área de redacción de mensajes, envíe un mensaje para invocar el bot.

    Captura de pantalla que muestra un ejemplo de la salida de LightBot.

Herramientas adicionales

También puede usar las siguientes herramientas para ejecutar y configurar un ejemplo:

  1. CLI del kit de herramientas de Teams: puede usar la CLI del kit de herramientas de Teams para crear y administrar aplicaciones de Teams desde la línea de comandos. Para obtener más información, consulte Instrucciones de configuración de la CLI del kit de herramientas de Teams.

  2. Bot Framework Emulator: el Bot Framework Emulator es una aplicación de escritorio que permite probar y depurar el bot localmente. Para conectarse al bot, escriba la dirección URL del punto de conexión del bot, el identificador y la contraseña de la aplicación de Microsoft. A continuación, puede enviar mensajes al bot y ver sus respuestas en tiempo real. Para obtener más información, consulte Bot Framework Emulator instrucciones de configuración.

  3. Configuración manual: si prefiere configurar los recursos manualmente, puede hacerlo siguiendo las instrucciones proporcionadas por los servicios respectivos. Para obtener más información, consulte instrucciones de configuración manual.

Paso siguiente

Preguntas más frecuentes sobre la biblioteca de inteligencia artificial de Teams