Objetivos do aprendizado

Quando terminar o tutorial, você entenderá como:

• Crie um projeto de Recuperação de documento no Discovery..
• Faça upload de documentos PDF para seu projeto e aplique um modelo Smart Document Understanding treinado pelo usuário aos seus PDFs.
• Conecte seu projeto Discovery a uma instância de serviço NeuralSeek. NeuralSeek é um mecanismo de geração de resposta desenvolvido com IA
• Crie um assistente no watsonx Assistant e aplique uma integração NeuralSeek nele.
• Inclua uma ação em seu watsonx Assistant que se conecta ao NeuralSeek para obter respostas.
• Use seu assistente para responder perguntas sobre Discovery.

NeuralSeek é um produto de terceiros fornecido por um fornecedor externo à IBM e está sujeito a um contrato separado entre você e o terceiro, caso aceite seus termos. A IBM não é responsável pelo produto e não assume nenhum compromisso de privacidade, segurança, desempenho, suporte ou outros compromissos relacionados ao produto.

Obter a documentação do produto

Para usar a documentação do produto Discovery como nossa base de conhecimento, faremos download da documentação do produto como um arquivo PDF.

1. Em um navegador da web, acesse o site de documentação do produto.

   https://cloud.ibm.com/docs/discovery-data
   

2. No painel do índice, clique no ícone do menu overflow na seção Guia do produto e, em seguida, escolha Visualizar como PDF.

3. Salve o arquivo PDF em seu sistema clicando no ícone Salvar no cabeçalho da página.

4. Use um editor de arquivo PDF para dividir o documento PDF em dois arquivos PDF separados de tamanho semelhante

   Dividir o PDF cria dois arquivos menores que podem ser enriquecidos mais rapidamente no Discovery.

Criar um projeto de Recuperação de Documento..

Agora que você tem a cópia mais recente da documentação do produto, inclua-a em um projeto Discovery como sua origem de dados.

No Discovery, você criará um tipo de projeto Recuperação de documento. Os documentos que você inclui em um projeto desse tipo são automaticamente enriquecidos das seguintes maneiras:

• Entidades, como substantivos próprios, são identificadas e identificadas.
• Partes do discurso são identificadas e marcadas.

Essas informações marcadas são usadas posteriormente quando uma frase de língua natural é enviada como uma consulta de procura para retornar uma resposta precisa

1. Abra uma nova página do navegador da Web

2. Na página de serviço do plano do Discovery Plus na IBM Cloud, clique em Ativar Discovery.

3. Na página Meus projetos, clique em Novo projeto.

4. Nomeie seu projeto Discovery documentation e, em seguida, clique no bloco Recuperação de documento.

   

   de tipo de projeto*

5. Clique em Avançar.

Você configurará a origem de dados para o projeto na próxima etapa

Fazer upload de dados para o projeto

Inclua os PDFs de documentação no projeto Discovery.

1. Na página Selecionar origem de dados clique no ladrilho Fazer upload de dados e, em seguida, em Avançar.

   {: caption="de fontes de dadosCriando uma coleção a partir de " caption-side="bottom"} carregados

2. Nomeie a coleção Documentos de descoberta parte 1e, em seguida, clique em Avançar.

3. Clique em Arrastar e soltar arquivos aqui ou fazer upload e, em seguida, navegue para incluir o primeiro arquivo PDF criado anteriormente.

4. Clique em Finish.

   Seu arquivo é processado conforme é incluído na coleção.

5. No painel de navegação, clique em Gerenciar coleções e, então, clique em Nova coleção.

   

6. Repita as etapas anteriores para incluir o segundo arquivo PDF como uma coleta denominada Discovery docs part 2.

Após os dados serem transferidos por upload, eles serão processados e indexados pelo Discovery. Enquanto os dados estão sendo processados, vamos criar nosso assistente virtual.

Criar um assistente

Para este tutorial, você criará um assistente com uma única ação Primeiro, deve-se criar uma instância de serviço do watsonx Assistant.

