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 un stack compatible: Python, Node.js o .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.

Note

La configuración de Agent 365 utiliza la aplicación empresarial Agent 365 CLI administrada por Microsoft cuando está disponible en tu inquilino. No necesitas crear una aplicación cliente personalizada para este camino. Si la aplicación empresarial no está disponible, la configuración recurre a una aplicación propiedad del inquilino llamada Agent 365 CLI. Una aplicación cliente personalizada configurada explícitamente sigue siendo soportada. Para más información, consulte Registro personalizado de aplicación de cliente para la CLI del Agente 365.

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. Work IQ MCP está en versión preliminar.
  • Notificaciones. Una cuenta de usuario de agente, disponible solo para los inquilinos en el programa de vista previa de Frontier.

Sugerencia

Primero confirma que el SDK es el mecanismo de integración adecuado para tu agente. Consulta Elige tu opción de 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

configurar este proyecto para Agent 365

Responde a las preguntas sobre tu agente. Cuando la capacidad termina, valida sus requisitos previos y detecta su pila.

Setup guarda los IDs y endpoints generados en a365.generated.config.json. La configuración estándar del agente no necesita un archivo de configuración creado manualmente; la configuración del asistente de IA requiere un archivo de configuración creado manualmente 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 redirigió a la ruta estándar del agente.

Habilidad: make-a365-agent

Regístra a este agente con el Agente 365

Cuando finaliza el proceso, su agente tiene una plantilla registrada en Microsoft Entra, una identidad del agente creada a partir de esta 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 ha redirigido a la ruta del compañero de 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 ejecución de prueba, los intervalos de su 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 ejecución no tiene un intervalo válido invoke_agent en su raíz, los intervalos se pueden seguir consultando en la búsqueda avanzada de Defender, pero no aparecen en ninguna de las tres interfaces. 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

Configurar 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 los permisos de OAuth para los servidores de Work IQ antes de que tu agente pueda invocarlos. Consulta Añadir y gestionar herramientas.

Prueba localmente

Complete este paso si sigue el itinerario de Compañero de IA, que requiere el programa de versión preliminar de Frontier. Agents Playground se conecta a través del punto de conexión de mensajería del agente, por lo 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 iniciarse y responder tal como lo hacía antes del proceso de incorporación, y aparecer en Agent 365 con su identidad registrada.

Si tu asistente de codificación expone la capacidad interna Agent 365 Validate & Diagnose, pídele que valide esta integración de Agent 365 para ejecutar la comprobación previa a nivel de código en 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 como a365-code-validator; la disponibilidad y el enrutamiento exacto dependen del asistente de codificación y del paquete de Skills instalado.

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

Solucionar problemas

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 al terminal. En VS Code, usa el modo agente. Los modos de Preguntar y Editar no pueden ejecutar comandos de terminal.
La instalación indica que faltan requisitos previos de Azure Completa los requisitos previos que indica a365-setup y luego vuelve a ejecutar la habilidad.
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 tienen en cuenta el estado y omiten las tareas que ya están configuradas, por lo que es probable que el paso ya se haya 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