Настройка и управление соединениями

Агенты используют инструменты и знания для выполнения действий от имени пользователей и сбора релевантной контекстной информации. Разработчики часто хранят эти инструменты и источники знаний во внешних системах, таких как Microsoft Dataverse, Microsoft SharePoint или другие API. Для безопасного доступа к этим ресурсам агентам необходимо пройти аутентификацию для установления связей между собой и внешней системой. Агент может использовать либо аутентификацию автора агента, либо аутентификацию пользователя, в зависимости от ситуации.

В Microsoft Copilot Studio вы используете подключения для безопасного доступа к аутентифицированным сервисам для инструментов и знаний. Вы можете создавать подключения к различным источникам данных, таким как Microsoft Dataverse, Microsoft SharePoint или внешние API.

Просмотр и управление соединениями агентов

В Copilot Studio вы можете просматривать и настраивать соединения, используемые вашим агентом, на странице Connection Settings.

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

Просмотр соединений на странице настроек соединения

1. Перейдите на страницу вашего агента в Copilot Studio, выбрав Agents а затем выберите нужного агента.

   Открывается страница обзора агента.

2. Выберите «Настройки », чтобы открыть страницу «Настройки агента».

3. Выберите настройки соединения.

Список отображается в таблице со всеми связями, связанными с вашим агентом. Для каждого соединения вы можете посмотреть:

• Имя подключения
• Инструменты и источники знаний с использованием соединения
• Состояние подключения

Определения статуса соединения

Статус соединения указывает текущее состояние соединения. Существует несколько возможных статусов:

• Подключение: Соединение активно, и агент может использовать его для доступа к соответствующему инструменту или знаниям.
• Не связанно: активного соединения нет. Агент не может получить доступ к соответствующему инструменту или знаниям. Вам нужно установить связь.
• Деактивировано: соединение отключено, возможно, администратором, и агент сейчас им не пользуется.
• Просрочено: Учетные данные аутентификации для соединения истекли и больше не являются действительными. Вам нужно повторно аутентифицировать соединение, чтобы агент мог получить доступ к соответствующему инструменту или знаниям.
• Устаревшее: Соединение больше не действитно и не пригодно для использования, обычно из-за разрыва или истечения времени. Вам нужно проверить, обновить или заменить соединение, чтобы агент мог получить доступ к соответствующему инструменту или знаниям.

Соединения фильтров

Если у вас много контактов в вашем агенте, отфильтруйте список, чтобы найти то, с чем хотите иметь дело. Вы можете использовать разные фильтры для просмотра соединений в зависимости от их статуса, например , Активировано/деактивировано, Подключено/не подключено, Деактивировано, Просрочено или Ошибка соединения.

Выберите или создайте индивидуальное соединение

1. В разделе «Статус для записи соединения» в списке выберите гиперссылку рядом со статусом, чтобы открыть панель «Создать», или выберите панель соединения .

2. Выберите ... чтобы открыть конфигурацию Соединения .

3. Выберите существующее соединение из списка или выберите « Добавить новое», чтобы создать новое.

   Если выбрать «Добавить новое соединение», открывается панель настройки соединения. По мере необходимости вас могут попросить войти в сервис или предоставить дополнительную информацию для завершения настройки соединения.

4. По завершении нажмите кнопку Отправить , чтобы сохранить изменения.

   Соединение теперь настроено и связано с вашим агентом, и он может использовать это соединение для доступа к инструментам и знаниям.

Просмотр деталей и настройка параметров соединения

В разделе «Управление » для записи соединения в списке выберите «Смотреть подробности », чтобы узнать больше о соединении.

Информация представлена в двух вкладках:

• Детали: отображает имя соединения, описание, статус и детали создания.
• Параметры соединения: отображает параметры соединения, такие как данные аутентификации, ключи API или другую необходимую информацию, и позволяет настроить детали.

Обмен параметрами соединения для аутентификации On-Behalf-Of (OBO)

Для некоторых соединений, поддерживающих единый вход (SSO), можно настроить аутентификацию On-Behalf-Of (OBO). В OBO-потоке пользователь делегирует агенту использовать общие параметры соединения с сервисом от имени пользователя. Этот метод аутентификации полезен, когда агенту необходимо получить доступ к ресурсам, требующим пользовательских разрешений, или когда действия должны выполняться в контексте идентичности пользователя.

Включить совместное использование параметров для OBO

В разделе «Параметры соединения » для записи соединения в списке можно разрешить пользователю авторизировать совместное использование определённых параметров соединения.

1. В разделе «Параметры подключения» включите «Разрешить разрешение на совместное использование параметров».

   

2. Выберите галочки параметров, которые вы хотите позволить пользователю делиться.

   Пользователю предлагается предоставить разрешение на эти параметры, когда агент использует аутентификацию OBO.

Пользовательский опыт для аутентификации OBO

Когда агент использует OBO-аутентификацию, пользователю предлагается предоставить разрешение на использование параметров соединения. Пользователь может выбрать разрешение или отказ в этом разрешении. Если пользователь это позволяет, агент может получить доступ к ресурсам и выполнять действия от имени пользователя. Агент подключается к сервису прозрачно, используя общие параметры соединения.

Повторяющиеся подсказки подключения при использовании OAuth 2.0 с инструментами Microsoft Graph API

При использовании аутентификации OAuth 2.0 каждый пользователь должен войти и дать согласие. Когда вы делитесь или размещаете агента, другие пользователи ещё не дали согласия, поэтому они видят карту Connect .

Чтобы избежать повторяющихся подсказок, вы можете попробовать один из следующих вариантов аутентификации:

• Включите единый вход в Teams (SSO) с помощью процесса on-name-of (OBO): Пользователи входят один раз в Teams. Дополнительное согласие в чате не требуется.

• Используйте разрешения приложений (принципал сервиса): Бэкэнд вызывает Microsoft Graph с использованием учетных данных приложений. Не требуется согласие пользователя.

• Используйте универсальный OAuth SSO для веб-размещённых агентов: ваше приложение обрабатывает вход и передаёт токен агенту.

• Предоставление согласия администратора на делегированные сферы деятельности: удаляет запросы на разрешение пользователя. По-прежнему требуется первичный вход.

Связанный контент

• Настройка аутентификации OBO для пользовательских разъёмов