Configuración guiada por IA para Agent 365

Importante

Debe formar parte del programa de versión preliminar Frontier para obtener acceso anticipado a Microsoft Agent 365. Frontier le conecta directamente con las innovaciones de inteligencia artificial más recientes de Microsoft. Las versiones preliminares de Frontier están sujetas a los términos de vista previa existentes en tus acuerdos con clientes. Dado que estas características siguen en desarrollo, su disponibilidad y funcionalidades pueden cambiar con el tiempo.

El ciclo de vida del agente 365 development implica varios pasos: instalar la CLI, configurar los requisitos previos, crear un plano técnico del agente, implementar código y publicar en el centro de administración de Microsoft 365. Cada paso tiene sus propios requisitos previos, comprobaciones de validación y puntos de decisión.

La configuración guiada por AI automatiza todo este flujo de trabajo mediante un agente de codificación de IA (como GitHub Copilot en VS Code) para ejecutar los pasos de ciclo de vida en su nombre. En lugar de navegar entre varias páginas de documentación y ejecutar comandos manualmente, proporcionas al agente de IA un único archivo de instrucciones que te guía por el proceso de forma interactiva.

Ventajas

La configuración guiada por IA ofrece varias ventajas frente al flujo de trabajo manual:

• Punto de entrada único — Un solo archivo de instrucciones sustituye la necesidad de navegar entre varias páginas de documentación. El agente de IA sigue los pasos en orden y gestiona las transiciones automáticamente.
• Validación de requisitos previos automática: el agente de IA valida que el Azure CLI está instalado y autenticado, que el registro de la aplicación cliente personalizada tiene los permisos correctos con el consentimiento del administrador y que las herramientas de compilación específicas del lenguaje están disponibles, todo antes de ejecutar los comandos de a365 CLI.
• Smart defaults and auto-detection — el agente de IA consulta su suscripción de Azure para los grupos de recursos existentes, los planes de servicio de aplicaciones y la información del usuario; luego utiliza esos valores como sugerencias al recopilar datos de configuración.
• Convenciones derivadas de nombres — Proporcionas un único nombre base para tu agente, y el agente de IA deriva todos los nombres de recursos relacionados (identidad, blueprint, nombre principal de usuario, aplicación web) usando patrones consistentes.
• Gestión de errores en línea — Cuando falla un comando, el agente de IA analiza el error, sugiere una solución y lo intenta de nuevo, en lugar de tener que buscar en la documentación de solución de problemas.
• Configuración no interactiva — El agente de IA crea el a365.config.json archivo directamente e lo importa, evitando problemas con asistentes CLI interactivos en entornos automatizados.

Prerrequisitos

Asegúrese de que dispone de los siguientes requisitos previos:

Herramientas necesarias

• Visual Studio Code con las extensiones GitHub Copilot y GitHub Copilot Chat instaladas. La configuración guiada por IA requiere un agente de codificación de IA con acceso a terminal.
• .NET 8.0 o posterior: necesario para la CLI del agente 365. Install .NET.
• Azure CLI: necesario para la autenticación y la administración de recursos. Install Azure CLI.

Cuentas y permisos requeridos

• Suscripción de Azure con acceso de colaborador
• Microsoft Entra tenant con uno de los roles siguientes:
  • Administrador global
  • Administrador de ID de Agente
  • Desarrollador de ID de Agente
• Registro personalizado de la aplicación client : la configuración guiada por IA valida este registro de la app, pero la app debe existir ya en tu tenant con los permisos requeridos y el consentimiento del administrador. Consulta Registro personalizado de aplicación cliente si necesitas crear una.

Código de agente requerido

• Un proyecto de agente operativo (Python, Node.js o .NET) que desea implementar. Si no tienes uno, empieza con uno de los ejemplos de inicio rápido.

Descarga el archivo de instrucciones de configuración

La configuración guiada por IA utiliza un archivo de instrucciones llamado a365-setup-instructions.md. El repositorio Agent365-devTools incluye este archivo.

Si clonaste el repositorio, el archivo está en:

Agent365-devTools/docs/agent365-guided-setup/a365-setup-instructions.md

Si no tiene clonado el repositorio, descargue el archivo directamente desde GitHub.

Ejecuta la configuración guiada por IA

Sigue estos pasos para iniciar la configuración guiada por IA en tu proyecto de agente.

Paso 1: Abre tu proyecto de agente en VS Code

Abra el directorio del proyecto del agente en Visual Studio Code. Este directorio contiene tu código de agente (por ejemplo, el directorio con tu package.json, *.csproj, o pyproject.toml archivo).

Paso 2: Abrir GitHub Copilot Chat en modo de agente

Abra el panel chat de GitHub Copilot y cambie al modo Agent. El modo de agente ofrece GitHub Copilot la capacidad de ejecutar comandos de terminal, leer archivos e interactuar con el proyecto: todas las funcionalidades necesarias para la configuración guiada por IA.

Importante

Debes usar el modo Agente (no el modo Preguntar o Editar). La configuración guiada por IA requiere la capacidad de ejecutar comandos de terminal e interactuar con tu entorno.

Paso 3: Adjunta el archivo de instrucciones y comienza

