Skip to main content
O português é fornecido por meio de tradução automática para sua conveniência. O inglês precede o português em caso de inconsistências.

Gerencie os conetores do Amazon Q Business

Colaboradores netapp-mwallis
PDFs

Depois de criar um conetor para o Amazon Q Business, você pode exibir os detalhes do conetor, modificar o conetor, integrar fontes de dados adicionais ou excluir o conetor.

Exibir informações sobre um conetor

Pode visualizar informações sobre as definições de um conetor e as fontes de dados integradas.

Passos

  1. Faça login no Workload Factory usando um dos"experiências de console" .

  2. No bloco cargas de trabalho de IA, selecione Deploy & Manage.

  3. Na página de inventário Bases de conhecimento e conectores, selecione o conector que você deseja visualizar.

  4. Para ver os detalhes do conetor, o botão de opçãoselecione e selecione Manage Connector.

    Esta página exibe o status publicado, o status de incorporação das fontes de dados, o modo de incorporação, a lista de todas as fontes de dados incorporadas e muito mais.

    O menu ações permite gerenciar o conetor se você quiser fazer alterações.

Edite um conetor

Pode atualizar um conetor alterando algumas definições ou pode adicionar ou remover fontes de dados.

Sempre que você adicionar, modificar ou remover fontes de dados do conetor, o GenAI precisa enviar as informações de origem de dados para o Amazon Q Business para que elas sejam reindexadas. A sincronização é incremental, então o Amazon Q Business processa apenas os objetos no volume do FSX for ONTAP que foram adicionados, modificados ou excluídos desde a última sincronização.

Passos

  1. Faça login no Workload Factory usando um dos"experiências de console" .

  2. No bloco cargas de trabalho de IA, selecione Deploy & Manage.

  3. Na página de inventário bases de conhecimento e conetores, selecione o conetor que pretende atualizar.

  4. Selecione o botão de opção e selecione Manage Connector.

    Esta página exibe o status publicado, o status de incorporação das fontes de dados, o modo de incorporação, a lista de todas as fontes de dados incorporadas e muito mais.

  5. Selecione o menu ações e selecione Editar conetor.

  6. Na página Editar conetor, você pode alterar o nome do conetor, a descrição, o modelo de incorporação, a habilitação dos corrimões de dados e a política de snapshot usada para o volume que contém o conetor.

    Observação Toda varredura de fonte de dados, que inclui incorporação, incorre em um custo. Se você ativar os corrimões de dados depois que um conetor foi criado, a fonte de dados será digitalizada novamente e incorrerá em custos.

  7. Selecione Salvar depois de fazer alterações.

Adicione fontes de dados adicionais a um conetor

Você pode incorporar fontes de dados adicionais no seu conetor para preenchê-lo com dados adicionais da organização.

Passos

  1. Faça login no Workload Factory usando um dos"experiências de console" .

  2. No bloco cargas de trabalho de IA, selecione Deploy & Manage.

  3. A partir da página de inventário bases de dados e conetores de conhecimento, selecione o conetor onde pretende adicionar a fonte de dados.

  4. Selecione o botão de opção e selecione Adicionar fonte de dados.

  5. Selecione o tipo de fonte de dados que você deseja adicionar:

    • Adicionar FSx para sistema de arquivos ONTAP (usar arquivos de um volume FSx para ONTAP existente)

    • Adicionar sistema de arquivos (usar arquivos de um compartilhamento SMB ou NFS genérico)

