Habilidades de Agent 365 para la configuración guiada de agentes

Las Habilidades del Agente 365 proporcionan una ruta guiada para conectar a un agente existente con el Agente 365 desde un asistente de programación soportado. Indicas el resultado que quieres, como añadir observabilidad a este agente, y la habilidad identifica el proyecto, recopila los valores requeridos, realiza los cambios de integración y comprueba el resultado.

Las habilidades se ejecutan en todos los agentes de codificación, incluyendo Claude Code, GitHub Copilot CLI y VS Code agent mode.

Para instalar las habilidades y seguir el proceso de incorporación de tu agente, consulta Inicio rápido: Conectar un agente existente con el Agente 365.

Note

Las habilidades sustituyen el flujo de trabajo de configuración previo que usaba un archivo instructions.md.

Cuándo usar habilidades

Conectar un agente existente con la identidad empresarial, la observabilidad, las herramientas gobernadas y las notificaciones requiere varios pasos ordenados de configuración. Estos pasos incluyen instalar la CLI del Agente 365, validar los requisitos previos de Azure, registrar un plano, configurar recursos de Entra, cablear exportadores OpenTelemetry, conectar servidores del Protocolo de Contexto del Modelo (MCP) y probar localmente.

Las habilidades realizan esos pasos en el orden requerido para la ruta seleccionada y validan el proyecto resultante.

Cómo funciona una habilidad

Cada habilidad sigue el mismo flujo de trabajo:

  1. Indica el resultado que quieres.
  2. Permite identificar el stack del proyecto y la configuración existente.
  3. Proporciona los valores que solicita, como el modo de autenticación.
  4. Revisa el código, el manifiesto y los cambios de configuración que realiza.
  5. Confirma que el proyecto sigue construyéndose y que la integración funciona.

Habilidades disponibles de Agent 365

a365-setup es el punto de entrada. Después de validar los requisitos previos, te encamina por uno de dos caminos, y solo sigues ese camino:

  • Agente estándar. a365-setup delega a make-a365-agent. Utiliza esta ruta cuando el agente no necesite su propia cuenta de usuario. Un agente estándar se autentica con OBO o S2S, por lo que puede actuar para un usuario iniciado sesión o ejecutarse sin uno.
  • Compañero de equipo controlado por IA. a365-setup delega a make-ai-teammate, para un agente que necesita su propia cuenta de usuario. Un compañero de equipo de IA se autentica como ese usuario (Agentic-User). Esta ruta requiere el programa de vista previa Frontier.

Para elegir una ruta y un modo de autenticación, consulte Tipos de agentes y modos de autenticación.

Aptitud Purpose
a365-setup Instala la CLI del Agente 365, valida los prerrequisitos de Azure y detecta la pila de agentes. Para un agente estándar, pregunta si el agente se autentica con OBO o S2S. Luego delega a make-a365-agent o make-ai-teammate.
make-a365-agent Proporciona un agente estándar que no necesita cuenta de usuario propia. Registra el blueprint de identidad del agente en Microsoft Entra, crea una identidad de agente a partir de él y configura los permisos de Entra ID que el agente necesita: permisos delegados para OBO o permisos de aplicación para S2S. Then ofrece observabilidad y herramientas como complementos.
make-ai-teammate Transforma a un agente en un compañero de IA con su propia cuenta de usuario. Registra el blueprint de identidad del agente y crea una identidad de agente a partir de él, luego añade la capa de alojamiento, el enrutamiento de mensajes y las notificaciones. Requiere que a365-setup se haya ejecutado primero.
instrument-observability Conecta OpenTelemetry y el exportador de trazas de Agent 365 para que los spans del agente lleguen a Microsoft Defender, Microsoft Purview y el centro de administración de Microsoft 365. Soporta OBO, S2S y Agentic-User. Pide el tipo de agente y el modo de autenticación si a365-setup no los ha grabado ya.
a365-code-validator Valida y diagnostica una integración existente con Agent 365, incluyendo instrumentación, artefactos de Microsoft Entra, mensajería, acceso a herramientas y configuración relacionada. Solo lectura de forma predeterminada. Úsalo instrument-observability para añadir observabilidad desde cero.
add-workiq-tools Conecta servidores MCP de Work IQ, incluyendo Mail, Calendar y Word, para que el agente pueda leer y actuar sobre los datos de Microsoft 365. Requiere un modelo de permisos delegados y se omite automáticamente cuando el modo de autenticación es S2S.
purview-dlp-integration Añade comprobaciones de prevención de pérdida de datos (DLP) de Microsoft Purview antes de las llamadas al LLM del agente mediante Microsoft GraphprocessContent, con auditoría de respuesta opcional. Guías sobre la configuración de permisos de Graph y directivas DLP.
test-local Ejecuta un agente de equipo con IA localmente y abre Agents Playground para pruebas interactivas, sin necesidad de despliegue en la nube. Se aplica a la ruta del compañero de IA.

Importante

make-ai-teammate le da a tu agente su propia cuenta de usuario, incluyendo un buzón y presencia en Teams. Esta capacidad está disponible solo para los inquilinos que participan en el programa de vista previa de Frontier.

