Configurar el entorno de desarrollo
Antes de codificar el agente, asegúrese de que el entorno está preparado con las herramientas y credenciales necesarias. Visual Studio Code con la extensión Microsoft 365 Agents Toolkit es la configuración recomendada para el desarrollo pro-código.
• Instale Visual Studio Code y M365 Agents Toolkit: en Visual Studio Code, instale la extensión Microsoft 365 Agents Toolkit (anteriormente conocida como Kit de herramientas de Teams). Esto proporciona plantillas de proyecto y comandos integrados para aplicar scaffolding, depurar e implementar el agente. Asegúrese de que tiene la versión más reciente.
• Lenguaje de & en tiempo de ejecución: configure el entorno de ejecución adecuado para el idioma elegido. Para JavaScript o TypeScript, instale la última Node.js LTS (v16+), ya que el bot se ejecuta en Node.js en tiempo de ejecución. Para C#, instale el SDK de .NET 6 o .NET 7 (el SDK de agentes para .NET se ejecuta en .NET 6+). La compatibilidad de Python con el SDK de Agents está en versión preliminar, pero si la usa, asegúrese de que tiene un entorno de Python 3.10+ .
• Microsoft Teams (Pruebas): tener Microsoft Teams disponible (aplicación de escritorio o web). Probará el bot en Teams, por lo que es importante iniciar sesión en un inquilino donde pueda cargar aplicaciones personalizadas. Si su cuenta profesional no permite la carga de aplicaciones personalizadas, configure un inquilino gratuito de Microsoft 365 Developer (suscripción para desarrolladores E5) que le proporcione a Teams permisos de instalación local.
• Suscripción de Azure & OpenAI: configure el acceso a un servicio OpenAI de Azure u obtenga claves de API de OpenAI, porque nuestro agente usa un LLM. En Azure, cree un recurso de OpenAI e implemente un modelo (por ejemplo, GPT-3.5 Turbo o GPT-4): anote el nombre de la implementación, la dirección URL del punto de conexión y la clave de API. Como alternativa, obtenga una clave de API de OpenAI directamente desde OpenAI. Esto lo usará el bot para llamar al modelo de lenguaje. Sugerencia: Si usa Azure OpenAI, es posible que también desee un recurso de Azure Cognitive Search u otro origen de datos para RAG, pero es opcional al principio.
• cuenta de Entra ID (Azure AD): necesita una cuenta de identificador de Microsoft Entra (Azure AD) en el inquilino donde se registrará el bot. Normalmente, es suficiente iniciar sesión con la cuenta de administrador de inquilinos para desarrolladores 365 en el kit de herramientas de VS Code. El kit de herramientas lo usará para crear el registro de aplicaciones de Azure AD y el manifiesto de aplicación de Teams para el bot. Asegúrese de que esta cuenta tiene permisos para registrar aplicaciones o es un administrador de Teams para cargar la aplicación.
• Opcionalmente, herramientas de la CLI: El kit de herramientas de agentes también proporciona una CLI (m365agents-cli) que puede automatizar el aprovisionamiento y la implementación a través de scripts. Esto no es necesario en VS Code, pero puede instalarlo a través de npm install -g @microsoft/m365agents-cli si tiene previsto usar CI/CD o hacer cosas fuera de VS Code. Una vez que se haya implementado lo anterior, inicie VS Code y compruebe que ve el icono "Microsoft 365 Agents Toolkit" (Kit de herramientas de agentes de Microsoft 365). Inicie sesión en su cuenta de 365 a través del kit de herramientas cuando se le solicite. Ya está listo para crear un proyecto. Los ejercicios de esta ruta de aprendizaje le guiarán por ese proceso.