Como indexar e pesquisar conteúdo externo no Pesquisa com IA

Com uma assinatura do plug-in Conteúdo externo para Pesquisa com IA , você pode permitir que usuários Pesquisa com IA pesquisem conteúdo e metadados de documentos em repositórios externos e tabelas remotas.

O plug-in Conteúdo externo para Pesquisa com IA permite indexar documentos localizados fora da instância Now Platform, como aqueles armazenados em coleções do SharePoint, sites do Confluence e tabelas remotas. A indexação desses documentos torna seu conteúdo e metadados pesquisáveis em Pesquisa com IA.

Pesquisa com IA exibe resultados de pesquisa para documentos externos indexados assim como para registros indexados Now Platform. Os usuários não precisam executar pesquisas especiais para corresponder conteúdo e metadados de documentos externos.

A indexação não duplica documentos externos como registros em sua instância Now Platform. Quando um usuário seleciona um resultado de pesquisa de documento externo, ele é direcionado para o documento de origem em seu local original.

Ferramentas de indexação de conteúdo externo

O diagrama a seguir ilustra como Pesquisa com IA fornece indexação e pesquisa de conteúdo e metadados de documentos externos:

Figura 1. Pesquisa com IA diagrama de arquitetura de conteúdo externo

Conforme mostrado no diagrama de arquitetura, você pode indexar conteúdo e metadados de documentos externos usando qualquer uma ou todas as ferramentas a seguir:

Ferramenta de indexação de conteúdo externo	Descrição
Aplicações do conector de pesquisa	As aplicações do conector de pesquisa disponíveis no ServiceNow Store fornecem ferramentas simples para indexação de conteúdo e metadados de documentos em origens externas compatíveis. Eles lidam com parte do trabalho de configuração, como a criação de tabelas de esquema de conteúdo externo, para você. Cada aplicação do conector de pesquisa oferece suporte a uma origem de documento externo específica (ou conjunto de origens). Por exemplo, o Conector de pesquisa do SharePoint Online só oferece suporte a documentos em coleções do SharePoint, enquanto o Hub do conector do Hub para Pesquisa com IA O oferece suporte a várias origens de documentos. Se nenhuma aplicação de conector de pesquisa estiver disponível para sua origem de documento externo, você deverá usar o spoke Integration Hub Pesquisa com IA ou a REST API de conteúdo externo para indexar conteúdo e metadados de documentos dessa origem. As aplicações do conector de pesquisa fornecem a maneira mais direta de indexar conteúdo de documentos e metadados de fontes externas compatíveis.
Integration Hub Pesquisa com IA spoke	O Integration Hub Pesquisa com IA spoke fornece Workflow Studio ações que você pode usar para ingerir documentos externos para indexação: Ingest Document: defina pares de nome-valor de propriedade para um documento externo e envie o documento para Pesquisa com IA para indexação. Ingest Document Using Download URL: especifique a URL de um documento externo e faça com que Pesquisa com IA baixe-o para indexação. Você pode especificar permissões de acesso principais de segurança para documentos ingeridos usando essas ações. Para saber mais sobre permissões de acesso e segurança para conteúdo de documento externo, consulte Segurança de conteúdo externo para Pesquisa com IA. Para obter a lista completa de ações Workflow Studio fornecidas pelo spoke Pesquisa com IA, consulte Pesquisa com IA spoke. O Integration Hub Pesquisa com IA spoke combina configuração e manipulação flexíveis com a interface simples de arrastar e soltar Workflow Studio.
API REST de conteúdo externo	A REST API de conteúdo externo fornece endpoints que você pode usar para indexar conteúdo e metadados de documentos externos: Envie conteúdo de texto de documento externo e metadados para Pesquisa com IA para indexação usando o endpoint da API ingestDocuments. Carregar conteúdo binário de documento externo para Pesquisa com IA usando o endpoint da API storeContent. Você pode associar o conteúdo binário armazenado a um documento alimentado usando o endpoint ingestDocuments. Nota: Para acessar os endpoints da REST API de conteúdo externo, você precisa da função ais_external_content ou da função de administrador. Você pode especificar permissões de acesso principais de segurança para documentos ingeridos usando o endpoint ingestDocuments. Para saber mais sobre permissões de acesso e segurança para conteúdo de documento externo, consulte Segurança de conteúdo externo para Pesquisa com IA. Para obter descrições completas dos endpoints da REST API de conteúdo externo, consulte API REST de ingestão de conteúdo externo. A REST API de conteúdo externo é a ferramenta mais complexa para indexar conteúdo e metadados de seus documentos externos, mas oferece mais flexibilidade.

