Punto final de mensajería de agente

El punto final de mensajería del agente es el punto final donde envías mensajes de notificación agental a tu agente.

Eliminar el punto final de mensajería del agente

Utilice el comando a365 cleanup blueprint --endpoint-only para borrar el registro del punto de conexión de mensajería del agente. Este comando no afecta al código de tu agente ni al endpoint desplegado. Solo quita la entrada de registro.

Para los agentes de M365 (Teams, Copilot), pase --m365 para borrar el punto de conexión a través de Teams Graph:

# M365 agents — clears via Teams Graph (MCP Platform)
a365 cleanup blueprint --endpoint-only --m365

# Non-M365 agents — prints the Teams Developer Portal URL for manual configuration
a365 cleanup blueprint --endpoint-only

Configura el extremo de mensajería en a365.config.json

Antes de configurar el endpoint de mensajería, especifícalo en tu a365.config.json archivo de configuración. Este archivo contiene la configuración central para el despliegue de tu agente.

Añade o actualiza estas propiedades de configuración del endpoint de mensajería:

{
  "messagingEndpoint": "https://your-endpoint-url.com/api/messages",
  "deploymentProjectPath": "."
}

  • messagingEndpoint: Especifica la URL exacta del endpoint donde puedes enviar mensajes al agente.

  • deploymentProjectPath: ruta de acceso al directorio del proyecto del agente. Esta propiedad no es relevante si el agente ya está implementado y no es necesario actualizar la configuración del entorno. Configura deploymentProjectPath a . únicamente si el código del agente no está en tu máquina.

Propiedades de configuración

Propiedad Description Obligatorio Default Example
messagingEndpoint La URL donde tu agente recibe los mensajes Yes Ninguno https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Ruta de acceso al directorio del proyecto del agente para las actualizaciones de configuración No . ./my-agent o .

Opciones de configuración del punto final

El messagingEndpoint valor depende de tu escenario de despliegue:

Para las implementaciones de Azure:

  • Azure Aplicación web: https://your-app-name.azurewebsites.net/api/messages

Para implementaciones que no son de Azure:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Otros proveedores de nube: Tu URL personalizada de endpoint

Para las pruebas locales con túneles de desarrollo:

  • URL del túnel de desarrollo: https://abc123xyz.devtunnels.ms:3978/api/messages

Importante

Especifica deploymentProjectPath dónde busca la CLI los archivos del proyecto y dónde actualiza la configuración del entorno, como los .env archivos.

Nota:

Al usar túneles de desarrollo para pruebas locales, actualice messagingEndpoint en a365.config.json con la URL de su túnel de desarrollo antes de ejecutar el comando de instalación. Para obtener más información, consulta Pruebas con Túneles de Desarrollo.

Establecer el punto final de mensajería del agente

Después de actualizar el a365.config.json archivo, use este comando para registrar el punto de conexión de mensajería para que el servicio Agente 365 pueda enviar notificaciones al agente.

Para los agentes de M365 (Teams, Copilot), pase --m365 para registrarse a través de Teams Graph:

# M365 agents — registers via Teams Graph (MCP Platform)
a365 setup blueprint --endpoint-only --m365

# Non-M365 agents — prints the Teams Developer Portal URL for manual configuration
a365 setup blueprint --endpoint-only

Durante las pruebas locales, puedes configurar este endpoint como un Dev Tunnel antes de desplegar el agente en la nube. Para obtener más información, consulta Pruebas con Túneles de Desarrollo.

Para actualizar una dirección URL de punto de conexión existente:

a365 setup blueprint --update-endpoint https://your-new-host.example.com/api/messages --m365

Despliegue del endpoint

Si aún no tiene el agente implementado en la nube, learn cómo implementar el agente en Azure.

Si ya tienes a tu agente desplegado en la nube, puedes configurar el endpoint de mensajería como se mostró antes.

Aprende a configurar el endpoint de mensajería en otras nubes populares:

  • Amazon Web Services
  • Google Cloud Platform
  • Last updated on