Sessões de Depuração na IA do Azure Search
As Sessões de Depuração são um editor visual que funciona com um conjunto de habilidades existente no portal do Azure, expondo a estrutura e o conteúdo de apenas um documento enriquecido, enquanto ele é produzido por um indexador e um conjunto de habilidades, durante a sessão. Como você está trabalhando com um documento dinâmico, a sessão é interativa – você pode identificar erros, modificar e invocar a execução de habilidades e validar os resultados em tempo real. Se as alterações resolverem o problema, você poderá confirmá-las em um conjunto de habilidades publicado para aplicar as correções globalmente.
Como uma sessão de depuração funciona
Quando você inicia uma sessão, o serviço de pesquisa cria uma cópia do conjunto de habilidades, do indexador e de uma fonte de dados que contém um único documento usado para testar o conjunto de habilidades. O estado da sessão é salvo em um novo contêiner de blob criado pelo serviço da IA do Azure Search em uma conta de Armazenamento do Azure que você fornece. O nome do contêiner gerado tem um prefixo de "ms-az-cognitive-search-debugsession". O prefixo é necessário porque reduz a chance de exportar os dados de sessão acidentalmente para outro contêiner na sua conta.
Uma cópia armazenada em cache do documento enriquecido e do conjunto de habilidades é carregada no editor visual para que você possa inspecionar o conteúdo e os metadados do documento enriquecido, com a capacidade de verificar cada nó do documento e editar qualquer aspecto da definição do conjunto de habilidades. Todas as alterações feitas dentro da sessão são armazenadas em cache. Essas alterações não afetarão o conjunto de habilidades publicado, a menos que você as confirme. A confirmação das alterações substituirá o conjunto de habilidades de produção.
Se o pipeline de enriquecimento não tiver erros, uma sessão de depuração poderá ser usada para enriquecer um documento de forma incremental, testar e validar cada alteração antes de confirmar as alterações.
Como gerenciar o estado da sessão de depuração
Você pode executar novamente uma sessão de depuração usando o botão Iniciar ou cancelar uma sessão em andamento usando o botão Cancelar.
Guia Enriquecimentos de IA > Gráfico de Habilidades
O editor visual é organizado em guias e painéis. Esta seção apresenta os componentes do editor visual.
O Gráfico de Habilidades fornece uma hierarquia visual do conjunto de habilidades e sua ordem de execução de cima para baixo. As habilidades que dependem da saída de outras habilidades são posicionadas mais abaixo no gráfico. As habilidades no mesmo nível na hierarquia podem ser executadas em paralelo. Os rótulos com codificação por cores das habilidades no gráfico indica os tipos de habilidades que estão sendo executadas no conjunto de habilidades (TEXTO ou VISÃO).
Selecionar uma habilidade no gráfico exibirá os detalhes dessa instância da habilidade no painel direito, incluindo a definição, os erros ou avisos e o histórico de execução dela. O Gráfico de Habilidades é onde você selecionará qual habilidade depurar ou aprimorar. No painel de detalhes à direita, você edita e explora.
Painel de detalhes da habilidade
Quando você seleciona um objeto no Gráfico de Habilidades, o painel adjacente fornece áreas de trabalho interativas em um layout com guias. Uma ilustração do painel de detalhes pode ser encontrada na captura de tela anterior.
Os detalhes da habilidade incluem as seguintes áreas:
- Configurações da Habilidade mostra uma versão formatada da definição da habilidade.
- Editor JSON da Habilidade mostra o documento JSON bruto da definição.
- As execuções mostram os dados correspondentes a cada vez que uma habilidade foi executada.
- Erros e avisos mostra as mensagens geradas após o início ou a atualização da sessão.
Em Execuções ou Configurações da Habilidade, selecione o símbolo </> para abrir o Avaliador de Expressão usado para exibir e editar as expressões das entradas e saídas das habilidades.
Os controles de entrada aninhados nos Configurações da Habilidade podem ser usados para criar formas complexas para projeções, mapeamentos de campo de saída para um campo de tipo complexo ou uma entrada para uma habilidade. Quando usadas com o Avaliador de Expressão, as entradas aninhadas fornecem um construtor de expressões para testar e validar com facilidade.
Painel Execuções
Uma habilidade pode ser executada várias vezes em um conjunto de habilidades para um único documento. Por exemplo, a habilidade de OCR será executada uma vez para cada imagem extraída de um documento. O painel Execuções exibe o histórico de execuções da habilidade, fornecendo uma análise mais profunda de cada invocação da habilidade.
O histórico de execução permite controlar um enriquecimento específico de volta para a habilidade que o gerou. Clicar em uma entrada de habilidade navega para a habilidade que gerou essa entrada, fornecendo um recurso semelhante a um rastreamento de pilha. Isso permite a identificação da causa raiz de um problema que pode ser manifestado em uma habilidade de downstream.
Ao depurar um erro com uma habilidade personalizada, há a opção de gerar uma solicitação para uma invocação da habilidade no histórico de execuções.
Guia Enriquecimentos de IA > Estrutura de Dados Enriquecidos
O painel de Estrutura de Dados Enriquecidos mostra os aprimoramentos do documento por meio do conjunto de habilidades, detalhando o contexto de cada enriquecimento e a habilidade de origem. O Avaliador de Expressão também pode ser usado para exibir o conteúdo de cada enriquecimento.
Avaliador de expressão
O Avaliador de Expressão oferece uma visão rápida do valor de qualquer caminho. Ele permite editar o caminho e testar os resultados antes de atualizar qualquer uma das entradas ou o contexto de uma habilidade ou projeção.
Você pode abrir a janela em qualquer nó ou elemento que mostre o símbolo </>, incluindo partes de um grafo de dependência ou nós em uma árvore de enriquecimento.
O Avaliador de Expressão fornece acesso interativo completo para testar o contexto, as entradas e verificar as saídas da habilidade.
Próximas etapas
Agora que você entende os elementos das sessões de depuração, inicie sua primeira sessão de depuração em um conjunto de habilidades existente.