Планируйте и проектируйте стратегии интеграции

Агенты, созданные в Copilot Studio, получают новые возможности благодаря интеграции с другими онлайн-службами. К таким службам относятся службы Майкрософт, такие как SharePoint и Dataverse, сторонние службы, например ServiceNow, Salesforce и Databricks, а также пользовательские API. Power Platform предлагает богатую экосистему встроенных соединителей, которые доступны для Copilot Studio, поэтому вам не нужно создавать их самостоятельно. У вас также есть различные варианты для создания пользовательских интеграций с использованием малокодового или полнокодового подхода. Агенты могут расширять свои возможности с помощью протокол контекста модели (MCP) для взаимодействия с внешними инструментами и данными стандартизированным и масштабируемым способом или через использование компьютера для автоматизации веб- и настольных приложений напрямую с виртуальной машины, что позволяет реализовать более широкие сценарии интеграции даже при отсутствии доступного API.

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

• Читать, создавать и обновлять элементы в списке SharePoint.
• Отправлять электронные письма с помощью Office 365 Outlook.
• Открывать новые запросы в службу поддержки в ServiceNow.

Соображения по шаблонам интеграции

Copilot Studio поддерживает интеграцию через соединители Power Platform, HTTP-запросы, поток агента, навык Bot Framework и многое другое. Выбор подходящего паттерна интеграции зависит от требований проекта.

Соединители Power Platform

Соединители позволяют агентам взаимодействовать с основной службой. Это набор действий и триггеров, доступных через малокодовый интерфейс. Действия — это операции, выполняемые агентом, такие как чтение, запись или обновление. Триггеры уведомляют агента, когда событие происходит в другой службе.

Используйте готовые и пользовательские соединители:

• Готовые соединители: Microsoft предлагает большую экосистему соединителей SaaS, готовых к использованию с Copilot Studio.
• Пользовательские соединители: если нет готового соединителя, вы можете создать собственный соединитель для службы. Они представляют собой бескодовую или малокодовую оболочку для REST API.

Соединители Power Platform соответствуют следующим требованиям:

• Создатели, работающие с Power Platform, знакомы с бескодовыми и малокодовыми соединителями.
• Поддерживается код Power Fx, включая переменные, условия, параметры и многое другое.
• Разбор и обработка ошибок встроены.
• Готовые соединители требуют только настройки, без трудозатрат на разработку.
• Пользовательские соединители можно создать один раз и использовать во многих агентах.
• Возможность мониторинга активности при интеграции Copilot Studio с Application Insights (компонент Azure Monitor).
• Некоторые соединители и пользовательские соединители поддерживают виртуальные сети.

При интеграции с помощью соединителей Power Platform учитывайте следующие моменты:

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

HTTP-запросы

Агенты могут интегрироваться с другой службой, отправляя HTTP-запрос. Разработчик должен указывать следующие значения каждый раз при выполнении HTTP-запроса:

• URI-адрес
• Метод (GET, POST, PATCH, и так далее)
• Заголовки
• Основная часть

HTTP-запросы соответствуют следующим требованиям:

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

При использовании HTTP-запросов учитывайте следующие факторы:

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

Потоки агентов

Потоки агентов выполняют серию действий в заранее определенной последовательности. Они используют малокодовые действия, которые доступны в соединителях Power Platform. Агенты могут передавать значения в качестве входных данных в поток агента и получать его выходные результаты.

Потоки агентов функционально схожи с облачными потоками Power Automate, но имеют несколько важных отличий:

• Потоки агентов могут обеспечивать высокую пропускную способность и низкую задержку.
• Потоки агентов предлагают больше возможностей, чем потоки Power Automate, например, действия с участием человека.
• Потоки агентов расходуют кредиты Copilot в зависимости от их использования. Потоки Power Automate обычно лицензируются по модели "на пользователя" или по модели "на процесс".

Потоки агентов соответствуют следующим требованиям:

