Inicio rápido: Conecta a un agente existente con el Agente 365

En este inicio rápido, conectas a un agente existente con Agent 365 usando Agent 365 Skills en tu asistente de programación. El camino comienza registrando al agente, luego añade las capacidades que elijas y termina con la validación. Si construyes un compañero de equipo con IA, que requiere el programa de vista previa de Frontier, también puedes probarlo localmente.

Cada paso nombra la habilidad que la maneja y muestra una solicitud de ejemplo. Invocas una habilidad indicando el resultado, no escribiendo el nombre de la habilidad.

Prerequisites

  • Un agente existente en una pila soportada: Python, Node.jso .NET.
  • Un tenant de Microsoft con el Agente 365 activado. Inicia sesión como Administrador Global o como Desarrollador de ID de Agente con un Administrador Global disponible para completar las concesiones de permisos OAuth.
  • Una suscripción a Azure con permiso para crear recursos.
  • Un asistente de programación soportado: Claude Code, GitHub Copilot CLI o modo agente VS Code.
  • La CLI de GitHub (gh), solía instalar las habilidades.

La licencia depende de las capacidades que adoptes:

  • Identidad. No hay licencia adicional. El inquilino debe tener activado el Agente 365.
  • Observabilidad. Al menos un usuario en el tenant con una licencia de Microsoft 365 E7 o Microsoft Agent 365 asignada. Sin él, la telemetría se pierde silenciosamente.
  • Herramientas (Work IQ). Una licencia de Microsoft 365 Copilot. El MCP de Work IQ está en previsualización.
  • Notificaciones. Una cuenta de usuario de agente, disponible solo para los inquilinos en el programa de vista previa de Frontier.

Tip

Primero confirma que el SDK es el mecanismo de integración adecuado para tu agente. Consulta la opción Elegir tu integración. Para el modelo de identidad detrás del registro, incluyendo planos, permisos y consentimiento, véase conceptos clave de identidad de agente y Agente de Microsoft Entra ID.

Instala las habilidades

Instala las habilidades en tu asistente de programación:

gh skill add microsoft/agent365-skills

El mismo comando funciona para Claude Code, GitHub Copilot CLI y el modo agente de VS Code. Reinicia tu asistente después para que aprenda las nuevas habilidades.

Configurar y detectar el proyecto

Abre tu proyecto de agente en tu asistente de codificación y luego ejecuta:

Habilidad: a365-setup

establecer este proyecto para el Agente 365

Responde a las preguntas sobre tu agente. Cuando la habilidad termina, valida tus requisitos previos y detecta tu stack.

Setup guarda los IDs y endpoints generados en a365.generated.config.json. La configuración estándar de agentes no necesita un archivo de configuración escrito a mano; La configuración de compañeros de equipo de IA requiere un archivo de .a365.config.json

a365-setup Luego te encamina por uno de dos caminos de provisionamiento. Completa el que seleccione y luego continúa con los pasos compartidos que siguen:

Ambos caminos continúan en Instrumento para mayor observabilidad.

Registro del agente

Completa este paso si a365-setup te ha dirigido al camino estándar del agente.

Habilidad: make-a365-agent

Regístra a este agente con el Agente 365

Cuando termina la habilidad, tu agente tiene un plano registrado en Microsoft Entra, una identidad de agente creada a partir de él y los permisos que necesita. El registro proporciona visibilidad del catálogo; El paso de observabilidad añade telemetría.

Añadir mensajes y notificaciones

Completa este paso si a365-setup te dirige al camino de compañeros de la IA.

Habilidad: make-ai-teammate

añadir mensajes y notificaciones a este agente

La habilidad añade la capa de alojamiento y el enrutamiento de mensajes, y registra al agente. La gente puede acceder a él a través de Teams, Outlook, comentarios de Word y correo electrónico.

Importante

Este paso 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. Sáltate este paso si tu inquilino no está inscrito.

Instrumento de observabilidad

Completa este paso en cualquiera de los dos caminos. La habilidad pregunta qué tipo de agente tienes.

Habilidad: instrument-observability

Añadir observabilidad a este agente

Cuando se le pida, elige el modo de autenticación que utiliza tu agente: OBO (en nombre de un usuario iniciado sesión), Agentic-User (la cuenta de usuario del agente, que requiere el programa de vista previa Frontier) o S2S (de servicio a servicio, para operaciones en segundo plano). El exportador usa el mismo modo con el que tu agente se autentica, así que elige el modo que coincida con tu modelo de permisos. Ver Identidad del agente.

