Отладка сеансов в поиске ИИ Azure

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

В этой статье объясняется, как организован редактор. Вкладки и разделы редактора распаковывать различные слои набора навыков, чтобы можно было изучить структуру набора навыков, поток и содержимое, которое он создает во время выполнения.

Как работает сеанс отладки

При запуске сеанса служба поиска создает копию набора навыков, индексатора и источника данных, содержащего один документ, используемый для тестирования набора навыков. Все состояние сеанса сохраняется в новом контейнере BLOB-объектов, созданном служба Azure AI в предоставленной учетной записи служба хранилища Azure. Имя созданного контейнера имеет префикс ms-az-cognitive-search-debugsession. Префикс необходим, так как он снижает вероятность случайного экспорта данных сеанса в другой контейнер в вашей учетной записи.

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

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

Вкладка > "Обогащение ИИ"

Визуальный редактор упорядочивается на вкладки и панели. В этом разделе представлены компоненты визуального редактора.

Диаграмма навыков предоставляет визуальную иерархию набора навыков и его порядок выполнения сверху вниз. Навыки, зависящие от выходных данных других навыков, расположены ниже в графе. Навыки, находящиеся на одном уровне иерархии, могут выполняться параллельно. Цветовые метки навыков в графе указывают типы навыков, которые выполняются в наборе навыков (TEXT или VISION).

Граф навыков — это место, в котором вы выбираете навык для отладки или улучшения. Область сведений справа находится в том месте, где вы редактируете и просматриваете.

Область сведений о навыке

Сведения о навыке представлены в макете с вкладками и включают следующие области:

• Параметры навыка: отформатированная версия определения навыка.
• Редактор JSON навыка: необработанный документ JSON определения.
• Выполнение: данные, соответствующие каждому выполнению навыка.
• Ошибки и предупреждения: сообщения, созданные при запуске или обновлении сеанса.

В параметрах выполнения или навыков выберите </> символ, чтобы открыть средство оценки выражений, используемое для просмотра и редактирования выражений входных и выходных данных навыков.

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

Область выполнения

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

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

При отладке ошибки с пользовательским навыком можно создать запрос на вызов навыка в журнале выполнения.

Вкладка > обогащения ИИ обогащения обогащения

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

Вычислитель выражений

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

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

Средство оценки выражений предоставляет полный интерактивный доступ для тестирования контекста навыка, входных данных и проверки выходных данных.

Следующие шаги

Теперь, когда вы понимаете элементы сеансов отладки, запустите первый сеанс отладки в существующем наборе навыков.

Отладка набора навыков