Punto final de mensajería de agente

Importante

Debe formar parte del programa de versión preliminar Frontier para obtener acceso anticipado a Microsoft Agent 365. Frontier le conecta directamente con las innovaciones de inteligencia artificial más recientes de Microsoft. Las versiones preliminares de Frontier están sujetas a los términos de vista previa existentes en tus acuerdos con clientes. Dado que estas características siguen en desarrollo, su disponibilidad y funcionalidades pueden cambiar con el tiempo.

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

Usa el a365 cleanup blueprint --endpoint-only comando para eliminar la entrada 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 elimina la entrada de registro de este endpoint para tu agente.

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",
  "needDeployment": false,
  "deploymentProjectPath": "."
}

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

• needDeployment: indique a la CLI si quiere implementar el código en una aplicación web de Azure.

• deploymentProjectPath: Despliega tu código de agente en la nube. Esta propiedad no es relevante si tu agente ya está desplegado y no necesitas desplegarlo de nuevo. Configura deploymentProjectPath a . únicamente si el código del agente no está en tu máquina.

Propiedades de configuración

Propiedad	Description	Obligatorio	Predeterminado	Example
messagingEndpoint	La URL donde tu agente recibe los mensajes	Sí	Ninguno	https://your-app.azurewebsites.net/api/messages
needDeployment	Tanto si la CLI debe implementar en Azure (true) como si estás autohospedando (false)	No	true	false para túneles AWS/GCP/Dev
deploymentProjectPath	Ruta al directorio de tu proyecto de agente para actualizaciones de despliegue y configuración	No	.	./my-agent o .

Opciones de configuración del punto final

El messagingEndpoint valor depende de tu escenario de despliegue:

Para implementaciones de Azure (needDeployment: true):

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

Para implementaciones que no Azure (needDeployment: false):

• 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 pruebas locales con Túneles de Desarrollo (needDeployment: false):

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

Importante

• Al implementar en Azure, establezca needDeployment en true. La CLI gestiona automáticamente el despliegue.
• Para AWS, GCP o Dev Tunnels, configura needDeployment para false indicar que gestionas el despliegue por separado.
• 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:

Cuando uses Dev Tunnels para pruebas locales, actualiza el messagingEndpoint en a365.config.json con la URL del Dev Tunnel y establece needDeployment a false antes de ejecutar el comando de configuració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 tu a365.config.json archivo, usa este comando para registrar el endpoint de mensajería con el servicio Agent 365 y así poder enviar notificaciones a tu agente.

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.

a365 setup blueprint --endpoint-only

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