Настройки базового агента

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

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

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

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

Элемент Description
Строка заголовка Отображает основные сведения об агенте, навигацию и основные параметры.
Значок Элемент фирменной символики агента, позволяющий упростить распознавание пользователями.
Name Уникальный идентификатор или название агента, помогающий пользователям распознавать его назначение или функцию.
Attribution Отображает средства или организацию за агентом, позволяя пользователям проверять подлинность и надежность.
Поле ввода чата Основное средство для взаимодействия пользователей с агентом, что позволяет им вводить запросы или команды. Поле ввода чата соответствует тем же рекомендациям, что и встроенный чат Microsoft 365, обеспечивая единообразный пользовательский опыт.
Идеи для запроса Короткие, щелкаемые предложения, которые отображаются на экране приветствия агента, прежде чем пользователь вводит что-либо. Они объясняют пользователям, с чего начать и что умеет агент.

Icon

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

Следуйте этим рекомендациям при разработке значка агента:

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

Note

Значки являются частью пакета приложения. Перед публикацией убедитесь, что файлы значков соответствуют требованиям магазина Teams. Дополнительные сведения см. в руководствах по проверке для агентов.

Имя

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

Следуйте этим рекомендациям при именовании агента:

  • Используйте четкое краткое имя, которое отражает функцию или домен агента. Например, Contoso Ticket Manager или Агент конвейера продаж.
  • Избегайте суперлативных утверждений, таких как "лучший", "удивительный", или "#1".
  • Избегайте чрезмерно универсальных имен, которые не отличают агент от других.
  • Для декларативных агентов значение name в manifest.json — JSON-файле декларативного агента — и значение name_for_human в любых JSON-файлах подключаемых модулей должны быть идентичны.
  • Не используйте инструкции, URL-адреса, эмодзи или скрытые символы в имени.

Important

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

Приписывание

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

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

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

Идеи для запроса

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

Эффективные идеи для запроса:

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

Пользовательский интерфейс при первом запуске

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

Сценарий первого запуска должен:

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

Дополнительные рекомендации по проектированию сценариев первого запуска см. в статье Человеко-ориентированное проектирование для агентов.

Возврат пользовательского интерфейса

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

Выбор чата

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

Список

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

Домашняя страница

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

Экран, показывающий макет навигации в интерфейсе Microsoft Copilot.

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

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