Configuración guiada por IA para Agent 365

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 CLI de Azure 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 la suscripción de Azure para los grupos de recursos existentes, los planes de App Service y la información del usuario y, a continuación, usa esos valores como sugerencias al recopilar entradas 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 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.
• CLI de Azure: necesario para la autenticación y la administración de recursos. Install CLI de Azure.

Cuentas y permisos requeridos

• Suscripción de Azure con acceso de contribuyente
• Microsoft Entra tenant con uno de los siguientes roles:
  • Administrador global
  • Administrador de ID de Agente
  • Desarrollador de Identificación 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 en funcionamiento (Python, Node.js o .NET) que desea desplegar. 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 . 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 , , o 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.

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 indicación corta. 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 CLI de Azure 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 autohospedada, recopila valores de configuración, deriva nombres de recursos y crea el archivo a365.config.json.
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 personalizada — Tu ID de aplicación cliente para el registro de la aplicación cliente personalizada.
• 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, el blueprint y el principal de usuario.
• Revisión del manifiesto — Confirma que tu manifiesto esté actualizado con el nombre de tu agente, la descripción y la información del desarrollador.

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:

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 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 archivo, puedes hacerlo:

• Edita el archivo directamente y vuelve a ejecutarlo
• Pide al agente de IA que actualice valores específicos

Pasos siguientes