Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Декларативные агенты настраивают 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, чтобы узнать поддерживаемые параметры и поведение. - Принудительное применение доступа в службе. Используйте поддерживаемый метод проверки подлинности и проверьте авторизацию и входные данные во внешней службе. Инструкции и запросы на подтверждение не заменяют эти проверки.
- Проектирование с учетом сбоев и повторяющихся запросов. Протестируйте отклоненные подтверждения, просроченную проверку подлинности, недопустимые вводы и ошибки службы. В операциях, где изменяются данные, убедитесь, что повторные попытки не приводят к непреднамеренному повторению изменения.
Используйте данные плана, конфиденциальность и безопасность, чтобы определить потоки данных, разрешения и требования к контролю со стороны пользователей для каждого действия.
Тестирование и итерация
Определение ожидаемого поведения перед изменением агента и ведение повторяемого набора тестовых сценариев. Используйте возможности тестирования средства разработки для получения ранних отзывов, а затем проверьте развернутый агент на его предполагаемых узлах.
| Тестовая область | Что нужно проверить |
|---|---|
| Поддерживаемые задачи | Начало беседы, реалистичные формулировки пользователя и последующие вопросы дают желаемые результаты. |
| Отсутствующие или неподтвержденные сведения | Агент запрашивает необходимые данные, объясняет недоступные доказательства и не выдумывает факты и не заявляет о совершенных неудачных действиях. |
| Граундинг и разрешения | Ответы и цитаты соответствуют предполагаемым источникам. Протестируйте пользователей с разным доступом и убедитесь, что информация с ограниченным доступом не раскрывается. |
| Действия и неудачи | Проверьте фактический внешний результат, а также отклик. Проверки подтверждений, отмен, сбоев проверки подлинности, ошибок служб и повторных запросов. |
| Возможности организатора | Протестируйте каждое поддерживаемое приложение, в котором предполагается выполнить развертывание. Проверьте контекст документа, представление ответа и доступные возможности, а не предполагайте одинаковое поведение во всех приложениях. |
| Производительность и изменения | Измеряйте время отклика и повторно запускайте регрессионные случаи после изменения инструкций, знаний, инструментов, навыков или поведения платформы. |
Включите пользователей, которые не составляли инструкции, чтобы тесты фиксировали неожиданные формулировки и предположения. Преобразуйте воспроизводимые проблемы, о которых сообщают пользователи, в случаи регрессии.
Сведения о дизайне тестовых примеров, утверждениях и повторяемом вычислении см. в статье Обзор оценки агента. Проверки выпуска см. в статье "Проверка ответственного применения ИИ " и "Проверка и тестирование плагина".
См. также:
- Создание агентов с помощью построителя агентов
- Создание агентов с помощью средств разработчика Work IQ (рекомендуется для поддерживаемых сценариев разработки кода)
- Написание эффективных инструкций для декларативных агентов
- Добавление источников знаний в декларативный агент
- Запросы на подтверждение для подключаемых модулей MCP и API
- Обзор оценки агентов
- Рекомендации по проверке для агентов