• Бескодовость или малокодовость.
• Детерминированное связывание действий в цепочку.
• Активность можно отслеживать отдельно.
• Скрывает чувствительные значения, такие как ключи и секреты, в действиях потока. Получает учетные данные из Azure Key Vault для аутентификации.
• Обрабатывает большие объемы данных и крупные файлы.
• Использует конкурентное и параллельное выполнение потоков для повышения производительности.
• Существующие облачные потоки Power Automate можно преобразовать в потоки агента.

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

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

Навыки Bot Framework

Навыки — это многократно используемые строительные блоки для ведения разговоров, которые вы создаете с помощью Bot Framework. Реализуйте навыки с помощью профессиональной разработки. Зарегистрируйте навыки в Copilot Studio, чтобы их использовать. После регистрации навыка в Copilot вы можете запускать его как узел в теме разговора.

Навыки Bot Framework соответствуют следующим требованиям:

• Синхронное выполнение.
• Поддержка частных конечных точек.
• Существующие навыки Bot Framework можно повторно использовать в Copilot Studio.

Используя навыки Bot Framework, учитывайте следующие факторы:

• Они требуют привлечения профессионального разработчика для постоянной разработки и поддержки (например, C#).
• Они выполняются в Службе ботов ИИ Azure.
• В Azure возникают дополнительные расходы, которые оплачиваются через вашу подписку Azure.
• Управление жизненным циклом приложения (ALM) осуществляется за пределами Power Platform.

Другие соображения по интеграционным шаблонам

В дополнение к рекомендациям по каждому типу интеграции, примите во внимание следующие аспекты для общей стратегии интеграции:

• Шаблоны интеграции Copilot Studio не являются взаимоисключающими и могут сочетаться между собой.
• Скорость интеграций зависит от скорости конечных точек, к которым они подключаются.
• Всегда оптимизируйте запросы, чтобы получать результаты как можно быстрее и обеспечивать качественный опыт взаимодействия.
• Если потоки агентов и Copilot Studio не выполняют логику достаточно быстро, рассмотрите следующие варианты:
  • Пользовательские API Dataverse
  • Малокодовые подключаемые модули Dataverse
  • Функции Azure
• В определенных сценариях интеграция данных выполняется в промежуточном слое, который модифицирует сообщения при их пересылке.

Добавление интеграций в агента

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

• Инструменты

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

• Темы

  • Вызывайте интеграцию через узел темы. Она выполняется в одной и той же позиции в последовательности темы каждый раз.
  • Подавайте входные данные в узел с помощью Power Fx.

• Агенты

  • Создайте дочернего агента с собственным набором инструкций и определите доступ к знаниям и инструментам, доступным родительскому агенту.
  • В качестве альтернативы подключитесь к существующему агенту в Copilot Studio, Microsoft 365 SDK, Microsoft Foundry, Fabric, Agent-To-Agent и т. д.

Квоты и лимиты

Ознакомьтесь с текущими лимитами, действующими для служб Copilot Studio и Power Platform:

• Квоты и лимиты Copilot Studio
• Лимиты Power Automate
• Ограничения на запросы и распределение запросов Power Platform
• Лимиты соединителей Power Platform, указанные на отдельной странице каждого соединителя.

Для следующих служб лимиты API вам нужно определить отдельно:

• Пропускная способность OpenAI: ограничения по скорости не документированы.
• Навыки Bot Framework: проверьте документацию Azure по конкретным используемым службам.

Обзорный пример планирования интеграций

При планировании интеграций с Copilot Studio определите следующую информацию для каждой службы:

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

Вот пример агента с несколькими интеграциями:

Далее

Узнайте, как ИИ-запросы, протокол контекста модели и агенты использования компьютера могут расширить возможности вашего агента.

Дополнительные сведения

• Обзор потоков агентов
• Использование соединителей Power Platform в качестве инструментов
• Добавление других агентов
• Расширение агента с помощью инструментов из REST API