Pré-requisitos da pesquisa de conteúdo externo

Antes de indexar conteúdo de documento externo e metadados para pesquisa em Pesquisa com IA, você deve atender aos seguintes requisitos. Exceto conforme observado na tabela, esses requisitos se aplicam independentemente de quais ferramentas de indexação de conteúdo externo você usa.

Requisito	Descrição
Ter uma assinatura ativa do plug-in [ Conteúdo externo para Pesquisa com IA (com.glide.ais.external_content)	O plug-in Conteúdo externo para Pesquisa com IA fornece funcionalidade para indexação de conteúdo de fontes de dados externas. Para obter instruções sobre como comprar uma assinatura do plug-in e ativá-lo, consulte Solicitar o plug-in Conteúdo externo para Pesquisa com IA.
Definir uma tabela de esquema de conteúdo externo para a origem do documento externo	Uma tabela de esquema de conteúdo externo não armazena conteúdo de documento externo no banco de dados. Em vez disso, suas colunas servem como um mapa de campos de índice Pesquisa com IA a serem preenchidos ao indexar conteúdo de fontes de dados externas. Para obter instruções sobre como criar uma nova tabela de esquema de conteúdo externo, consulte Criar uma tabela de esquema de conteúdo externo. Quando documentos de várias fontes de dados externas compartilham o mesmo conjunto de campos e têm identificadores de documento exclusivos, você pode usar uma única tabela de esquema de conteúdo externo para todos eles. Para evitar a perda de dados, as fontes de dados externas devem atender a estas condições: Todos os documentos nas fontes de dados externas devem incluir os mesmos campos, correspondendo às colunas definidas na tabela de esquema de conteúdo. Cada documento nas fontes de dados externas deve ter um identificador exclusivo para que os documentos não se substituam no índice Pesquisa com IA. Se as fontes de dados externas não puderem atender a essas condições, crie uma tabela de esquema de conteúdo externo separada para cada fonte de dados. Nota: As aplicações do conector de pesquisa do ServiceNow Store criam automaticamente tabelas de esquema de conteúdo externo conforme necessário. Você só precisa criar suas próprias tabelas de esquema de conteúdo externo ao indexar documentos externos usando o spoke Integration Hub Pesquisa com IA ou a REST API de conteúdo externo.
Crie uma origem indexada com a tabela de esquema de conteúdo externo especificada como a tabela a ser indexada	A origem indexada envia conteúdo e metadados de documentos externos para o índice Pesquisa com IA. Para obter instruções sobre como criar uma origem indexada, consulte Criar uma origem indexada.
Criar uma ou mais origens de pesquisa para a origem indexada	Cada origem de pesquisa especifica um subconjunto de documentos externos da origem indexada cujo conteúdo você deseja tornar pesquisável em Pesquisa com IA. Para obter instruções sobre como criar fontes de pesquisa, consulte Criar uma origem de pesquisa.

• Solicitar o plug-in Conteúdo externo para Pesquisa com IA
  Solicite a ativação do Conteúdo externo para Pesquisa com IA plug-in (com.glide.ais.external_content) para habilitar a indexação de conteúdo pesquisável e metadados de registros em fontes de dados externas.
• Criar uma tabela de esquema de conteúdo externo
  Defina uma tabela de esquema com colunas correspondentes a campos em registros de uma fonte de dados externa. Pesquisa com IA usa o esquema ao indexar conteúdo da fonte de dados externa.
• Segurança de conteúdo externo para Pesquisa com IA
  Pesquisa com IA O preserva as permissões de acesso de segurança de usuários e grupos especificadas para documentos indexados de fontes externas. Você pode controlar o acesso aos resultados da pesquisa de conteúdo externo mapeando esses usuários e grupos definidos externamente para Now Platform usuários.
• Componentes instalados com conteúdo externo para Pesquisa com IA
  Quando você ativa o plug-in [ Conteúdo externo para Pesquisa com IA (com.glide.ais.external_content), o sistema cria uma nova tabela virtual.