As instâncias de serviço do plano Lite e do plano Trial watsonx Assistant estão disponíveis sem custo. Você criará um plano de Avaliação..

1. Em uma nova guia do navegador da web, retorne ao catálogo do IBM Cloud.

   Mantenha a página Discovery aberta em uma guia separada, para que seja possível alternar entre os dois aplicativos.

2. Na página de recurso watsonx Assistant no catálogo do IBM Cloud, crie uma instância de serviço watsonx Assistant do plano de avaliação no local de Dallas.

3. Na página de serviço do plano do watsonx Assistant no IBM Cloud, clique em Ativar watsonx Assistant

   A interface com o usuário do produto watsonx Assistant é exibida na qual é possível criar seu primeiro assistente.

4. Inclua Discovery expert como o nome do assistente e, em seguida, clique em Avançar.

5. Se for solicitado que você compartilhe informações sobre você e seu assistente, preencha os campos obrigatórios e clique em Avançar.

   Ao criar um assistente, um aplicativo de bate-papo da web é criado automaticamente.

6. Clique em Criar para criar o assistente e o aplicativo de bate-papo da web correspondente

Após uma mensagem de parabéns, a página inicial para seu novo assistente é exibida.

Antes de adicionar qualquer coisa ao nosso novo assistente, vamos verificar o status de nossos dados.

Prepare seus dados para recuperação

Para melhorar a capacidade de recuperação das informações nos arquivos PDF, você dividirá os arquivos PDF em muitos documentos menores. Para fazer isso, primeiro você ensinará o Discovery sobre a estrutura de seus arquivos PDF, para que ele entenda como as subseções são formatados e pode dividir o documento por subseção

1. Retorne à guia do navegador da web na qual seu projeto Discovery é exibido.

   A página Melhorar e customizar para o último arquivo PDF transferido por upload é exibida.

2. No painel Ferramentas de melhoria, expanda Definir estruturae, em seguida, clique em Novos campos.

   

3. Escolha a coleção Documentos de descoberta parte 1.

   A guia Identificar campos é exibida, na qual é possível escolher o tipo de modelo Smart Document Understanding que você deseja usar.

4. Clique em Modelos treinados pelo usuário, em seguida, clique em Enviar.

   

   treinado pelo usuário*

5. Clique em Aplicar mudanças e processar novamente.

   Após ocorrer algum processamento, uma representação do documento é exibida na ferramenta Smart Document Understanding. A ferramenta mostra uma visualização do documento original juntamente com uma representação do documento, onde o texto é substituído por blocos. Os blocos representam os tipos de campo

   Inicialmente, os blocos são rotulados como text porque todo o conteúdo do documento é considerado texto padrão por padrão e é indexado no campo text.

   Queremos rotular todos os títulos de primeiro e de segundo nível como legendas em vez de texto.

6. Na visualização de miniaturas, clique na miniatura para a primeira página de texto completa do documento para abrir a primeira página com conteúdo real.

   

   de compreensão de documentos inteligentes*

7. Para anotar o documento, clique no rótulo subtitle na lista de Rótulos de campo Em seguida, clique em cada bloco na representação da página PDF que representa um título para alterar seu rótulo de text para subtitle

   

8. Depois que cada subtítulo na página atual for rotulado, clique em Enviar página

   A próxima página do arquivo PDF é exibida.

   

9. Repita esse processo até que a ferramenta seja capaz de rotular os títulos corretamente para você de maneira consistente quando novas páginas forem carregadas na ferramenta. Nesse ponto, clique em Aplicar mudanças e reprocessar

   Parabéns! Você treinou com sucesso um modelo de Smart Document Understanding (SDU) que pode reconhecer legendas em seus documentos. Vamos aplicar o mesmo modelo ao outro arquivo PDF que você incluiu no projeto.

10. Na barra de ferramentas do editor SDU, clique no ícone do menu overflow no cabeçalho da página e escolha Exportar modelo.