En la entrada de Copilot Chat, adjunte el archivo a365-setup-instructions.md y envíelo con una solicitud breve. Por ejemplo:

Follow the steps in #file:a365-setup-instructions.md

El agente de IA lee el archivo de instrucciones y comienza la configuración guiada. Crea una lista de tareas con cinco pasos y los recorre secuencialmente:

1. Verifica e instala la CLI del Agente 365 : comprueba la CLI, la instala o actualiza, y verifica que funciona.
2. Validate prerequisites - Confirma Azure CLI autenticación, valida el registro y los permisos personalizados de la aplicación cliente y comprueba que las herramientas de compilación están instaladas para el tipo de proyecto.
3. Configurar la CLI del Agente 365: Pregunta si desea una implementación hospedada en Azure o autoadministrada, recopila valores de configuración, deriva nombres de recursos y crea el archivo .
4. Provision resources: ejecuta a365 setup all para crear la infraestructura de Azure y el plano técnico del agente.
5. Publish and deploy: revisa el manifiesto, publica el agente en el centro de administración de Microsoft 365, implementa el código en Azure y proporciona instrucciones posteriores a la implementación.

Paso 4: Responder a las preguntas

El agente de IA se detiene en puntos específicos para recoger tu información:

• ID de aplicación cliente personalizado — ID de tu aplicación (cliente) para el registro personalizado de la aplicación cliente.
• tipo Deployment: si se crea una aplicación web de Azure (hospedada Azure) o se usa un punto de conexión existente (autohospedado).
• Valores de configuración: grupo de recursos, ubicación, nombre del agente, correo electrónico del administrador y plan de App Service (para Azure hospedado) o nombre del agente y correo electrónico del administrador (para autohospedado).
• Confirmación de valor derivado — Revisa los nombres generados automáticamente para la identidad del agente, la plantilla y el principal del usuario.
• Revisión del manifiesto — Confirma que manifest.json esté actualizado con el nombre de tu agente, la descripción y la información del desarrollador.

Sugerencia

El agente de IA muestra valores reales de la suscripción de Azure como ejemplos cuando solicita entradas de configuración. Puedes aceptar las sugerencias o aportar tus propios valores.

Paso 5: Completar tareas posteriores al despliegue

Una vez finalizados los comandos CLI, el agente de IA proporciona instrucciones para los pasos manuales que requieren interacción con el navegador:

1. Configura el agente en el Portal de Desarrolladores de Teams — Establece el tipo de agente y el ID del bot.
2. Crea una instancia de agente — Solicita una instancia a Teams y haz que un administrador la apruebe.
3. Prueba el agente — Envía mensajes a tu agente en Teams para verificar que funciona.

Para instrucciones detalladas sobre estos pasos posteriores al despliegue, véase Crear instancias de agente.

Lo que cubre la configuración guiada por IA

La configuración guiada por IA automatiza las siguientes etapas del ciclo de vida del desarrollo:

Fase del ciclo de vida	Lo que hace el agente de IA	Equivalente manual
Instalación de CLI	Instala o actualiza la CLI del Agente 365	Agente 365 CLI
Prerrequisitos	Valida Azure CLI, aplicación cliente personalizada, permisos y herramientas de compilación	Registro personalizado de la aplicación cliente
Configuración	Crea a365.config.json con valores validados	Configurar el Agente 365
Configuración de planos	Corre a365 setup all para crear infraestructuras y planos	Plano del agente de configuración
Despliegue	Ejecuta a365 deploy para compilar y desplegar código	Deploy agent to Azure
Publicación	Ejecuta a365 publish para registrar el agente en el centro de administración	Publicar el agente en el centro de administración de Microsoft

Nota:

La configuración guiada por IA no reemplaza la necesidad de construir primero el código de tu agente . Deberías tener un proyecto de agente funcional antes de empezar la configuración guiada. Para proyectos nuevos, empieza con un inicio rápido.

Solución de problemas

El agente de IA no ejecuta comandos de terminal

Si el agente de IA describe los comandos, pero no los ejecuta, asegúrese de que usa Agent modo en GitHub Copilot Chat. Los modos Preguntar y Editar no tienen acceso al terminal.

El agente de IA salta los pasos de validación

El archivo de instrucciones impone un orden estricto de pasos. Si el agente de IA parece saltarse un paso, recuérdale que siga las instrucciones desde el principio. Por ejemplo:

Please start from Step 1 in the setup instructions and work through each step in order.

Los comandos de la interfaz de línea de comandos (CLI) fallan con errores de permiso

Si a365 los comandos CLI fallan con errores de autorización, la causa más común es una pérdida o un registro incompleto de la aplicación cliente personalizada. El agente de IA valida este registro en el Paso 2, pero si te has saltado esa validación, vuelve atrás y ejecuta. Para la guía completa de configuración, consulta Registro personalizado de aplicaciones de cliente.

Los valores de configuración son incorrectos

Si necesitas cambiar los valores de configuración después de crear el a365.config.json archivo, puedes hacerlo:

• Edita el a365.config.json archivo directamente y vuelve a ejecutarlo a365 config init -c ./a365.config.json
• Pide al agente de IA que actualice valores específicos

Pasos siguientes

Infórmate sobre el ciclo de desarrollo del Agente 365

Crear instancias de agente