Depurar sessões na Pesquisa de IA do Azure
Debug Sessions é um editor visual que trabalha com um conjunto de habilidades existente no portal do Azure, expondo a estrutura e o conteúdo de um único documento enriquecido, pois é produzido por um indexador e conjunto de habilidades durante a sessão. Como você está trabalhando com um documento ao vivo, 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á vinculá-las a um conjunto de habilidades publicado para aplicar as correções globalmente.
Como funciona uma sessão de depuração
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 contendo um único documento usado para testar o conjunto de habilidades. Todo o estado da sessão é salvo em um novo contêiner de blob criado pelo serviço Azure AI 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 acidentalmente dados de sessão para outro contêiner em sua conta.
Uma cópia 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 aspeto 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 cometa. A confirmação de 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 pode ser usada para enriquecer incrementalmente um documento, testar e validar cada alteração antes de confirmar as alterações.
Gerenciando 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 Enriquecedores > de IA Gráfico de Habilidades
O editor visual está organizado em separadores 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 produção de outras habilidades são posicionadas mais abaixo no gráfico. Habilidades no mesmo nível na hierarquia podem ser executadas em paralelo. Rótulos codificados por cores de habilidades no gráfico indicam 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 sua definição, erros ou avisos e histórico de execução. O Gráfico de Habilidades é onde você selecionará qual habilidade depurar ou aprimorar. O painel de detalhes à direita é onde você edita e explora.
Painel de detalhes de habilidades
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 das habilidades incluem as seguintes áreas:
- Configurações de habilidade mostra uma versão formatada da definição de habilidade.
- Skill JSON Editor mostra o documento JSON bruto da definição.
- Execuções mostra os dados correspondentes a cada vez que uma habilidade foi executada.
- Erros e avisos mostra as mensagens geradas no início ou atualização da sessão.
Em Execuções ou Configurações de Habilidades, selecione o símbolo para abrir o </>Avaliador de Expressões usado para visualizar e editar as expressões das entradas e saídas de habilidades.
Os controles de entrada aninhados em Configurações de 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ões, as entradas aninhadas fornecem um construtor de expressões fácil de testar e validar.
Painel Execuções
Uma habilidade pode ser executada várias vezes em um conjunto de habilidades para um único documento. Por exemplo, a habilidade OCR será executada uma vez para cada imagem extraída de um único documento. O painel Execuções exibe o histórico de execução da habilidade, fornecendo uma visão mais profunda de cada invocação da habilidade.
O histórico de execução permite rastrear um enriquecimento específico de volta à habilidade que o gerou. Clicar em uma entrada de habilidade navega até a habilidade que gerou essa entrada, fornecendo um recurso semelhante ao rastreamento de pilha. Isso permite identificar a causa raiz de um problema que pode se manifestar em uma habilidade a jusante.
Quando você depura um erro com uma habilidade personalizada, há a opção de gerar uma solicitação para uma invocação de habilidade no histórico de execução.
Guia > Enriquecimento de IA Estrutura de dados enriquecida
O painel Estrutura de Dados Enriquecida mostra o enriquecimento 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 visualizar o conteúdo de cada enriquecimento.
Avaliador de Expressão
O Avaliador de Expressões dá uma espiada rápida no valor de qualquer caminho. Ele permite editar o caminho e testar os resultados antes de atualizar qualquer uma das entradas ou contexto para uma habilidade ou projeção.
Você pode abrir a janela de qualquer nó ou elemento que mostre o </> símbolo, incluindo partes de um gráfico de dependência ou nós em uma árvore de enriquecimento.
O Avaliador de Expressões oferece acesso interativo completo para testar o contexto de habilidades, entradas e verificar saídas.
Próximos passos
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.