11. Salve o arquivo .sdumodel em seu sistema em um local no qual seja possível acessá-lo novamente em breve

12. No painel de navegação, clique em Gerenciar coleções e, em seguida, abra a coleção Discovery docs part 2.

13. Abra a guia Identificar campos.

14. Clique em Modelos treinados pelo usuário, em seguida, clique em Enviar.

15. Clique em Aplicar mudanças e processar novamente.

16. Na barra de ferramentas do editor SDU, clique no ícone do menu overflow e escolha Importar modelo e, em seguida, clique em Selecionar modelo.

17. Procure o arquivo .sdumodel que você transferiu por download anteriormente e, em seguida, clique em Abrir.

18. Clique em Aplicar mudanças e reprocessar para aplicar o mesmo modelo SDU à primeira coleção.

Discovery reprocessa os dados em seu índice para identificar subtítulos nos documentos. Enquanto os dados estão sendo reprocessados, vamos criar nosso gerador de respostas.

Criar uma instância de serviço NeuralSeek

É possível usar uma extensão de procura no watsonx Assistant para conectar seu assistente diretamente ao Discovery e retornar passagens diretamente da origem de dados. No entanto, incluiremos o serviço NeuralSeek entre watsonx Assistant e Discovery neste tutorial. NeuralSeek recupera as passagens de Discovery e, em seguida, as converte em respostas que parecem mais conversacionais.

1. Em uma nova guia do navegador da web, retorne ao catálogo do IBM Cloud.

   Mantenha as páginas para os outros serviços abertos em guias separadas, para que seja possível alternar entre as diferentes instâncias de serviço..

2. Na página de recurso NeuralSeek no catálogo IBM Cloud, crie uma instância de serviço do plano Lite.

3. Na página Configurar, inclua detalhes sobre sua instância de serviço Discovery e customize a conexão.

   • Você pode obter o URL do serviço e a chave da API na página de detalhes da instância do serviço Discovery em IBM Cloud.
   • O ID do projeto está disponível na interface com o usuário do IBM Cloud. Para obtê-lo, clique em Integrar e implementar no painel de navegação. Abra a página Informações da API e, em seguida copie o ID do projeto.
   • Configure o intervalo de escore do documento para 50%
   • Altere o tamanho do caractere de fragmento para 400..
   • Especifique sua empresa como nome de exibição da empresa.
   • Altere a porcentagem de confiabilidade mínima para 50

   Clique em Salvar.

Dividir seus documentos em PDF

Agora que as legendas estão indexadas corretamente no Discovery, use-as como a base para dividir os arquivos PDF em muitos documentos menores.

1. Retorne à guia do navegador da web na qual seu projeto Discovery é exibido.

2. Abra a guia Gerenciar campos para a coleção atual

3. No campo Dividir documento em cada ocorrência de, escolha subtítulo e clique em Aplicar mudanças e reprocessar.

   

4. No painel de navegação, clique em Gerenciar coleções e, em seguida, abra a outra coleção

5. Acesse a página Gerenciar campos e, em seguida, escolha subtítulo no campo Dividir documento em cada ocorrência de..

6. Clique em Aplicar mudanças e processar novamente.

As coleções começam a ser reprocessadas.. Após a reindexação ser concluída, em vez de conter um documento cada, as coleções conterão várias centenas de documentos cada.

Enquanto o índice está sendo reconstruído, vamos deixar nosso assistente pronto.

Adicione uma extensão ao seu assistente

Conecte seu assistente à instância de serviço do NeuralSeek.

1. Reabra o serviço NeuralSeek do IBM Cloud. É possível localizar a instância na seção AI e Machine Learning de sua lista de recursos.

2. Clique na guia Integrar e siga as instruções para configurar a extensão customizada do NeuralSeek para seu assistente. Retorne a esse procedimento quando você estiver pronto para criar a ação.

   

   da instância*

3. No painel de navegação do watsonx Assistant, clique em Ações e, em seguida, clique em Nova ação.

