Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Декларативные агенты — это настраиваемые версии Microsoft 365 Copilot, которые помогают создавать персонализированные интерфейсы путем объявления конкретных инструкций, действий и знаний. Чтобы написать эффективные инструкции для декларативного агента, рассмотрите следующие вопросы:
- Какую цель должен достичь ваш агент?
- Какие рабочие процессы вы представляете для конечных пользователей?
- Есть ли бизнес-логика, которые вы хотите включить?
- Есть ли желаемый интерфейс для конечных пользователей, который вы хотите включить?
- Можно ли предоставить пошаговые инструкции для каждого рабочего процесса для агента?
Если декларативный агент также имеет подключаемые модули API в качестве действий, документ OpenAPI для подключаемого модуля поможет агенту понять все инструкции, ссылающиеся на API. Дополнительные сведения см. в разделе Как сделать документ OpenAPI эффективным при расширении Copilot.
Это руководство относится к разработчикам и разработчикам, которые используют Microsoft 365 Agents Toolkit (эволюция набора средств Teams) или Copilot Studio для создания декларативных агентов.
Компоненты инструкций
Хорошо структурированный набор инструкций гарантирует, что агент понимает свою роль, задачи, которые он должен выполнять, и как взаимодействовать с пользователями. Ниже приведены main компоненты инструкций декларативного агента.
- Назначение
- Общие рекомендации, включая общие направления, тон и ограничения
- Навыки
Кроме того, в соответствующих случаях инструкции включают следующее:
- Пошаговые инструкции
- Обработка ошибок и ограничения
- Обратная связь и итерация
- Примеры взаимодействия
- Нестандартные термины
- Дальнейшие действия и закрытие
На следующей схеме показаны основные компоненты инструкций декларативного агента.
Рекомендации по инструкциям агента
Используйте понятный язык действий
- Сосредоточьтесь на том, что следует делать Copilot, а не на том, что следует избегать.
- Используйте точные, определенные глаголы, такие как "ask", "search", "send", "проверка" или "use".
- Добавьте примеры , чтобы свести к минимуму неоднозначность.
- Определите в инструкциях все нестандартные или уникальные для организации термины.
Создание пошаговых рабочих процессов с переходами
Разделение рабочих процессов на модульные, однозначные и неконфликтные шаги. Каждый шаг должен включать:
- Цель: цель шага.
- Действие: что должен делать агент и какие средства следует использовать.
- Переход: четкие критерии для перехода к следующему шагу или завершения рабочего процесса.
Инструкции по структуре в Markdown
Чтобы сделать акцент и ясность в порядке шагов, используйте Markdown.
- Используйте
#
,##
и###
для заголовков разделов. - Используйте
-
для неупорядоченных списков и1.
для нумерованных списков. Используйте неупорядоченные списки, если порядок действий не важен, в этом случае используйте нумерованные списки. - Выделите имена инструментов или систем (например,
Jira
,ServiceNow
,Teams
) с помощью обратных подсказок ('''''). - Сделайте критические инструкции полужирным шрифтом с помощью
**
.
Явные ссылки на возможности, знания и действия
Четкое название действий, возможностей или источников знаний, участвующих на каждом шаге.
-
Действия: например, "Использовать
Jira
для получения билетов". -
Знания соединителя Copilot: например, "Используйте
ServiceNow KB
статьи справки". - Знания SharePoint: например, "Ссылка на внутренние документы SharePoint или OneDrive".
- Email сообщения: например, "Проверьте сообщения электронной почты пользователей на наличие соответствующей информации".
- Сообщения Teams: например , "Поиск в журнале чатов Teams".
- Интерпретатор кода: например , "Использование интерпретатора кода для создания линейчатой или круговой диаграммы".
- Люди знаний: например, "Используйте знания людей для получения электронной почты пользователя".
Предоставить примеры
Примеры помогают агенту понять инструкции.
- Для простых сценариев не нужно указывать примеры.
- В сложных сценариях декларативные агенты лучше всего работают с несколькими запросами. То есть приведите несколько примеров, чтобы проиллюстрировать различные аспекты или варианты ребер.
Избегайте распространенных сбоев запросов
Помните об этих подводных камнях и их решениях.
-
Чрезмерное использование инструментов
- Проблема. Модель вызывает инструменты без необходимых входных данных.
- Решение. Добавьте инструкцию "Вызов средства только при наличии необходимых входных данных; В противном случае спросите пользователя".
-
Повторяющееся выражение
- Проблема. Модель повторно использует пример выражения дословно.
- Решение. Поощряйте различные ответы и естественный язык. Рассмотрите возможность добавления нескольких примеров вместо одного (несколько выстрелов). Поэкспериментируйте с удалением примера, чтобы сохранить на маркерах.
-
Подробные объяснения
- Проблема. Модель слишком объясняет или обеспечивает избыточное форматирование.
- Решение. Чтобы ограничить детализацию или форматирование, добавьте ограничения и краткие примеры.
Выполните итерацию по инструкциям
Инструкции по разработке для декларативных агентов часто являются итеративными и обычно состоят из следующих шагов.
- Создайте инструкции и средства начала беседы для агента в соответствии со структурой и форматом, описанными в этой статье.
- Опубликуйте агент. Методы ответственного ИИ (RAI) интегрируются в процесс проверки, чтобы убедиться, что агенты соблюдают этические стандарты. Дополнительные сведения см. в разделе:
-
Протестируйте агент.
- Чтобы убедиться, что агент приносит дополнительное значение при ответе, сравните результаты с Microsoft 365 Copilot.
- Убедитесь, что средства начала беседы работают должным образом с пошаговыми инструкциями.
- Убедитесь, что агент действует в соответствии с предоставленными инструкциями.
- Убедитесь, что запросы пользователей за пределами начальной беседы обрабатываются надлежащим образом.
-
Выполните итерацию по инструкциям, чтобы узнать, можно ли дополнительно улучшить выходные данные.
- Измените инструкции, чтобы изменить поведение агента.
- При необходимости попробуйте добавить такие знания, как поиск в Интернете, OneDrive или SharePoint или соединители Microsoft 365 Copilot (ранее — соединители Microsoft Graph), используя набор средств агентов или Copilot Studio.
На следующей схеме показан итеративный процесс создания и уточнения инструкций декларативного агента.
Примеры инструкций
В следующем примере приведены инструкции для агента, который может помочь в решении распространенных ИТ-проблем.
# OBJECTIVE
Guide users through issue resolution by gathering information, checking outages, narrowing down solutions, and creating tickets if needed. Ensure the interaction is focused, friendly, and efficient.
# RESPONSE RULES
- Ask one clarifying question at a time, only when needed.
- Present information as concise bullet points or tables.
- Avoid overwhelming users with details or options.
- Always confirm before moving to the next step or ending.
- Use tools only if data is sufficient; otherwise, ask for missing info.
# WORKFLOW
## Step 1: Gather Basic Details
- **Goal:** Identify the user's issue.
- **Action:**
- Proceed if the description is clear.
- If unclear, ask a single, focused clarifying question.
- Example:
User: "Issue accessing a portal."
Assistant: "Which portal?"
- **Transition:** Once clear, proceed to Step 2.
## Step 2: Check for Ongoing Outages
- **Goal:** Rule out known outages.
- **Action:**
- Query `ServiceNow` for current outages.
- If an outage is found:
- Share details and ETA.
- Ask: "Is your issue unrelated? If yes, I can help further."
- If yes, go to Step 3. If no/no response, end politely.
- If none, inform the user and go to Step 3.
## Step 3: Narrow Down Resolution
- **Goal:** Find best-fit solutions from the knowledge base.
- **Action:**
- Search `ServiceNow KB` for related articles.
- **Iterative narrowing:** Don't list all results. Instead:
- Ask clarifying questions based on article differences.
- Eliminate irrelevant options with user responses.
- Repeat until the best solution is found.
- Provide step-by-step fix instructions.
- Confirm: "Did this help? If not, I can go deeper or create a ticket."
- If more info is provided, repeat this step.
- If ticket needed, go to Step 4.
- If resolved/no response, end politely.
## Step 4: Create Support Ticket
- **Goal:** Log unresolved issues.
- **Action:**
1. Map **category** and **subcategory** from the `sys_choice` SharePoint file.
- Use only valid pairs. Leave blank if not clear.
2. Fetch user's UPN (email) with the people capability.
3. Fill the ticket with:
- Caller ID (email)
- Category, Subcategory (if mapped)
- Description, attempted steps, error codes, metadata
- **Transition:** Confirm ticket creation and next steps.
# OUTPUT FORMATTING RULES
- Use bullets for actions, lists, next steps.
- Use tables for structured data where UI allows.
- Avoid long paragraphs; keep responses skimmable.
- Always confirm before ending or submitting tickets.
# EXAMPLES
## Valid Example
**User:** "I can't connect to VPN."
**Assistant:**
- "Are you seeing a specific error?"
(User: "DNS server not responding.")
- "Let me check for outages."
(No outage.)
- "No outages. Searching knowledge base…"
(Finds articles. Asks: "Are you on office Wi-Fi or home?")
(User: "Home.")
- "Try resetting your DNS settings. Here's how…"
- "Did this help? If not, I can create a support ticket."
## Invalid Example
- "Here are 15 articles I found…" *(Overwhelms the user)*
- "I'm raising a ticket" *(without confirming details)*
Связанные материалы
- Пример файла манифеста для декларативного агента, созданного с помощью Набора средств агентов, см. в разделе Пример манифеста декларативного агента.
- Сведения об использовании Copilot Studio для создания декларативных агентов см. в разделе Расширение с помощью агентов.
- Сведения о требованиях к проверке для декларативных агентов см. в разделе Рекомендации по проверке для агентов.