Используйте разъёмы Power Platform как инструменты в агентах Copilot Studio

Note

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

Соединители Microsoft Power Platform выступают в роли прокси или «оберток» вокруг API. Они позволяют Copilot Studio, Power Automate, Power Apps и Azure Logic Apps взаимодействовать с другими приложениями и службами. Используя соединители, вы можете подключать свои учетные записи и использовать готовые инструменты и триггеры для создания приложений и рабочих процессов.

Используя соединители, вы можете получить доступ к различным службам (как внутри экосистемы Microsoft, так и за ее пределами) для автоматического выполнения широкого спектра задач.

Доступно много соединителей. Соединители включают соединения между службами Майкрософт, такими как Office 365, SharePoint и Dynamics 365, и подключения к этим службам, а также подключения к службам, не принадлежащим Майкрософт, таким как Twitter, службы Google, Salesforce и другим. Соединители классифицируются следующим образом:

• Готовые соединители, которые представляют собой встроенные подключения к популярным службам, доступные для использования в агентах Copilot Studio. Ниже перечислены доступные соединители:

  • Стандартные соединители, такие как SharePoint, которые включены во всех планах Copilot Studio.
  • Премиум-соединители, которые доступны в некоторых планах Copilot Studio.

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

Интеграция с Copilot Studio

Соединители — полезные инструменты, которые значительно расширяют функциональность агентов Copilot Studio. Используя соединители, вы можете подключаться к различным внешним сервисам и приложениям для выполнения широкого спектра задач или получения данных. Используя эти соединители, вы можете создавать более динамичные, отзывчивые и полезные агенты, адаптированные под конкретные бизнес-потребности и процессы.

Вы можете вызывать соединители как инструменты в вашем агенте разными способами:

• На уровне агента, в разделе Инструменты
• Внутри темы.

Также можно использовать разъёмы в Copilot Studio как:

• Действия в потоках агентов
• Источники знаний. Для получения дополнительной информации см. раздел Добавление соединителей Power Platform в качестве базы знаний (предварительная версия).

Note

Генерация изображений не поддерживается непосредственно в агентах Copilot Studio. Для таких сценариев, как генерация каркаса пользовательского интерфейса или генерация изображений, используйте внешние службы, интегрированные через соединители.

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

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

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

1. Выберите Агенты и выберите агент, к которому хотите добавить соединитель.

2. Перейдите на страницу Инструменты вашего агента и выберите Добавить инструмент.

3. Выберите Соединитель. Вы видите разные сервисы с доступными разъёмами.

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

5. Выберите инструмент, который нужно добавить. Откроется панель Добавить инструмент.

6. Если соединения еще нет, выберите Создать новое подключение. Детали настройки подключения зависят от выбранного соединителя.

7. Выберите Отправить или Создать, если применимо, при завершении работы.

8. Выберите Добавить и настроить. Открывается страница настройки нового инструмента, показывающая новый инструмент и его детали.

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

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

1. Выберите Агенты и выберите агент, к которому хотите добавить соединитель.

2. Перейдите на страницу Темы и выберите тему, к которой хотите добавить соединитель.

3. Выберите Добавить узел (+) на холсте разработки агента.

4. В окне выбора узла выберите Добавить инструмент>Соединитель и найдите нужный соединитель, который хотите добавить.

5. Настройте параметры подключения для соединителя по мере необходимости.

6. Нажмите кнопку "Отправить".

   По умолчанию подключение использует учетные данные пользователя. Дополнительные сведения о поддерживаемых режимах проверки подлинности см. в разделе Настройка проверки подлинности пользователей для инструментов. Чтобы изменить это поведение, см. Создание пользовательского соединителя для добавления в агент.

Создание пользовательского соединителя для добавления в агент

1. Выберите Агенты и выберите агент, к которому хотите добавить соединитель.

2. Перейдите на страницу Инструменты и выберите Добавить инструмент.

3. Выберите Создать инструмент>Настраиваемый соединитель. Вы будете перенаправлены на портал Power Apps в раздел Пользовательские соединители.

4. Выберите Создать настраиваемый соединитель и выберите метод, который вы хотите использовать для создания соединителя.

Использование соединителей с учетными данными, предоставленными создателем

Соединителям требуется действительный набор учетных данных. По умолчанию соединители просят пользователей (пользователей вашего агента) ввести свои учетные данные для соответствующего сервиса при использовании инструмента. Чтобы ваш агент использовал учетные данные создателя, выполните следующие шаги:

1. Настройте агент для использования канала, прошедшего проверку подлинности.
2. Добавьте к агенту инструмент-соединитель и настройте его.
3. Перейдите на страницу Обзор инструмента-соединителя.
4. В разделе Сведения>Дополнительные сведения>Учетные данные для использования выберите Учетные данные, предоставленные создателем.
5. Опубликуйте и протестируйте опыт взаимодействия с агентом в панели Тестирование агента или в выбранном канале.

Общий доступ к подключению

Чтобы поделиться своим подключением с другими:

1. Перейдите к make.powerapps.com.
2. Выберите Подключения на левой панели навигации.
3. Выберите подключение и выберите Поделиться.
4. В диалоговом окне Общий доступ найдите нужного пользователя и выберите его.
5. В разделе Разрешение рядом с пользователем выберите Может использовать и делиться.

Limitations

• Единый вход (SSO) не поддерживается для соединителей, когда агент использует настраиваемую аутентификацию Active Directory и развертывается в Microsoft Teams. В этой конфигурации соединители не могут использовать единый вход, и пользователи должны проходить аутентификацию для каждого соединителя вручную. Чтобы ваши пользователи могли успешно подключаться, убедитесь, что необходимые подключения настроены в Copilot Studio. Инструкции по настройке подключений см. в разделе Настройка подключений и управление ими.