Использование входных и выходных переменных для передачи информации

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

Внимание!

Агент может получить только до 1 МБ данных от потока в одном действии. Однако нет ограничений на количество переменных или объем данных, которые может отправить агент.

В этом примере вы создаете поток с входным параметром и возвращаете его агенту в качестве выходного параметра.

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

Поддерживаемые типы параметров

Агенты Copilot Studio поддерживают следующие типы входных и выходных параметров для потоков агентов:

  • Число
  • String
  • Логический

Следующие типы данных не поддерживаются:

  • Object
  • Date
  • Метка времени
  • Список [String]
  • Список [Число]
  • Список [Булевый]
  • Список [Объект]
  • Список [Дата]
  • Список [Временная метка]

Создание темы и потока

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

  2. Создайте новую тему с именем Эхо-сообщение.

  3. Добавьте фразу-триггер эхо.

  4. Добавьте узел Вопрос и введите сообщение "Скажите мне что-нибудь, и я отвечу вам".

  5. Для параметра Идентификация выберите Весь ответ пользователя.

  6. Для Сохранить ответ пользователя как, переименуйте переменную в userResponse.

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

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

  8. На вкладке «Основные действия» выберите поток «Новый агент». Вкладка agent flow designer открывается с начального шаблона для потока агента, вызываемого агентом. Поток включает два действия: когда агент вызывает поток и отвечает агенту.

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

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

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

Редактировать детали потока

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

  2. На вкладке «Обзор » потока отредактируйте детали потока, заменив имя на параметр Echo. Нажмите кнопку "Сохранить".

  3. Вернуться на вкладку «Дизайнер».

Добавление входного параметра в поток

  1. Выберите «Когда агент вызывает триггер потока потока» и выберите « Добавить вход».

  2. Выберите Текст и введите имя String_Input.

    Снимок экрана входного параметра триггера потока.

Добавление выходного параметра в поток

  1. Выберите действие «Ответить на ответ агента» и выбрать «Добавить выход».

  2. Выберите Текст и введите имя String_Output.

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

  3. В качестве значения введите косую черту (/) в поле, выберите Вставить динамическое содержимое, затем выберите переменную String_Input.

  4. Выберите Сохранить черновик и опубликовать. Copilot Studio сообщает вам, когда публикуется поток агентов.

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

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

  1. Выберите новый узел действия.

  2. Присвойте входному параметру потока значение выходной переменной из узла Вопрос: String_Input (строка) получает свое значение из переменной userResponse.

    Снимок экрана узла Action, вызывающего поток

  3. Добавьте узел Сообщение.

  4. Выберите Вставить переменную, затем выберите String_Output.

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

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

  6. Протестируйте свой агент.

    Снимок экрана разговора агента.

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

  • Last updated on