4. Escolha Iniciação rápida de modelos e, em seguida, role para localizar e clique no NeuralSeek Kit do Iniciador.

   

5. Clique em Selecionar este kit do iniciador e, em seguida, clique em Incluir modelos.

6. Clique para abrir a ação NeuralSeek search que você acabou de incluir no assistente

7. Inclua as consultas de exemplo do usuário a seguir na primeira etapa na ação:

   What Watson Discovery project types are available and what do they do?
   

   What external data sources are supported by Watson Discovery?
   

   Can I add a custom dictionary to Watson Discovery?
   

   How do I use the Content Mining application?
   

   When should I add query expansions to my project?
   

   Which file types support Smart Document Understanding models?
   

   Can I enable optical character recognition for all file types?
   

   Does my data have to be written in English?
   

   watsonx Assistant usa as perguntas de amostra para reconhecer os tipos de perguntas do usuário que ele deve rotear para essa ação.

8. Clique para abrir a Etapa 3 para edição..

   Na seção E, em seguida,, clique em Editar extensão

   Escolha NeuralSeek e clique em Aplicar.

   

9. Clique para abrir a Etapa 6 para edição

   Esta etapa mostra um link no qual os usuários podem clicar para obter mais informações Queremos que esse link acesse diretamente a documentação do produto no site IBM Cloud Docs.

   Altere a referência de hipertexto no elemento HTML de âncora para conter o seguinte URL:

   <a href="https://cloud.ibm.com/docs/discovery-data?topic=discovery-data-about" target="_blank">
   

   : caption="Change the URL for the More information link" caption-side="bottom"}

10. Salve suas mudanças e, em seguida, clique no X para fechar a etapa.

Parabéns! Você criou com sucesso uma ação que reconhece perguntas sobre Discoverye obtém suas respostas da extensão NeuralSeek conectada.

Configure o bate-papo da web para seu assistente

Para visualizar seu assistente, você usará o bate-papo da web integrado como a interface com o usuário do bate-papo para interagir com o assistente..

1. No painel de navegação no watsonx Assistant, clique em Ambientes.

   O ambiente de rascunho é exibido.. Ele mostra que um bate-papo da web está conectado ao seu assistente Também é possível ver que o bate-papo da web está conectado à extensão NeuralSeek

   

2. Clique no bloco Bate-papo da web para editar o bate-papo da web.

   Não queremos adicionar várias perguntas iniciais, então vamos desligar a tela inicial para o bate-papo da web. Clique na guia Tela inicial. Configure o alternador como Desligado e, em seguida, clique em Salvar e sair

   

Você está pronto para visualizar seu assistente!

Visualize o assistente

Para visualizar um assistente que se conecta aos dados armazenados no Discovery, deve-se visualizar o assistente na página Ambientes. Quando você visualiza o bate-papo da web de forma independente, o assistente não é capaz de recuperar dados do Discovery; ele precisa que os recursos do ambiente possam se conectar ao Discovery.

1. Na página Ambientes, clique em Visualizar este ambiente

   É exibida uma página da web de amostra que inclui um ícone de bate-papo .

2. Clique no ícone de bate-papo para abrir a janela de bate-papo na Web.

   

3. Insira a seguinte pergunta de texto:

   What project types are available?
   

   A resposta correta é retornada e ela inclui um link para a documentação do produto

   

   da pesquisa*

4. Envie uma pergunta que não foi usada como um exemplo de consulta ao criar a ação.

   How do you define synonyms in Watson Discovery?
   

   Uma resposta detalhada é retornada

   

   detalhada*

5. Opcionalmente faça outras perguntas ao assistente.

   Se o assistente não souber a resposta, reformule a pergunta para incluir "no Watson Discovery" para tornar mais claro que você está perguntando sobre como algo funciona em Discovery especificamente.

Parabéns! Você criou com sucesso um assistente que pode responder perguntas sobre o Discovery recuperando informações da documentação do produto por meio do serviço NeuralSeek.