Adicionar um FSx para sistema de arquivos ONTAP

  1. * Selecione um sistema de arquivos*: Selecione o sistema de arquivos FSX for ONTAP onde seus arquivos de origem de dados residem e selecione Next.

  2. Selecione um volume: Selecione o volume no qual os arquivos de origem de dados residem e selecione Next.

    Ao selecionar arquivos armazenados usando o protocolo SMB, você precisará inserir as informações do ative Directory, que incluem o domínio, o endereço IP, o nome de usuário e a senha.

  3. Selecione uma fonte de dados: Selecione a localização da fonte de dados com base no local onde você salvou os arquivos. Este pode ser um volume inteiro, ou apenas uma pasta específica ou subpasta no volume, e selecione Next.

  4. * Configurações*: Configure como a fonte de dados ingere informações de seus arquivos e quais arquivos ela inclui em varreduras:

    • Definir fonte de dados: Na seção Estratégia de Chunking, defina como o mecanismo GenAI divide o conteúdo da fonte de dados em blocos quando a fonte de dados é integrada a uma base de conhecimento. Você pode escolher uma das seguintes estratégias:

      • * Agrupamento de frases múltiplas*: Organiza informações de sua fonte de dados em blocos definidos por sentença. Você pode escolher quantas frases compõem cada pedaço (até 100).

      • * Agrupamento baseado em sobreposição*: Organiza informações de sua fonte de dados em blocos definidos por carateres que podem sobrepor blocos vizinhos. Você pode escolher o tamanho de cada pedaço em carateres, e quanto cada pedaço se sobrepõe com pedaços adjacentes. Você pode configurar um tamanho de bloco entre 50 e 3000 carateres e uma porcentagem de sobreposição entre 1 e 99%.

        Observação Escolher uma alta porcentagem de sobreposição pode aumentar significativamente os requisitos de armazenamento com apenas pequenas melhorias na precisão de recuperação.

    • * Filtragem de arquivos*: Configure quais arquivos estão incluídos nas digitalizações:

      • Na seção suporte a tipos de arquivo, escolha incluir todos os tipos de arquivos ou selecionar tipos de arquivo individuais para inclusão nas verificações de origem de dados.

        Se você incluir imagens ou arquivos PDF, o NetApp Workload Factory for GenAI analisará o texto nas imagens (incluindo imagens em documentos PDF), e isso incorrerá em um custo mais alto.

      Ao incluir dados de texto de imagens, o GenAI não consegue mascarar informações de identificação pessoal (PII) da imagem à medida que os dados de texto digitalizados são enviados do seu ambiente para a AWS. No entanto, uma vez que os dados são armazenados, todas as PII são mascaradas no banco de dados do GenAI.

    Observação Sua escolha de incluir arquivos de imagem em digitalizações está relacionada ao modelo de bate-papo da base de conhecimento. Se você incluir arquivos de imagem em digitalizações, o modelo de bate-papo deve suportar imagens. Se os tipos de arquivo de imagem estiverem selecionados aqui, você não poderá alternar a base de conhecimento para um modelo de chat que não suporte arquivos de imagem.

    • Na seção filtro de tempo de modificação de arquivo, escolha ativar ou desativar a inclusão de arquivos com base em seu tempo de modificação. Se ativar a filtragem de hora de modificação, selecione um intervalo de datas na lista.

      Observação Se você incluir arquivos com base em um intervalo de datas de modificação, assim que o intervalo de datas não for satisfeito (os arquivos não foram modificados dentro do intervalo de datas especificado), os arquivos serão excluídos da verificação periódica e a fonte de dados não incluirá esses arquivos.

  5. Na seção reconhecimento de permissão, que está disponível somente quando a fonte de dados selecionada estiver em um volume que usa o protocolo SMB, você pode ativar ou desativar respostas com reconhecimento de permissão:

    • Habilitado: Os usuários do chatbot que acessam essa base de conhecimento só receberão respostas a consultas de fontes de dados às quais têm acesso.

    • Disabled: Os usuários do chatbot receberão respostas usando conteúdo de todas as fontes de dados integradas.

  6. Selecione Add para adicionar esta fonte de dados à sua base de conhecimento.

