Punto de conexión de mensajería de agente

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 de conexión de mensajería del agente

Use el a365 cleanup blueprint --endpoint-only comando para eliminar el registro del punto de conexión de mensajería del agente. Este comando no afecta al código de su agente ni al punto de conexión implementado. Solo elimina la entrada de registro a través de Teams Graph (Plataforma MCP).

a365 cleanup blueprint --endpoint-only

Configurar el punto de conexión de mensajería en a365.config.json

Antes de configurar el punto de conexión de mensajería, especifíquelo en su archivo de configuración de a365.config.json. Este archivo contiene la configuración central para la implementación de su agente.

Agregue o actualice estas propiedades de configuración del punto de conexión de mensajería:

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

  • messagingEndpoint: Especifique la URL exacta del punto de conexión donde puede enviar mensajes al agente.

  • deploymentProjectPath: Ruta de acceso al directorio del proyecto del agente. Esta propiedad no es relevante si su agente ya está implementado y no necesita actualizar la configuración del entorno. Establezca deploymentProjectPath en . solo si el código del agente no está en su máquina.

Propiedades de configuración

Property Descripción Obligatorio Valor predeterminado Ejemplo
messagingEndpoint La URL donde su agente recibe los mensajes Sí Nada https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Ruta al directorio de su proyecto de agente para actualizaciones de configuración No . ./my-agent o .

Opciones de configuración de puntos de conexión

El valor de messagingEndpoint depende del escenario de implementación:

Para implementaciones de Azure:

  • Azure Web App: https://your-app-name.azurewebsites.net/api/messages

Para implementaciones fuera 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: URL de punto de conexión personalizada

Para pruebas locales con túneles Dev:

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

Importante

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

Nota

Cuando use túneles dev para pruebas locales, actualice el messagingEndpoint en a365.config.json con la URL de su túnel dev antes de ejecutar el comando de configuración. Para más información, consulte pruebas con túneles de desarrollo.

Establecer el punto de conexión de mensajería del agente

Una vez actualizado el archivo a365.config.json, utilice este comando para registrar el punto de conexión de mensajería, lo que permitirá que el servicio Agent 365 envíe notificaciones a su agente. La operación --endpoint-only registra el punto de conexión a través de Teams Graph (Plataforma MCP).

a365 setup blueprint --endpoint-only

También puede pasar la URL directamente con --messaging-endpoint, en lugar de editar a365.config.json:

a365 setup blueprint --endpoint-only `
  --messaging-endpoint https://your-app.azurewebsites.net/api/messages

Durante las pruebas locales, puede establecer este punto de conexión como un punto de conexión de túnel dev antes de implementar el agente en la nube. Para más información, consulte pruebas con túneles de desarrollo.

Para actualizar la URL de un punto de conexión existente:

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

Implementación del punto de conexión

Si aún no tiene su agente implementado en la nube, aprenda a implementarlo en Azure.

Si ya tiene su agente implementado en la nube, puede configurar el punto de conexión de mensajería como se mostró antes.

Aprenda a configurar el punto de conexión de mensajería en otras nubes populares:

  • Last updated on