Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 anterior que usaba un instructions.md archivo.
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:
- Indica el resultado que quieres.
- Deja que la habilidad identifique la pila del proyecto y la configuración existente.
- Proporciona los valores que solicita, como el modo de autenticación.
- Revisa el código, el manifiesto y los cambios de configuración que realiza.
- Confirma que el proyecto sigue construyéndose y que la integración funciona.
Las siete habilidades
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-setupdelega amake-a365-agent. Utiliza esta ruta cuando el agente necesita registro y observabilidad pero no cuenta de usuario. -
Compañero de equipo controlado por IA.
a365-setupdelega amake-ai-teammate, para un agente que necesita su propia cuenta de usuario. Esta ruta requiere el programa de vista previa Frontier.
| Aptitud | Purpose |
|---|---|
a365-setup |
Instala la CLI del Agente 365, valida los requisitos previos de Azure, detecta la pila de agentes y 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, luego 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 a365-setup haber corrido primero. |
instrument-observability |
Wires OpenTelemetry y el exportador de trazado Agent 365 para que los recubrimientos de agentes lleguen a Microsoft Defender, Microsoft Purview y al centro de administración de Centro de administración de Microsoft 365. Pide el tipo de agente y el modo de autenticación; ver Identidad del agente. |
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. |
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 al camino de los compañeros de la 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.
Pilas soportadas
Las habilidades detectan automáticamente la pila de proyectos, así que no necesitas mapear tu proyecto manualmente. Estas son las pilas que detectan Habilidades. 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á cableado, así que saltan en lugar de repetir los pasos completados.
- Con barandilla de protección. Las habilidades no modifican archivos fuera de tu proyecto, y verifican que la compilación sigue pasando antes de terminar.
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.