Adicionar um sistema de arquivos NFS genérico

  1. Selecione um sistema de arquivos: insira o endereço IP ou FQDN do host do sistema de arquivos onde seus arquivos de fonte de dados residem, escolha o protocolo NFS para o compartilhamento de rede e selecione Avançar.

  2. Selecione uma fonte de dados: Selecione a localização da fonte de dados com base no local onde você salvou os arquivos. Este pode ser um volume inteiro, ou apenas uma pasta específica ou subpasta no volume, e selecione Next.

    Observação Em alguns casos, pode ser necessário inserir o nome da exportação NFS manualmente e selecionar Recuperar diretórios para exibir os diretórios disponíveis. Você pode optar por selecionar a exportação inteira ou apenas pastas específicas da exportação.

  3. * Configurações*: Configure como a fonte de dados ingere informações de seus arquivos e quais arquivos ela inclui em varreduras:

    • Definir fonte de dados: Na seção Estratégia de Chunking, defina como o mecanismo GenAI divide o conteúdo da fonte de dados em blocos quando a fonte de dados é integrada a uma base de conhecimento. Você pode escolher uma das seguintes estratégias:

      • * Agrupamento de frases múltiplas*: Organiza informações de sua fonte de dados em blocos definidos por sentença. Você pode escolher quantas frases compõem cada pedaço (até 100).

      • * Agrupamento baseado em sobreposição*: Organiza informações de sua fonte de dados em blocos definidos por carateres que podem sobrepor blocos vizinhos. Você pode escolher o tamanho de cada pedaço em carateres, e quanto cada pedaço se sobrepõe com pedaços adjacentes. Você pode configurar um tamanho de bloco entre 50 e 3000 carateres e uma porcentagem de sobreposição entre 1 e 99%.

        Observação Escolher uma alta porcentagem de sobreposição pode aumentar significativamente os requisitos de armazenamento com apenas pequenas melhorias na precisão de recuperação.

    • * Filtragem de arquivos*: Configure quais arquivos estão incluídos nas digitalizações:

      • Na seção suporte a tipos de arquivo, escolha incluir todos os tipos de arquivos ou selecionar tipos de arquivo individuais para inclusão nas verificações de origem de dados.

        Se você incluir imagens ou arquivos PDF, o NetApp Workload Factory for GenAI analisará o texto nas imagens (incluindo imagens em documentos PDF), e isso incorrerá em um custo mais alto.

      Ao incluir dados de texto de imagens, o GenAI não consegue mascarar informações de identificação pessoal (PII) da imagem à medida que os dados de texto digitalizados são enviados do seu ambiente para a AWS. No entanto, uma vez que os dados são armazenados, todas as PII são mascaradas no banco de dados do GenAI.

    Observação Sua escolha de incluir arquivos de imagem em digitalizações está relacionada ao modelo de bate-papo da base de conhecimento. Se você incluir arquivos de imagem em digitalizações, o modelo de bate-papo deve suportar imagens. Se os tipos de arquivo de imagem estiverem selecionados aqui, você não poderá alternar a base de conhecimento para um modelo de chat que não suporte arquivos de imagem.

    • Na seção filtro de tempo de modificação de arquivo, escolha ativar ou desativar a inclusão de arquivos com base em seu tempo de modificação. Se ativar a filtragem de hora de modificação, selecione um intervalo de datas na lista.

      Observação Se você incluir arquivos com base em um intervalo de datas de modificação, assim que o intervalo de datas não for satisfeito (os arquivos não foram modificados dentro do intervalo de datas especificado), os arquivos serão excluídos da verificação periódica e a fonte de dados não incluirá esses arquivos.

  4. Selecione Adicionar fonte de dados para adicionar esta fonte de dados à sua base de conhecimento.

Adicionar um sistema de arquivos SMB genérico

  1. Selecione o sistema de arquivos:

    1. Digite o endereço IP ou FQDN do host do sistema de arquivos onde seus arquivos de fonte de dados residem.

    2. Escolha o protocolo SMB para o compartilhamento de rede.

    3. Insira as informações do Active Directory, que incluem o domínio, endereço IP, nome de usuário e senha.

    4. Selecione seguinte.

  2. Selecione uma fonte de dados: Selecione a localização da fonte de dados com base no local onde você salvou os arquivos. Este pode ser um volume inteiro, ou apenas uma pasta específica ou subpasta no volume, e selecione Next.

    Observação Em alguns casos, pode ser necessário inserir o nome do compartilhamento SMB manualmente e selecionar Recuperar diretórios para exibir os diretórios disponíveis. Você pode optar por selecionar o compartilhamento inteiro ou apenas pastas específicas do compartilhamento.

  3. * Configurações*: Configure como a fonte de dados ingere informações de seus arquivos e quais arquivos ela inclui em varreduras:

    • Definir fonte de dados: Na seção Estratégia de Chunking, defina como o mecanismo GenAI divide o conteúdo da fonte de dados em blocos quando a fonte de dados é integrada a uma base de conhecimento. Você pode escolher uma das seguintes estratégias:

      • * Agrupamento de frases múltiplas*: Organiza informações de sua fonte de dados em blocos definidos por sentença. Você pode escolher quantas frases compõem cada pedaço (até 100).

      • * Agrupamento baseado em sobreposição*: Organiza informações de sua fonte de dados em blocos definidos por carateres que podem sobrepor blocos vizinhos. Você pode escolher o tamanho de cada pedaço em carateres, e quanto cada pedaço se sobrepõe com pedaços adjacentes. Você pode configurar um tamanho de bloco entre 50 e 3000 carateres e uma porcentagem de sobreposição entre 1 e 99%.

        Observação Escolher uma alta porcentagem de sobreposição pode aumentar significativamente os requisitos de armazenamento com apenas pequenas melhorias na precisão de recuperação.

    • Consciente de permissão: Habilita ou desabilita respostas cientes de permissão:

      • Habilitado: Os usuários do chatbot que acessam essa base de conhecimento só receberão respostas a consultas de fontes de dados às quais têm acesso.

      • Disabled: Os usuários do chatbot receberão respostas usando conteúdo de todas as fontes de dados integradas.

    • * Filtragem de arquivos*: Configure quais arquivos estão incluídos nas digitalizações:

      • Na seção suporte a tipos de arquivo, escolha incluir todos os tipos de arquivos ou selecionar tipos de arquivo individuais para inclusão nas verificações de origem de dados.

        Se você incluir imagens ou arquivos PDF, o NetApp Workload Factory for GenAI analisará o texto nas imagens (incluindo imagens em documentos PDF), e isso incorrerá em um custo mais alto.

      Ao incluir dados de texto de imagens, o GenAI não consegue mascarar informações de identificação pessoal (PII) da imagem à medida que os dados de texto digitalizados são enviados do seu ambiente para a AWS. No entanto, uma vez que os dados são armazenados, todas as PII são mascaradas no banco de dados do GenAI.

    Observação Sua escolha de incluir arquivos de imagem em digitalizações está relacionada ao modelo de bate-papo da base de conhecimento. Se você incluir arquivos de imagem em digitalizações, o modelo de bate-papo deve suportar imagens. Se os tipos de arquivo de imagem estiverem selecionados aqui, você não poderá alternar a base de conhecimento para um modelo de chat que não suporte arquivos de imagem.

    • Na seção filtro de tempo de modificação de arquivo, escolha ativar ou desativar a inclusão de arquivos com base em seu tempo de modificação. Se ativar a filtragem de hora de modificação, selecione um intervalo de datas na lista.

      Observação Se você incluir arquivos com base em um intervalo de datas de modificação, assim que o intervalo de datas não for satisfeito (os arquivos não foram modificados dentro do intervalo de datas especificado), os arquivos serão excluídos da verificação periódica e a fonte de dados não incluirá esses arquivos.

  4. Selecione Adicionar fonte de dados para adicionar esta fonte de dados à sua base de conhecimento.

