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

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

Конечная точка удаления агентов для обмена сообщениями

Используйте a365 cleanup blueprint --endpoint-only команду , чтобы очистить регистрацию конечной точки сообщения агента. Эта команда не влияет на ваш код агента или развернутую конечную точку. Он удаляет только регистрационную запись.

Для агентов M365 (Teams, Copilot) передайте --m365, чтобы очистить конечную точку через 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

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

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

Добавьте или обновите эти свойства конфигурации конечных точек сообщений:

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

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

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

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

Свойство Description Обязательно Default Example
messagingEndpoint URL, по которому ваш агент получает сообщения Yes нет https://your-app.azurewebsites.net/api/messages
deploymentProjectPath Путь к каталогу проекта агента для обновлений конфигурации No . ./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

Important

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

Note

При использовании Dev Tunnels для локального тестирования обновите messagingEndpoint вход a365.config.json с URL Dev Tunnel перед запуском команды setup. Для получения дополнительной информации см. тестирование с Dev Tunnels.

Задайте конечную точку обмена сообщениями агентов

После обновления a365.config.json файла используйте эту команду, чтобы зарегистрировать конечную точку сообщений, чтобы сервис Agent 365 мог отправлять уведомления вашему агенту.

Для агентов M365 (Teams, Copilot) передайте --m365 для регистрации через 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

Во время локального тестирования вы можете установить эту конечную точку в Dev Tunnel перед развертыванием агента в облаке. Для получения дополнительной информации см. тестирование с Dev Tunnels.

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

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

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

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

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

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

  • Last updated on