Создание семантического обогащения

Перед созданием обогащения

Определите тип контекста, который вы хотите предоставить:

• Определяете бизнес-термин или показатель?
• Вы объясняете, как что-то вычислить?
• Предоставляете ли вы рекомендации по качеству данных для определенного поля?
• Вы описываете взаимосвязь между объектами?
• Вы устанавливаете фильтр или условие по умолчанию?

Это помогает определить нужную область (пространство данных, объект или поле) и способ выражения оператора пополнения.

Создание обогащения

1. Перейдите в списковое представление «Семантическое пополнение».
2. Нажмите «Создать семантическое пополнение».
3. Введите имя, четко определяющее цель пополнения. Пример: "Активное определение клиента" или "Руководство по полю дохода".
4. Выберите «Область»:
   • Объект: Применяется к определенному объекту озера данных (DLO) или объекту модели данных (DMO). Используется для объектных рекомендаций.
   • Поле: Применяется к определенному полю в объекте. Используется для толкования на уровне поля.
5. Если вы выбрали область «Объект» или «Поле», выберите целевой объект или поле в раскрывающемся списке.
6. В поле «Семантическое утверждение» напишите обогащение четким и простым языком. Определите время и способ применения правила. Вы можете написать многопредложенные дополнения для сложных бизнес-правил. Примеры.
   • «Активные клиенты — это клиенты со статусом = «Активный» и как минимум один заказ за последние 90 дней».
   • "Используйте amount_usd__c для вычисления дохода. Это поле представляет размер сделки в долларах США".
   • «При фильтрации электронного_адреса всегда используйте сравнения в нижнем регистре, поскольку некоторые устаревшие данные содержат смешанные значения обращений».
   • «Ценные возможности определяются как amount_usd__c больше $100 000, и этап равен либо 'Предложение', либо 'Переговоры'. Для регионального анализа используйте поле region__c, а не состояние адреса выставления счета. Архивные ценные возможности до 2023 года использовали другой порог в $50 000 из-за поправок на инфляцию".
7. (Дополнительно) Добавьте теги для систематизации связанных пополнений. Используйте последовательные теги, например, «доход», «клиентская сегментация» или «качество данных», чтобы упростить поиск пополнений и управление ими. Теги предназначены только для организации и не влияют на извлечение агентом пополнений.
8. (Дополнительно) Установите флажок «Критически важно», всегда ли агент должен учитывать это обогащение. Используйте его для базовых бизнес-правил или ограничений качества данных. Пометка слишком большого количества обогащений как критических приводит к вздутию контекста и замедляет запросы, поэтому используйте его экономно.
9. (Дополнительно, но рекомендуется) Добавьте резюме поиска для улучшения семантического поиска пополнения. Ниже указаны ключевые слова или фразы, которые должны отображаться в вопросах пользователей. Например, если семантическое оператор определяет значение срока действия клиента, добавьте сводки поиска, например, "CLV" и "значение срока действия клиента".
10. Нажмите кнопку Сохранить.

Написание эффективных смысловых операторов

Семантическое утверждение обучает агента, как превратить обычный вопрос в правильный запрос к вашим данным. Каждое эффективное утверждение отвечает на три вопроса:

• Какое правило? Инструкция, которой должен следовать агент.
• Почему он существует? Рассуждения, лежащие в основе этого.
• Что будет, если его пропустить? Неправильный ответ, который вы пытаетесь предотвратить.

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

• Слабое (только правило): "Всегда фильтруйте «Статус» = «Активно»."
• Сильный (правило, аргументация и следствие): "Всегда фильтруйте статус = "Активно" по каждому запросу. Таблица сохраняет активные и архивные записи клиентов. Без этого фильтра результаты смешиваются в архивных клиентах, которые больше не актуальны. Это применимо, даже если пользователь спрашивает об одном названном клиенте".

При написании заявления придерживайтесь следующих рекомендаций:

Конкретно

Вместо «Использовать поле дохода» напишите «Использовать amount_usd__c для расчета дохода, поскольку оно представляет размер сделки в долларах США и постоянно заполняется».

Объясните причину

Не просто укажите правило — объясните причину. "Фильтрация по статусу = "Активно", поскольку неактивные клиенты не должны отображаться в отчетах."

Использовать примеры

При определении расчетов отобразите формулу или логику. "Значение срока действия клиента = total_revenue / months_active * average_customer_lifespan_months."

Состояние четко

Если правило применяется только в определенных случаях, укажите, когда. "Для запросов возможности исключите этап = 'Закрыто и не реализовано', если нет явного запроса."

Избегайте жаргона

Напишите простым языком, который может анализировать агент. Если вы должны использовать термины домена, определите их.

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

• Одно правило на оператор. Не сочетайте несвязанные правила. Когда агент извлекает оператор, он извлекает его целиком, поэтому оператор, охватывающий пять тем, добавляет четыре неактуальных правила при каждом совпадении.
• Начните с правила, потом объясните причину. Сперва изложите инструкцию, потом мотивировку, потом следствие неправильной ошибки.
• Скажи, что не делать. Если два поля или значения легко спутать, назовите неправильный. «Никогда не используйте дату отправки для вопросов дохода» так же важно, как и присвоение имени нужному полю.
• Произнесите значения, которые агент не может угадать. Агент видит имена полей, а не значения внутри них. Допустимый набор, если он короткий и неочевидный.
• Уточнение форматов и единиц. Если число сохраняется в виде множителя, процента или, например, в центах. В противном случае "меньше 2x" или "более 50%" будет неправильно прочитано.
• Прикрепите каждое утверждение к самой узкой правильной цели. Правило об одном поле принадлежит этому полю. Правило, охватывающее несколько полей, принадлежит объекту. Таким образом, несвязанные вопросы остаются чистыми и в нужное время появляется соответствующее правило.
• Использовать «Критически важно» только для правил, применимых почти к каждому вопросу. Всегда применяется критическое утверждение. Некритические утверждения извлекаются только в том случае, если вопрос соответствует их сводкам поиска. Зарезервируйте значение «Критично» для универсальных правил и сохраните количество малых.
• Резюме поиска должно быть написано словами, которые пользователи вводят. Ниже указаны триггерные фразы, которые отображают некритическое утверждение. Рекомендуем использовать реальные формулировки, синонимы и сокращения, а не технические описания.

Типы контекста для добавления

Семантические операторы могут собирать разные типы бизнес-контекста. Распространенные типы включают:

Тестирование обогащения

После создания обогащения протестируйте его, задав агенту вопрос, который должен его запустить. Просмотрите ответ агента и просмотрите раздел «Просмотр дополнительных сведений», чтобы проверить правильность применения обогащения. Если агент не использовал обогащение должным образом:

• Убедитесь, что пополнение является активным.
• Проверьте соответствие области (пространство данных, объект или поле) вашему вопросу.
• Измените семантическое утверждение для уточнения или добавления соответствующих тегов.
• Если обогащение является основополагающим, пометьте его как критическое.

Следующие действия

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