Настройка поддержки Virtual Network для исходящих соединений от агентов

Когда вы используете поддержку Virtual Network в среде Power Platform, вы можете безопасно подключаться и интегрировать компоненты Power Platform и Dataverse с облачными сервисами или сервисами, размещёнными внутри вашей частной корпоративной сети, не подключая их к публичному интернету.

Copilot Studio интегрируется с виртуальными сетями Power Platform через частную конечную точку для следующих сценариев:

• Агенты, которые получают ключи из Azure Key Vault по HTTP
• Агенты, которые отправляют телеметрию в частный экземпляр Application Insights с поддержкой конечной точки
• Агенты, использующие виртуальный сетевой коннектор (например, SQL Server) для получения данных с Azure SQL Server

Если вы настроите виртуальную сеть для среды Power Platform и включите Copilot Studio захват телеметрии с помощью Application Insights или отправлять HTTP-запросы с вашим агентом через виртуальную сеть, вызовы с Power Platform к ресурсам Azure и Application Insights проходят через вашу частную сеть.

Необходимые условия

• Ваша среда должна быть управляемой средой в Power Platform.
• Для вашей среды Power Platform у вас должна быть включена поддержка Virtual Network. См. также Set Virtual Network support for Power Platform для создания виртуальных сетей и делегирования подсетей, которые могут соединяться между Azure ресурсами и вашей средой Power Platform.
• Вы должны быть администратором по аренде Power Platform или занимать должность администратора среды.

Включите поддержку виртуальной сети для вашей среды

Чтобы подключиться к сервисам через частную конечную точку, необходимо включить поддержку виртуальной сети для Power Platform.

Вы можете вручную включить virtual network поддержку, следуя инструкциям Set Virtual Network support for Power Platform чтобы создавать виртуальные сети и делегировать подсети, которые могут соединяться между Azure ресурсами и вашей средой Power Platform.

Вы также можете использовать готовый шаблон Azure Resource Manager (ARM) для настройки и подключения среды Power Platform с Azure, а также для включения поддержки виртуальной сети:

1. Скачайте шаблон ARM из репозитория Microsoft Copilot Studio сэмплов на GitHub.