Normalmente invocas una habilidad diciendo el resultado en lugar de nombrarla. Por ejemplo, añadir observabilidad a este agente se ejecuta instrument-observability. Si tu asistente de codificación expone la capacidad interna a365-code-validator , pídele que valide esta integración con el Agente 365; la capacidad también se describe internamente como Validar y Diagnosticar. La disponibilidad y la invocación dependen del asistente y del paquete de habilidades instalado. Para la redacción de la solicitud utilizada en cada paso, véase Inicio rápido: Conectar un agente existente al Agente 365.

Tipos de agentes y modos de autenticación

Las habilidades configuran tanto a agentes estándar como a compañeros de equipo controlados por IA. La ruta determina qué modos de autenticación están disponibles para el agente. El modo de autenticación, llamado modo de ejecución en la identidad del agente, determina como quién actúa el agente cuando llama a servicios aguas abajo como Microsoft Graph y servidores MCP.

Modo de autenticación Path El agente actúa como Úselo cuando
OBO (en nombre de) Agente estándar El usuario que ha iniciado sesión, con permisos delegados El agente funciona en el contexto del usuario, como leer el calendario de ese usuario o enviar correos electrónicos por él.
S2S (de servicio a servicio) Agente estándar Su propia identidad de agente, con permisos de aplicación El agente se ejecuta sin un usuario iniciado sesión, como para tareas programadas, monitorización o procesamiento en segundo plano.
Agentic-User Compañero de equipo de IA Cuenta de usuario propia El agente necesita su propio buzón, presencia en Teams u otras experiencias de Microsoft 365 basadas en el usuario. Requiere el programa de vista previa de Frontier.

Para un agente estándar, a365-setup pregunta si usa OBO o S2S, y las habilidades posteriores reutilizan tu respuesta. Un compañero de equipo IA siempre usa Agentic-User, así que a365-setup no pregunta. Skills configura un modo para cada agente. Si el agente necesita permisos tanto delegados como de aplicación, ejecuta a365 setup all --authmode both con la CLI del Agente 365. Para los roles que requiere cada modo, véase Concesiones de identidad del agente.

El modo de autenticación cambia lo que se configura en las aptitudes:

  • make-a365-agent se ejecuta a365 setup all con --authmode obo o --authmode s2s. OBO otorga permisos delegados a la identidad del agente, y S2S asigna permisos de aplicación a éste.
  • instrument-observability exporta la telemetría por la ruta S2S con un token solo de app en cada modo, así que una instancia de agente registrado no necesita permiso de observabilidad ni consentimiento de administrador. Para OBO y Agentic-User, la habilidad configura al agente para obtener ese token reutilizando las credenciales blueprint de su conexión de alojamiento. Para S2S, añade un servicio de tokens que adquiere y actualiza el token para los agentes de .NET, Node.jsy Python. Consulta Agent 365 habilitado mediante S2S.
  • add-workiq-tools requiere un token de usuario delegado, por lo que funciona con OBO y Agentic-User pero no con S2S. Si eliges S2S, se elimina Work IQ de las capacidades que has seleccionado a365-setup.
  • purview-dlp-integration admite la autenticación delegada por agentes. Para S2S, solo admite agentes de Node.js que usan autenticación de Identidad administrada federada (FMI) con secreto de cliente.
  • test-local se aplica solo a compañeros de IA.

Tecnologías compatibles

Las habilidades detectan automáticamente la pila de proyectos, así que no necesitas mapear tu proyecto manualmente. Estas son las pilas que detecta Skills. El SDK también funciona con otros frameworks.

Lenguaje Frameworks
.NET Microsoft Agent Framework, Kernel semántico, Fundición de IA de Azure
Node.js LangChain, SDK de agentes OpenAI, SDK de agentes Claude, Kernel semántico, ADK de Google
Python Microsoft Agent Framework, LangChain, OpenAI Agents SDK, Claude Agent SDK, Kernel semántico, Google ADK

Seguridad y repetibilidad

Las habilidades están diseñadas para aplicar cambios de configuración sin alterar el comportamiento existente de tu proyecto. Confirma este comportamiento con la lista de verificación de validación del SDK del Agente 365.

  • Aditivo e idempotente. Las habilidades no eliminan ni reestructuran código existente, y volver a ejecutar una habilidad no duplica el trabajo completado.
  • Consciente del Estado. Las habilidades detectan lo que ya está configurado, así que omiten en lugar de repetir los pasos ya completados.
  • Con barandilla de protección. Las funciones no modifican archivos fuera de tu proyecto y verifican que la compilación sigue realizándose correctamente antes de finalizar.

Utiliza habilidades cuando:

  • Tienes un agente existente y quieres incorporarlo sin haber escrito la integración a mano.
  • Tu flujo de trabajo de desarrollo ya incluye un asistente de programación.
  • Quieres una incorporación consistente y repetible entre proyectos.

Utiliza la configuración manual cuando:

  • Tu entorno es no estándar y cada paso requiere control individual.
  • Tu organización restringe los flujos de trabajo de los asistentes de programación.
  • Estás solucionando problemas y quieres hacer cada paso tú mismo.

Para la ruta manual, usa los pasos de configuración en Quickstart: conecta un agente existente al Agente 365 y ejecuta los comandos equivalentes de la CLI del Agente 365 para tu entorno.

Contenido relacionado

  • Última actualización o