Вызов агентного потока

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

Предварительные условия

Этот пример основан на предыдущем примере, когда вы создали поток агентов , который получает прогноз погоды.

Если вы еще не создали поток прогноза погоды, сделайте это сейчас.

Вызовите поток агента из агента

Здесь мы показываем, как добавить поток прогноза погоды в качестве инструмента для агента. Этот метод позволяет оркестратору агента вызывать поток, когда ему нужно предоставить прогноз погоды.

  1. В левой навигационной панели в Copilot Studio выберите Agents и выберите агента, к которому хотите добавить поток.

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

  3. Выберите Flow , чтобы показать список доступных опубликованных потоков.

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

  5. Выберите Добавить и настроить.

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

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

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

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

  9. Когда закончите с настройкой, выберите Сохранить.

Вызовите поток агента из темы

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

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

  2. Создайте новую тему и назовите ее Получить погоду.

  3. Добавьте следующие триггерные фразы:

    • будет ли дождь
    • прогноз на сегодня
    • получить погоду
    • какая погода

    Снимок экрана фраз-триггеров для темы

  4. Выберите значок Добавить узел под узлом Триггер и выберите Отправить сообщение.

  5. В узле Сообщение введите Я могу помочь вам с этим. в текстовом поле.

  6. Выберите значок Добавить узел под узлом Сообщение и выберите Задать вопрос, чтобы добавить узел Вопрос для первой части информации для потока — города.

  7. В узле Вопрос:

    1. Введите вопрос «Какой у вас город?» в текстовое поле.
    2. В разделе Идентифицировать выберите Весь ответ пользователя.
    3. Обратите внимание на имя переменной, связанной с этим ответом, Var1. Вы можете оставить имя как есть или заменить его более осмысленным именем, например, "Город" (см. раздел Переименовать переменную, если это необходимо).

  8. Таким же образом добавьте еще один узел Вопрос для другой части информации о потоке, — почтового индекса:

    1. Введите вопрос «Какой у вас почтовый индекс?» в текстовое поле.
    2. В разделе Идентифицировать выберите Число.
    3. Обратите внимание на имя переменной, связанной с этим ответом, Var2. Вы можете оставить имя как есть или заменить его более осмысленным именем (например, "ПочтовыйИндекс").

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

  10. Задайте входные данные потока выходным переменными из узлов вопросов. Город (строка) получает свое значение из Var1 (или City, если вы ее переименовали), а Почтовый индекс (число) получает свое значение из Var2 (или ZIPcode, если вы ее переименовали).

    Снимок экрана узла

  11. Под узлом Действие добавьте узел Сообщение и введите сообщение, которое использует выходные данные из потока. Например:

    "Прогноз на сегодня для location: day_summary"
    "Вероятность дождя — chance_of_rain%"
    Где location,day_summary, и chance_of_rain — выходные параметры из потока.

    Снимок экрана узла Message с сообщением, использующим выходные параметры из потока.

  12. Выберите Сохранить.

Управление потоком агентов, используемый в теме

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

  • Удалить окончательно удаляет узел и удаляет поток из темы.

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

Если вы хотите выбрать или создать другой поток, используйте значок Изменить поток, который появляется при наведении указателя мыши на поток в узле Действие.

Проверка вашего потока и темы

Рекомендуется протестировать поток и вызывающую его тему.

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

Скриншот тестового чата с информацией из инструмента «Получить прогноз погоды».

Устранение неполадок с агентом

Обязательно проверяйте свой агент, когда вы вносите изменения в свои темы и потоки, чтобы убедиться, что все по-прежнему работает. Если агент сталкивается с проблемой во время разговора, он отвечает сообщением об ошибке.

Найдите большинство проблем, связанных с потоком, в проверке потоков на вкладке проектировщика потоков . Используйте проверку тем , чтобы выявлять проблемы на авторском холсте.

  • Last updated on