2. Откройте PowerShell, подключитесь к подписке Azure и развернуте шаблон с помощью команды [New-AzDeployment] (/powershell/module/az.resources/new-azdeployment#description) следующим образом:

   Connect-AzAccount -Subscription "<Azure subscription>"
   New-AzSubscriptionDeployment -Name "<name of deployment>" -TemplateFile "<template.json>" -Location "<Azure geo>"
   

   где:

   • <Azure подписка> — это ваш идентификатор подписки.
   • <Название развертывания> — это имя, которое вы хотите дать этому развертыванию.
     Имя может быть любым по вашему выбору, но по умолчанию сохраняется имя файла шаблона, если вы оставите его пустым.
   • <template.json> — это путь и имя файла шаблона.
   • <Azure geo> — это географический регион, куда должны размещаться файлы управления развертыванием, такие как West US. Регион не контролирует, где шаблон создаёт ресурсы.

Для получения дополнительной информации о шаблонах и управлении ARM см. Deploy resources with ARM templates и Azure PowerShell.

Ознакомьтесь с обзором поддержки Virtual Network для Power Platform. Затем следуйте инструкциям Настройте Virtual Network поддержки Power Platform чтобы создать виртуальные сети и делегировать подсети, которые могут соединяться между Azure ресурсами и вашей средой Power Platform.

Retrieve keys from Azure Key Vault over HTTP

Когда вы настраиваете виртуальную сеть для среды Power Platform, вы можете настроить Copilot Studio-агентов для получения информации из Azure ресурсов с помощью HTTP-вызовов.

Во-первых, настройте приватную ссылку и эндпоинт для Azure Key Vault. После проверки работы ссылки добавьте узел HTTP-запроса из холста автора агента в Copilot Studio для подключения к Key Vault.

Настройте приватную ссылку

Следуйте инструкциям из Интегрируйте Key Vault с Azure Private Link чтобы:

Используйте узлы HTTP-запроса для подключения через частную сеть

После настройки приватной ссылки на Key Vault добавьте узел HTTP-запроса к агенту в Copilot Studio для подключения через частную сеть. Укажите детали соединения с приватной конечной точкой в узле. Когда агент достигает этого узла в разговоре, он делает запрос и получает информацию.

1. В Copilot Studio в верхней строке меню выберите среду, где включена поддержка Virtual Network.

2. Создайте или откройте существующий агент в этой среде. Если вы создаете нового агента, вы можете пропустить начальные этапы настройки в разговорном холсте.

3. Когда агент открыт, создайте или измените тему в авторском холсте.

4. Чтобы добавить узел HTTP-запроса в тему, следуйте инструкциям из Make HTTP-запросы.

5. Используйте следующие настройки в узле HTTP-запроса:

   • URL: Введите URL Azure Key Vault приватной конечной точки, например, https://yourkeyvault.vault.azure.net/secrets?api-version=7.3. Замените yourkeyvault именем Key Vault.

   • Метод: Выберите GET для извлечения секретов из Key Vault.

     • Заголовки и основная часть: выберите Редактировать.

     

   • В свойствах HTTP Request введите Authorization как Ключ и Bearer <access-token> как Value, где <access-token> является вашим Azure доступом.

     

6. Сохраняйте тему и проверяйте работу узла, запуская разговор на тестовом холсте агента.

Отправить телеметрию в частный экземпляр Application Insights с поддержкой конечной точки

Когда вы настраиваете виртуальную сеть для среды Power Platform, вы можете настроить своих Copilot Studio агентов для отправки телеметрии в частный экземпляр Application Insights с поддержкой конечной точки. Таким образом, вы сможете отслеживать и анализировать работу и использование ваших агентов, не раскрывая данные в публичном интернете.

Во-первых, настройте приватную ссылку и конечную точку для Application Insights. Затем, после проверки работы соединения, подключите Copilot Studio к Application Insights, и он отправит телеметричные данные по приватной линии.

Настройте приватную ссылку

Используя Azure Private Link в Azure Monitor, Copilot Studio можете использовать виртуальную сеть для передачи агентской телеметрии на Azure Monitor по приватному IP-адресу вместо публичного.

Azure Monitor — это бэкенд-платформа данных, которая собирает и хранит телеметрические данные, включая данные Application Insights.

Следуйте инструкциям в Configure private link for Azure Monitor и:

Вы также можете настроить, какие сети могут подключаться к ресурсам в вашем AMPLS, без использования области видимости, на странице Network Isolation для вашего AMPLS. Прямая настройка сетей полезна, если у вас несколько виртуальных сетей и вы хотите ограничить доступ к AMPLS только определёнными сетями или подсетями.

Подключите Copilot Studio к Application Insights

После настройки приватной ссылки можно подключить Copilot Studio к Application Insights. Он использует вашу виртуальную сеть для передачи телеметрических данных.

Следуйте инструкциям в Capture telemetry с помощью Application Insights.

Телеметрия от агентов Copilot Studio отображается в ресурсе Application Insights, который вы настроили. Вы можете использовать поток живых метрик для просмотра телеметрических данных в реальном времени или использовать раздел «Журналы » для запроса и анализа данных.

Используйте разъёмы, поддерживаемые виртуальной сетью, для получения данных

Когда вы настраиваете виртуальную сеть для среды Power Platform, вы можете настроить своих Copilot Studio агентов так, чтобы они использовали поддерживаемые виртуальной сетью коннекторы для подключения к данным и сервисам через вашу частную сеть.

Можно использовать любой коннектор с нативной поддержкой виртуальных сетей.

Используя подключения, поддерживаемые виртуальной сетью, вы можете безопасно подключаться к вашим облачным источникам данных, таким как Azure SQL или SQL Server, через частные конечные точки без их доступа к интернету.

Чтобы добавить и настроить нужный разъём в теме или инструменте, следуйте инструкциям в Use Power Platform connectors в Copilot Studio.