Atributos de origem indexados

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 8 min. de leitura

    • Um atributo de origem indexada define o comportamento de indexação de todos os registros de uma origem indexada.

    Exemplos de como você pode usar atributos de origem indexados incluem o seguinte.
    • Defina um filtro para limitar o conjunto de registros indexados da tabela de origem
    • Modificar o comportamento de indexação padrão para anexos ou marcadores encontrados em registros da tabela de origem
    • Especifique se os campos traduzidos dos registros da tabela de origem devem ser indexados

    Os atributos de uma origem indexada aparecem em sua lista relacionada de Configuração avançada.

    Criar um atributo de origem indexada

    Defina um atributo de origem indexada para configurar o comportamento de indexação de conteúdo Pesquisa com IA para todos os registros em uma tabela de origem.

    Antes de Iniciar

    Função necessária: ais_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Para obter detalhes sobre os atributos e valores de origem indexada disponíveis, consulte Lista de Pesquisa com IA atributos de origem indexados.

    Procedimento

    1. Navegar até Todos > Pesquisa com IA > Pesquisa com IA Índice > Origens indexadas.
    2. Abra a origem indexada para a qual você deseja definir um atributo.
    3. Na lista relacionada Configuração avançada, selecione Novo.
    4. No formulário Atributo de origem indexada, preencha os campos.
      Para obter uma descrição dos valores dos campos, consulte Formulário Atributo de origem indexada.
    5. Selecione Enviar.

    Resultado

    O novo atributo de origem indexada aparece na lista relacionada Configuração avançada.

    O que Fazer Depois

    Para que o novo atributo de origem indexada tenha efeito, execute uma reindexação de tabela completa para a origem indexada. Para obter detalhes sobre este procedimento, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.

    Habilitar indexação de marcadores para uma origem indexada

    Configure um atributo de origem indexada para habilitar a indexação de conteúdo de marcadores encontrados em registros de uma origem indexada.

    Antes de Iniciar

    Função necessária: ais_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Por padrão, a indexação Pesquisa com IA ignora os marcadores dos registros de origem. Você pode habilitar a indexação de marcadores para todos os registros de uma origem indexada. Escolha se você deseja indexar todos os marcadores compartilhados e visíveis globalmente ou somente os marcadores visíveis globalmente. Marcadores privados nunca são indexados.

    Para obter instruções mais gerais sobre como definir atributos de origem indexados, consulte Criar um atributo de origem indexada.

    Procedimento

    1. Navegar até Todos > Pesquisa com IA > Pesquisa com IA Índice > Origens indexadas.
    2. Abra a origem indexada para a qual você deseja habilitar a indexação de marcador.
    3. Na lista relacionada Configuração avançada, selecione Novo.
    4. No formulário Atributo de origem indexada, preencha os campos.
      1. No campo Atributo, insira index_tags.
      2. No campo Valor, insira uma das seguintes opções:
      Opção Descrição
      todos_somente Somente marcadores compartilhados com todos são indexados.
      tudo_compartilhado Todos os marcadores compartilhados (Todos, Grupos e Usuários) são indexados.

      Para obter uma descrição dos valores dos campos, consulte Formulário Atributo de origem indexada.

    5. Selecione Enviar.

    Resultado

    O novo atributo de origem indexada index_tags aparece na lista relacionada Configuração avançada.

    O que Fazer Depois

    Para que o novo atributo index_tags tenha efeito, execute uma reindexação de tabela completa para a origem indexada. Para obter detalhes sobre este procedimento, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.

    Habilitar indexação de anexos para uma origem indexada

    Configure um atributo de origem indexada para habilitar a indexação de conteúdo de anexos encontrados em registros de uma origem indexada.

    Antes de Iniciar

    Função necessária: ais_admin

    Por Que e Quando Desempenhar Esta Tarefa

    Por padrão, a Pesquisa com IA indexa o conteúdo pesquisável e os metadados (como tamanho do arquivo e data) dos anexos encontrados nos registros da tabela de origem. A indexação é compatível com os seguintes formatos de arquivo de anexo:
    • Página de servidor ativa estendida (.aspx)
    • Linguagem de marcação de hipertexto (.html, .htm)
    • Microsoft Excel (.xls, .xlsx)
    • Microsoft PowerPoint (.pot, .potx, .ppt, .pptm, .pptx)
    • Microsoft Word (.doc, .docx, .dot, .dotx)
    • Texto simples (.txt)
    • Formato de documento portátil (.pdf)
    Nota:
    A Pesquisa com IA ignora anexos com mais de 25 MB. A indexação padrão somente indexa o conteúdo do primeiro 1 MB de dados do anexo, enquanto a indexação vetorial semântica indexa todo o conteúdo do anexo.
    Pesquisa com IA fornece suporte limitado para anexos de registro criptografados:
    • Ao indexar um anexo criptografado, Pesquisa com IA extrai metadados, como o tamanho e a data do arquivo de anexo, mas não extrai conteúdo pesquisável.
    • O tipo MIME do anexo criptografado é detectado como application/octet-stream.
    • Nenhum feedback para o anexo criptografado aparece nas mensagens de log de ingestão.
    A indexação de anexos é controlada pelo atributo index_attachments de uma origem indexada:
    • verdadeiro (valor padrão): os anexos são indexados para registros da origem indexada.
    • falso: os anexos não são indexados para registros da origem indexada.

    O procedimento a seguir explica como garantir que este atributo esteja definido como verdadeiro para uma origem indexada. Para obter instruções mais gerais sobre como definir atributos de origem indexados, consulte Criar um atributo de origem indexada.

    Procedimento

    1. Navegar até Todos > Pesquisa com IA > Pesquisa com IA Índice > Origens indexadas.
    2. Abra a origem indexada para a qual você deseja verificar ou alterar a indexação de anexos.
    3. Na lista relacionada Configuração avançada, verifique se há um atributo index_attachments com valor false.
      Nota:
      Se não houver nenhum atributo index_attachments na lista relacionada ou se o atributo existir com o valor true, a indexação de anexos já estará habilitada para a origem indexada. Nenhuma outra etapa é necessária.
    4. Abra o atributo index_attachments e altere seu valor de false para true.

    Resultado

    A indexação de anexos está habilitada para a origem indexada.

    O que Fazer Depois

    Se você alterou o valor do atributo [ index_attachments de false para true, reindexe o conteúdo da origem indexada. Para obter detalhes sobre reindexação, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.

    Lista de Pesquisa com IA atributos de origem indexados

    Você pode ajustar o comportamento de indexação de uma origem indexada Pesquisa com IA configurando atributos e valores de origem indexada.

    Para obter instruções sobre como definir Pesquisa com IA atributos de origem indexados, consulte Criar um atributo de origem indexada.

    Atributo Descrição
    filtros

    Especifique uma condição de filtro que se aplique à tabela de origem indexada e a todas as suas tabelas secundárias configuradas para indexação. A indexação ignora os registros de origem que não passam nesta condição de filtro.

    Se você mudar o valor desse atributo para uma origem indexada, a mudança não terá efeito até que você indexe novamente o conteúdo da origem indexada. Para obter as etapas de reindexação, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.
    index_attachments

    Controlar o comportamento de indexação de anexos de registros indexados.

    Valores compatíveis:
    • true: habilitar a indexação de anexos para esta tabela.
    • false: desabilitar a indexação de anexos para esta tabela.

    Valor padrão: true

    Se você mudar o valor desse atributo para uma origem indexada, a mudança não terá efeito até que você indexe novamente o conteúdo da origem indexada. Para obter as etapas de reindexação, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.
    index_tags

    Controlar o comportamento de indexação de marcadores de registros indexados.

    Valores compatíveis:
    • all_shared: indexar marcadores compartilhados e marcadores visíveis globalmente.
    • everyone_only: indexar somente marcadores visíveis globalmente.
    • none: desabilitar a indexação de marcadores.
    Valor padrão: none
    Nota:
    Os resultados da pesquisa exibem marcadores indexados com base na visibilidade do registro do resultado em vez da visibilidade do marcador.

    Se você mudar o valor desse atributo para uma origem indexada, a mudança não terá efeito até que você indexe novamente o conteúdo da origem indexada. Para obter as etapas de reindexação, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.
    index_translated_fields

    Controlar o comportamento de indexação de campos traduzidos de registros indexados.

    Valores compatíveis:
    • true: habilitar a indexação de campos traduzidos para esta tabela.
    • false: desabilitar a indexação de campos traduzidos para esta tabela.
    Valor padrão: false
    Nota:
    Para tabelas com registros mapeados manualmente, como kb_knowledge, a indexação ignora esse atributo e respeita o mapeamento manual.

    Se você mudar o valor desse atributo para uma origem indexada, a mudança não terá efeito até que você indexe novamente o conteúdo da origem indexada. Para obter as etapas de reindexação, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.
    index_translated_reference_fields

    Controlar o comportamento de indexação dos campos de referência traduzidos de registros indexados.

    Valores compatíveis:
    • true: habilitar a indexação de campos de referência traduzidos para esta tabela.
    • false: desabilitar a indexação de campos de referência traduzidos para esta tabela.

    Valor padrão: true

    Se você mudar o valor desse atributo para uma origem indexada, a mudança não terá efeito até que você indexe novamente o conteúdo da origem indexada. Para obter as etapas de reindexação, consulte Executar um índice de tabela completo ou reindexar para uma única origem indexada.
    user_read_takes_precedence_over_group_deny

    Controle a precedência das permissões de acesso de leitura do usuário externo e das permissões de acesso negadas do grupo externo para resultados de pesquisa de documentos externos da origem indexada.

    Valores compatíveis:
    • true: as permissões de acesso de leitura do usuário externo têm precedência sobre as permissões de acesso de negação do grupo externo para resultados de pesquisa de documentos externos da origem indexada.
    • false: as permissões de acesso negado do grupo externo têm precedência sobre as permissões de acesso de leitura do usuário externo para resultados de pesquisa de documentos externos da origem indexada.
    Valor padrão: true em origens indexadas para tabelas de esquema de conteúdo externo. Não definido em origens indexadas para tabelas internas.
    Nota:
    Este atributo se aplica somente a origens indexadas para tabelas de esquema de conteúdo externo. Se você aplicar este atributo a uma origem indexada de uma tabela interna, ele não terá efeito.
    Nota:
    Atributos de origem indexados são registros na tabela Atributo de configuração da Pesquisa com IA [ais_configuration_attribute] que têm Tabela como o valor do campo Aplica-se a. Os registros nesta tabela que têm Coluna como o valor do campo Aplica-se a são Configurações de campo.