Resultado

A fonte de dados está integrada ao seu conetor.

Sincronize as fontes de dados com um conetor

As fontes de dados são sincronizadas automaticamente com o conetor associado uma vez por dia, de modo que quaisquer alterações na fonte de dados sejam refletidas no Amazon Q Business. Se você fizer alterações em qualquer uma de suas fontes de dados e quiser sincronizar (digitalizar) os dados imediatamente, poderá executar uma sincronização sob demanda.

A sincronização é incremental, portanto, o Amazon Q Business só processa os objetos em suas fontes de dados que foram adicionados, modificados ou excluídos desde a última sincronização.

Passos

  1. Faça login no Workload Factory usando um dos"experiências de console" .

  2. No bloco cargas de trabalho de IA, selecione Deploy & Manage.

  3. No menu Bases de conhecimento e conectores, selecione o conector que você deseja sincronizar.

  4. Selecione o botão de opção e selecione Manage Connector.

  5. Selecione o menu ações e selecione Digitalizar agora.

    Você verá uma mensagem informando que suas fontes de dados estão sendo digitalizadas e uma mensagem final quando a digitalização estiver concluída.

Resultado

O conetor é sincronizado com as fontes de dados anexadas e o Amazon Q Business começará a usar as informações mais recentes de suas fontes de dados.

Pausar ou retomar uma sincronização agendada

Se pretender pausar ou retomar a próxima sincronização (digitalização) das fontes de dados, pode fazê-lo a qualquer momento. Talvez seja necessário pausar a próxima sincronização agendada se você fizer alterações em uma fonte de dados e não quiser que a sincronização aconteça durante a janela de mudança.

Passos

  1. Faça login no Workload Factory usando um dos"experiências de console" .

  2. No bloco cargas de trabalho de IA, selecione Deploy & Manage.

  3. Na página de inventário do conetor, selecione o conetor para o qual deseja pausar ou retomar exames.

  4. Selecione o botão de opção e selecione Manage Connector.

  5. Selecione o menu ações e selecione Digitalizar > Pausar digitalização agendada ou Digitalizar > Retomar digitalização agendada.

    Você verá uma mensagem informando que a próxima digitalização agendada foi pausada ou retomada.

Eliminar um conetor

Se você não precisar mais de um conector, poderá excluí-lo. Quando você exclui um conector, ele é removido do Workload Factory e o volume que contém o conector é excluído. A exclusão de um conector não é reversível.

Ao excluir um conetor, você também deve desassociar o conetor de qualquer agente ao qual está associado para excluir totalmente todos os recursos associados ao conetor.

Passos

  1. Faça login no Workload Factory usando um dos"experiências de console" .

  2. No bloco cargas de trabalho de IA, selecione Deploy & Manage.

  3. Na página de inventário bases de conhecimento e conetores, selecione o conetor que pretende eliminar.

  4. Selecione o botão de opção e selecione Manage Connector.

  5. Selecione o menu ações e selecione Excluir conetor.

  6. Na caixa de diálogo Excluir conetor, confirme se deseja excluí-lo e selecione Excluir.

Resultado

O conector é removido do Workload Factory e seu volume associado é excluído.