Tras una prueba, los spans de tu agente aparecen en Microsoft Defender, Microsoft Purview y el Centro de administración de Microsoft 365.

Importante

Dos cosas pueden hacer que la telemetría parezca que ha desaparecido, aunque la solicitud devuelva HTTP 200. Si ningún usuario en el tenant tiene asignada una licencia Microsoft 365 E7 o Microsoft Agent 365, se descarta toda la solicitud; que el SKU esté presente no es suficiente. Si la partida no tiene un span válido invoke_agent en su raíz, los tramos siguen consultables en la caza avanzada de Defender pero no aparecen en ninguna de las tres superficies. El espacio raíz es el espacio de nivel superior que emite el SDK para la invocación de un agente; Cada llamada a herramienta y evento de inferencia anida dentro de ella.

Conectar datos de Microsoft 365

Completa este paso en cualquiera de los dos caminos si tu agente lee o actúa sobre datos de Microsoft 365. Las herramientas de Work IQ requieren un modelo de permisos delegados, por lo que este paso se omite automáticamente si eliges S2S en el paso de observabilidad.

Habilidad: add-workiq-tools

Conectan Work IQ Mail and Calendar

Nombra las cargas de trabajo que necesitas, como Mail, Calendar o Word. La habilidad conecta los servidores MCP de Work IQ correspondientes, y tu agente puede acceder a esos datos bajo control administrativo.

Importante

El MCP de Work IQ está en versión preliminar y requiere una licencia Microsoft 365 Copilot. Un Administrador Global debe conceder permisos a los OAuth para los servidores de Work IQ antes de que tu agente pueda llamarlos. Consulta Añadir y gestionar herramientas.

Prueba localmente

Completa este paso si estás en el camino de compañeros de equipo de IA, que requiere el programa de vista previa de Frontier. Agents Playground se conecta sobre el endpoint de mensajería del agente, así que no se aplica a los agentes estándar.

Habilidad: test-local

Prueba este agente localmente

Tu agente compite contra Agents Playground, un arnés local de pruebas, así que puedes hacer una prueba de humo antes de desplegarlo.

Validar el resultado

Tu agente debe empezar y responder como lo hizo antes de la incorporación, y aparecer en el Agente 365 bajo su identidad registrada.

Si tu asistente de codificación expone la capacidad interna de Validar y Diagnosticar el Agente 365, pídele que valide esta integración con el Agente 365 para ejecutar el preflight a nivel de código contra el proyecto. Verifica lagunas en la instrumentación, artefactos de Microsoft Entra, mensajería, acceso a herramientas y configuraciones relacionadas. La capacidad también se denomina internamente a365-code-validatorcomo ; disponibilidad y enrutamiento exacto dependen del asistente de codificación y del paquete de habilidades instalado.

Antes de desplegar, trabaja con la lista de verificación de validación del SDK del Agente 365.

Troubleshoot

Utiliza la siguiente tabla para identificar y resolver problemas comunes al conectar a tu agente con el Agente 365.

Síntoma Resolution
El asistente de programación describe los comandos pero no los ejecuta Usa un modo que tenga acceso a terminal. En VS Code, usa el modo agente. Los modos de Preguntar y Editar no pueden ejecutar comandos de terminal.
Informes de configuración que faltan prerequisitos de Azure Completa los requisitos previos que a365-setup aparecen y luego ejecuta la habilidad de nuevo.
El registro de blueprint falla, o los comandos CLI devuelven errores de autorización Confirma que has iniciado sesión con una cuenta que tenga permiso para registrar planos de identidad de agente en el inquilino.
No aparece telemetría Confirma que al menos un usuario en el tenant tiene asignada una licencia Microsoft 365 E7 o Microsoft Agent 365, luego confirma que la ejecución emite un span válido invoke_agent en su raíz, y después confirma que el modo de autenticación que seleccionaste coincide con tu entorno. Pide a tu asistente de programación que valide la integración con Agent 365; La habilidad del validador instalado puede diagnosticar la instrumentación.
Parece que se ha saltado un paso Las habilidades son conscientes del estado y se saltan trabajo que ya está cableado, así que probablemente el paso ya esté completado. Ejecuta la habilidad específica de nuevo y expone el resultado explícitamente.
Los valores de configuración deben cambiar tras la configuración Si tu configuración usa a365.config.json, edítalo y vuelve a ejecutarlo a365 config init -c ./a365.config.json, luego ejecuta la habilidad correspondiente de nuevo.

Contenido relacionado

  • Last updated on