Punto de conexión 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 de conexión de mensajería de agente es el punto de conexión donde envía mensajes de notificación de agente a su agente.

Eliminar el punto final de mensajería del agente

Use 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 punto de conexión para su 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",
  "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 Predeterminado Example
messagingEndpoint La URL donde tu agente recibe los mensajes Sí 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 de conexión 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
  • Last updated on