Sesiones de depuración en Azure AI Search
Debug Sessions es un editor visual que funciona con un conjunto de aptitudes existente en Azure Portal, que expone la estructura y el contenido de un único documento enriquecido, tal como lo genera un indexador y un conjunto de aptitudes, durante la sesión. Dado que se está trabajando con un documento en directo, la sesión es interactiva: puedes identificar errores, modificar e invocar la ejecución de aptitudes y validar los resultados en tiempo real. Si los cambios resuelven el problema, puede confirmarlos en un conjunto de aptitudes publicado para aplicar las correcciones globalmente.
Funcionamiento de una sesión de depuración
Al iniciar una sesión, el servicio de búsqueda crea una copia del conjunto de aptitudes, del indexador y de un origen de datos que contiene un único documento que se usa para probar el conjunto de aptitudes. Todo el estado de sesión se guarda en un nuevo contenedor de blobs creado por el servicio Azure AI Search en una cuenta de Azure Storage que proporciones. El nombre del contenedor generado tiene un prefijo de "ms-az-cognitive-search-debugsession". El prefijo es necesario porque mitiga la posibilidad de exportar accidentalmente los datos de sesión a otro contenedor de la cuenta.
Se carga una copia en caché del documento enriquecido y del conjunto de aptitudes en el editor visual para que pueda inspeccionar el contenido y los metadatos del documento enriquecido, con la capacidad de comprobar cada nodo de documento y editar cualquier aspecto de la definición del conjunto de aptitudes. Los cambios realizados dentro de la sesión se almacenan en caché. Estos cambios no afectarán al conjunto de aptitudes publicado a menos que los confirme. Al confirmar los cambios, se sobrescribirá el conjunto de aptitudes de producción.
Si la canalización de enriquecimiento no tiene errores, se puede usar una sesión de depuración para enriquecer incrementalmente un documento, y probar y validar cada cambio antes de confirmarlo.
Administración del estado de la sesión de depuración
Puedes volver a ejecutar una sesión de depuración mediante el botón Iniciar o cancelar una sesión en curso mediante el botón Cancelar.
Pestaña AI Enrichments (Enriquecimientos con IA) > Skill Graph (Gráfico de aptitudes)
El editor visual se organiza en pestañas y paneles. En esta sección se presentan los componentes del editor visual.
El gráfico de aptitudes proporciona una jerarquía visual del conjunto de aptitudes y su orden de ejecución de arriba a abajo. Las aptitudes que dependen de la salida de otras aptitudes se muestran en un nivel inferior del gráfico. Las aptitudes del mismo nivel en la jerarquía se pueden ejecutar en paralelo. Las etiquetas codificadas por colores de las aptitudes en el gráfico indican los tipos de aptitudes que se ejecutan en el conjunto de aptitudes (TEXT o VISION).
Al seleccionar una aptitud en el grafo, se mostrarán los detalles de esa instancia de la aptitud en el panel derecho, incluida su definición, errores o advertencias y el historial de ejecución. En el gráfico de aptitudes puede seleccionar la aptitud que se depurará o mejorará. El panel de detalles de la derecha es donde se puede editar y explorar.
Panel de detalles de la aptitud
Al seleccionar un objeto en el panel Skill Graph (Gráfico de aptitudes), el panel adyacente proporciona áreas de trabajo interactivas en un diseño con pestañas. Puede encontrar una ilustración del panel de detalles en la captura de pantalla anterior.
Los detalles de la aptitud incluyen las siguientes áreas:
- Skill Settings (Configuración de aptitudes) muestra una versión con formato de la definición de aptitud.
- Editor JSON de aptitudes muestra el documento JSON sin formato de la definición.
- Ejecuciones muestra los datos correspondientes a cada vez que se ejecutó una aptitud.
- Errors and warnings (Errores y advertencias) muestra los mensajes generados al iniciar o actualizar la sesión.
En Executions (Ejecuciones) o Skill Settings (Configuración de aptitudes), seleccione el símbolo </> para abrir el evaluador de expresiones que se usa para ver y editar las expresiones de las entradas y salidas de las aptitudes.
Los controles de entrada anidados en Skill Settings (Configuración de aptitudes) se pueden usar para crear formas complejas para proyecciones, asignaciones de campos de salida para un campo de tipo complejo o una entrada a una aptitud. Cuando se usa con el Evaluador de expresiones, las entradas anidadas proporcionan una prueba sencilla y validan el generador de expresiones.
Panel Executions (Ejecuciones)
Una aptitud se puede ejecutar varias veces en un conjunto de aptitudes para un único documento. Por ejemplo, la aptitud OCR se ejecutará una vez para cada imagen extraída de un único documento. El panel Executions (Ejecuciones) muestra el historial de ejecución de la aptitud, lo que proporciona una mirada más profunda a cada invocación de la aptitud.
El historial de ejecución permite realizar el seguimiento de un enriquecimiento específico hasta la habilidad que lo generó. Al hacer clic en una entrada de aptitud, se navega a la aptitud que generó esa entrada, lo que proporciona una característica de seguimiento de pila. Esto permite la identificación de la causa principal de un problema que puede manifestarse en una aptitud de bajada.
Al depurar un error con una aptitud personalizada, existe la opción de generar una solicitud para una invocación de aptitud en el historial de ejecución.
Pestaña de enriquecimientos con IA y estructura de datos enriquecidos
En el panel Estructura de datos enriquecidos se muestran los enriquecimientos del documento mediante el conjunto de aptitudes y se detalla el contexto de cada enriquecimiento, así como la aptitud de origen. También se puede usar el evaluador de expresiones para ver el contenido de cada enriquecimiento.
Evaluador de expresiones
El evaluador de expresiones ofrece un vistazo rápido al valor de cualquier ruta de acceso. Permite editar la ruta de acceso y probar los resultados antes de actualizar cualquiera de las entradas o el contexto de una aptitud o proyección.
Puede abrir la ventana desde cualquier nodo o elemento que muestre el símbolo </>, incluidas las partes de un gráfico de dependencias o nodos de un árbol de enriquecimiento.
El evaluador de expresiones proporciona acceso interactivo completo para probar el contexto de la aptitud, las entradas y la comprobación de salidas.
Pasos siguientes
Ahora que comprende los elementos de las sesiones de depuración, inicie la primera sesión de depuración en un conjunto de aptitudes existente.