Рекомендации по созданию декларативных агентов

Декларативные агенты настраивают Microsoft 365 Copilot для конкретных бизнес-сценариев с помощью инструкций, источников знаний и поддерживаемых возможностей. Используйте эти рекомендации, чтобы держать агента в фокусе, безопасно настраивать его действия и оценивать его поведение по мере развития.

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

Примечание

В этой статье рассматриваются декларативные агенты, использующие управляемую среду выполнения Copilot. Если вы создаете агент пользовательской подсистемы, который извлекает данные граундинга Microsoft 365, следуйте рекомендациям, разрешениям и ограничениямAPI извлечения. Эти инструкции не связаны с настройкой источников знаний декларативного агента.

Компоненты декларативного агента

Выберите каждый компонент для поддержки предполагаемых задач агента. Соблюдение ограничений в выбранном средстве разработки и схеме манифеста.

Компонент Рекомендации
Name (Имя) Используйте уникальное имя, которое передает цель агента. Agent Builder позволяет использовать до 30 символов; Манифест декларативного агента допускает до 100.
Описание Кратко опишите задачи и область в нескольких точных предложениях, не превышающих 1000 символов. Сохраняйте подробные инструкции по поведению в поле инструкций.
Инструкции Определите цель агента, поддерживаемые задачи, источник и использование инструмента, формат вывода и поведение при сбоях в пределах ограничения в 8000 символов.
Источники знаний Добавьте соответствующие источники для предполагаемых вопросов. Подтвердите поддерживаемую область, свежесть, разрешения и лицензирование.
Встроенные возможности Включайте такие возможности, как интерпретатор кода или генератор изображений , только если они поддерживают предполагаемые задачи.
Пользовательские навыки (предварительная версия) Используйте навыки для инструкций модульных задач, ресурсов или сценариев. Ссылайтесь на настроенные навыки в обобщенном виде, а не дублируйте их подробные инструкции.
Действия Используйте плагины MCP или API для поддерживаемых взаимодействий с внешними службами. Опишите назначение каждого инструмента, входные параметры, выходные данные и условия сбоя.
Начало беседы Предоставьте репрезентативные запросы, демонстрирующие поддерживаемые задачи. Минимальное количество не требуется. Протестируйте каждый запрос и следуйте ограничениям выбранного средства.

Рекомендации по инструкциям для агентов

Используйте инструкции, чтобы определить, как агент должен подходить к намеченным задачам:

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

Подробные шаблоны, примеры и рекомендации по изменению модели см. в разделе Написание эффективных инструкций. Для задач, сочетающих знания с вызовами API, см. Написание инструкций для агентов с плагинами API.

Выбор правильных источников знаний

Выбирайте источники знаний на основе вопросов, на которые должен ответить агент:

  • Отдавайте предпочтение релевантности, а не количеству. Определите источники файлов, сайтов, чатов или другого содержимого, необходимого для выполнения задачи. Для SharePoint и внедренных файлов см. раздел Оптимизация получения контента.
  • Сопоставление извлечения с требованиями к свежести. Регулярно проверяйте исходное содержимое и владельцев. Веб-поиск с заданной областью использует содержимое, индексированное в Bing, а не прямой запрос базовых данных. Вместо этого для текущих структурированных данных оцените поддерживаемое действие API или MCP. См. раздел "Граундинг веб-поиска" и динамическое содержимое.
  • Подтвердите доступ перед предоставлением общего доступа. Протестируйте с пользователями, которые представляют предполагаемую аудиторию и разрешения. Проверка поведения при совместном использовании внедренных файлов отдельно от доступа к исходным файлам.
  • Проверьте поддерживаемые возможности и лицензирование. Источники и параметры определения области различаются в зависимости от средства разработки и конфигурации клиента. Следуйте таблице поддержки источников знаний и руководству по лицензированию.
  • Оценивайте граундинг, а не только беглость ответов. Протестируйте вопросы с известными ответами и проверка, что ответы и цитаты соответствуют предполагаемым источникам. Включите вопросы, ответы на которые недоступны.

Добавление источников само по себе не мешает агенту использовать встроенные знания о модели. Если сценарий требует ответов, основанных на источнике, установите behavior_overrides.special_instructions.discourage_model_knowledgetrue и укрепите предполагаемое использование источника в инструкциях. Этот элемент управления не гарантирует, что ответы используют только настроенные источники. Продолжайте оценивать атрибуцию источника и поведение, когда отсутствуют доказательства. См. Ответы Земли на настроенные источники знаний и справочник по специальным инструкциям.

Разработка безопасных действий

использовать действия для поддерживаемых взаимодействий с внешними службами и отличать их от источников знаний; Соединитель Copilot, используемый для заземления, не взаимозаменяем с инструментом API или MCP, изменяющим внешние данные.

  • Точно описывайте операции. Объясните, когда инструмент следует использовать, его необходимые параметры, ожидаемые результаты и ошибки. Для REST API следуйте инструкциям по OpenAPI.
  • Настройте подтверждения для интеграции. Для плагинов API используйте расширение x-openai-isConsequentialOpenAPI , а не isConsequential, и помечайте операции с побочными эффектами как косвенные. Для средств MCP используйте readOnlyHint только для средств, которые доступны только для чтения. Следуйте инструкциям по подтверждению для подключаемых модулей MCP и API, чтобы узнать поддерживаемые параметры и поведение.
  • Принудительное применение доступа в службе. Используйте поддерживаемый метод проверки подлинности и проверьте авторизацию и входные данные во внешней службе. Инструкции и запросы на подтверждение не заменяют эти проверки.
  • Проектирование с учетом сбоев и повторяющихся запросов. Протестируйте отклоненные подтверждения, просроченную проверку подлинности, недопустимые вводы и ошибки службы. В операциях, где изменяются данные, убедитесь, что повторные попытки не приводят к непреднамеренному повторению изменения.

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

Тестирование и итерация

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

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

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

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