Guía de inicio rápido para usar assistants API con la biblioteca de inteligencia artificial de Teams

Introducción al uso de OpenAI o Azure OpenAI Assistants API con la biblioteca de inteligencia artificial de Teams en el ejemplo de asistente tutor de matemáticas. En esta guía se usa la herramienta OpenAI Code Interpreter para ayudarle a crear una asistente especializada en matemáticas. 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 o C Sharp. Use la versión más reciente.
Kit de herramientas de agentes de Microsoft 365 (anteriormente conocido como 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, 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 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 Agents Toolkit genera nuevos recursos automáticamente.
• Si no desea que Agents Toolkit genere el identificador y la contraseña de la aplicación, 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 agentes aprovisiona y MicrosoftAppPassword recursos MicrosoftAppId automáticamente. Si desea usar sus propios recursos, debe agregarlos manualmente al .env archivo. Agents 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 de asistente tutor de matemáticas. 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.

   

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 > 04.ai-apps > d.assistants-mathBot y seleccione Seleccionar carpeta. Todos los archivos del ejemplo de asistente tutor matemático se enumeran en la sección EXPLORER de Visual Studio Code.

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

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

    Tecla OpenAI

    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>
       ASSISTANT_ID=<your Assistant ID>
       

    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
           // }
       

    Azure OpenAI

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

       SECRET_AZURE_OPENAI_KEY=<your Azure OpenAI key>
       SECRET_AZURE_OPENAI_ENDPOINT=<your Azure OpenAI Endpoint>
    

    1. Vaya al m365agents.local.yml archivo y modifique el último paso para usar variables de Azure OpenAI:

       - uses: file/createOrUpdateEnvironmentFile
       with:
          target: ./.env
          envs:
          BOT_ID: ${{BOT_ID}}
          BOT_PASSWORD: ${{SECRET_BOT_PASSWORD}}
          #OPENAI_KEY: ${{SECRET_OPENAI_KEY}}
          AZURE_OPENAI_KEY: ${{SECRET_AZURE_OPENAI_KEY}}
          AZURE_OPENAI_ENDPOINT: ${{SECRET_AZURE_OPENAI_ENDPOINT}}
       

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

           // {
           //   name: 'OPENAI_KEY'
           //   value: openAIKey
           // }
       

    3. Vaya a infra>azure.parameters.json y reemplace las líneas del 20 al 25 por el código siguiente:

             "azureOpenAIKey": {
             "value": "${{SECRET_AZURE_OPENAI_KEY}}"
             },
             "azureOpenAIEndpoint": {
             "value": "${{SECRET_AZURE_OPENAI_ENDPOINT}}"
             }
       

15. Copie el ejemplo en un directorio nuevo que no sea un subdirectorio de teams-ai.

16. En el panel izquierdo, seleccione Microsoft 365 Agents Toolkit.

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

    • Cuenta de Microsoft 365
    • Cuenta de Azure

18. 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.

19. Seleccione Agregar.

    

    Se abre una ventana de chat.

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

    

Nota:

Si va a compilar un bot por primera vez, se recomienda usar la extensión Agents Toolkit para Visual Studio Code para compilar un bot, consulte compilación de la primera aplicación de bot mediante JavaScript.

Herramientas adicionales

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

1. CLI de Microsoft 365 Agents Toolkit (anteriormente conocida como CLI del kit de herramientas de Teams): puede usar la CLI de Agents Toolkit para crear y administrar aplicaciones de Microsoft Teams desde la línea de comandos. Para obtener más información, consulte Instrucciones de configuración de la CLI de Agents Toolkit.

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

API de asistentes