Создайте поток агентов как инструмент

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

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

  • Пусть Когда агент вызывает триггер потока и действие ответа Ответить агенту.
  • Будьте настроены на реагирование в реальном времени, а не асинхронно. Переключатель асинхронного ответа должен быть настроен на Off в разделе Networking в настройках Response в настройках действия агента .
  • Ответьте агенту в пределах лимита действия в 100 секунд. Оптимизируйте логику потока, запросы и объём возвращаемых данных так, чтобы типичный запуск был ниже этого лимита в 100 секунд. Действия в потоке, которые должны выполняться дольше, можно разместить после действия Предоставить ответ для Copilot, чтобы продолжить выполнение до предела длительности выполнения потока в 30 дней. Для рекомендаций по ускорению ваших потоков см. раздел «Ускорить выполнение потока агентов в экспресс-режиме».

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

Предпосылки

  • Доступ к Copilot Studio с лицензией, которая включает в себя использование потоков в Copilot Studio.

Создание потока, который можно использовать с агентом

В этом примере вы создаёте поток, который получает текущий прогноз погоды из MSN Weather. Вы добавляете поток как инструмент к уже существующей теме агента.

Добавьте пустой поток агентов в тему и сохраняйте его

  1. Перейдите на страницу Темы для вашего агента.

  2. Откройте тему, из которой вы хотите вызвать поток.

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

  4. На вкладке «Основные инструменты » выберите «Поток нового агента».

    Открывается страница потоков агентов , а в дизайнере flow агентов открывается шаблон стартового потока для редактирования. Поток включает необходимое Когда агент вызывает триггер потока и Ответить на действие агента .

  5. Выберите «Опубликовать», чтобы сохранить поток перед внесением изменений. При успешном создании потока появляется уведомление.

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

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

Добавьте действия и настройте поток

С созданным базовым шаблоном для потока и добавлением потока в тему вашего агента, вы теперь можете возвращаться и добавлять действия в свой поток. В этом примере вы добавляете действие, которое получает текущий прогноз из MSN Weather.

  1. На узле Action с потоком выберите ссылку View flow details, чтобы вернуться к потоку агента.

  2. На странице «Обзор » в разделе «Подробности» отредактируйте название потока на что-то значимое, например, «Получить прогноз погоды».

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

    • Город (Текст)
    • Почтовый индекс (Число)

  4. Выберите значок «Добавить » под разделом «Когда агент вызывает триггер потока ».

  5. В разделе Добавить действие выполните поиск по запросу "погода MSN" и выберите действие Получить прогноз на сегодня.

  6. На панели Получить прогноз на сегодня в поле Местоположение введите косую черту (/), выберите Вставить динамическое содержимое, затем выберите входной параметр Город.

  7. Действуйте таким же образом, чтобы добавить входной параметр Почтовый индекс.

  8. В действии «Ответить агенту » добавьте следующие выходные параметры и переменные:

    Выходной параметр Type Переменная
    day_summary Текст Сводка за день
    location Текст Location
    chance_of_rain Номер Вероятность дождя за день

    Снимок экрана с динамическими переменными в качестве выходных параметров для ответного действия.

  9. Выберите Опубликовать. При успешном создании потока появляется уведомление.

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

Управляйте тем, какие соединения используются потоком

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

Облачные потоки в средах, использующих ключи, управляемые клиентом (CMK), пока нельзя запускать с учетными данными клиентов в рамках планов генеративной оркестрации или из разделов. Убедитесь, что параметры запуска только для облачных потоков в средах CMK установлены для конкретных подключений, а не для Предоставлено пользователем только для запуска.

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

  • Last updated on