Конечная точка обмена сообщениями агента

Конечная точка обмена сообщениями агента — это точка, через которую вы отправляете уведомления агенту.

Удаление конечной точки обмена сообщениями агента

Используйте команду a365 cleanup blueprint --endpoint-only для удаления регистрации конечной точки обмена сообщениями агента. Эта команда не затрагивает ваш код агента или развернутую конечную точку агента. Команда только удаляет запись о регистрации через Teams Graph (платформа MCP).

a365 cleanup blueprint --endpoint-only

Настройка конечной точки обмена сообщениями в a365.config.json

Прежде чем устанавливать конечную точку обмена сообщениями, укажите ее в конфигурационном файле a365.config.json. Этот файл содержит основную конфигурацию для развертывания агента.

Добавьте или обновите следующие свойства конфигурации точки обмена сообщениями:

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

  • messagingEndpoint: укажите точный URL-адрес конечной точки, по которому можно отправлять сообщения агенту.

  • deploymentProjectPath: путь к каталогу проектов агента. Это свойство не имеет значения, если ваш агент уже развернут и вам не нужно обновлять конфигурацию среды. Установите для параметра deploymentProjectPath значение ., только если код агента не находится на вашем компьютере.

Свойства конфигурации

Свойство Описание Обязательное поле По умолчанию Пример
messagingEndpoint URL-адрес для получения сообщений агентом Да Ничего https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Путь к каталогу проекта агента для обновления конфигурации нет . ./my-agent или .

Параметры конфигурации конечной точки

Значение messagingEndpoint зависит от вашего сценария развертывания:

Для развертываний Azure:

  • Веб-приложение Azure: https://your-app-name.azurewebsites.net/api/messages

Для развертываний, отличных от Azure:

  • AWS: https://your-api-gateway-url.amazonaws.com/api/messages
  • GCP: https://your-cloud-run-url.run.app/api/messages
  • Другие облачные поставщики: URL-адрес пользовательской конечной точки

Для локального тестирования с туннелем разработки:

  • URL-адрес туннеля разработки: https://abc123xyz.devtunnels.ms:3978/api/messages

Важно

deploymentProjectPath определяет, где интерфейс командной строки ищет файлы проекта и где обновляет конфигурацию среды, например файлы .env.

Примечание

При локальном тестировании с помощью туннеля разработки обновите messagingEndpoint в a365.config.json, указав URL-адрес туннеля разработки перед запуском команды настройки. Подробнее см. в разделе Тестирование с помощью туннеля разработки.

Настройка конечной точки обмена сообщениями агента

После обновления файла a365.config.json используйте эту команду для регистрации конечной точки обмена сообщениями, чтобы служба Agent 365 могла отправлять уведомления вашему агенту. Операция --endpoint-only регистрирует конечную точку через Teams Graph (платформа MCP).

a365 setup blueprint --endpoint-only

Вы также можете передать URL-адрес напрямую с --messaging-endpoint вместо редактирования a365.config.json:

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

Во время локального тестирования можно задать для этой конечной точки конечную точку туннеля разработки до развертывания агента в облаке. Подробнее см. в разделе Тестирование с помощью туннеля разработки.

Чтобы обновить существующий URL-адрес конечной точки:

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

Развертывание конечной точки

Если агент еще не развернут в облаке, узнайте, как развернуть агент в Azure.

Если агент уже развернут в облаке, вы можете настроить конечную точку обмена сообщениями, как было показано ранее.

Узнайте, как настроить конечную точку обмена сообщениями на других популярных облачных платформах:

  • Last updated on