View a markdown version of this page

Conectar uma fonte ServiceNow de dados - Amazon Bedrock

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Conectar uma fonte ServiceNow de dados

Depois de configurar a autenticação e armazenar suas credenciais em AWS Secrets Manager segredo, crie a fonte de ServiceNow dados em sua base de conhecimento. Esta página descreve como criar a fonte de dados com a Console de gerenciamento da AWS ou a API, seguida por uma referência para os parâmetros do conector que você pode configurar.

nota

Conclua primeiro a configuração da autenticação. Consulte Configurar a autenticação de credenciais do cliente OAuth 2.0 para ServiceNow. Você precisa do ARN secreto.

Crie a fonte de dados

Console
Para se conectar ServiceNow à sua base de conhecimento gerenciada
  1. Abra o console Amazon Bedrock em https://console.aws.amazon.com/bedrock/. No painel de navegação, escolha Knowledge Bases e abra sua base de conhecimento gerenciada.

  2. Em Fonte de dados, forneça um nome para sua fonte de dados.

  3. Na lista Tipo de fonte de dados, selecione ServiceNow.

  4. Em URL do host, insira a URL da sua ServiceNow instância (por exemplo,https://INSTANCE.service-now.com).

  5. Em Autenticação, selecione ou crie um AWS Secrets Manager segredo contendo seu clientIdclientSecret, instanceUrl e.

  6. Em Escopo da sincronização, selecione o conteúdo a ser rastreado: artigos de conhecimento, itens do catálogo de serviços e seus anexos. Você também pode escolher se deseja rastrear itens inativos do catálogo de serviços e restringir o rastreamento somente a artigos de conhecimento público.

  7. (Opcional) Para limitar o rastreamento, adicione filtros da base de conhecimento, da categoria do artigo de conhecimento ou do catálogo de serviços.

API

Para criar uma fonte de ServiceNow dados, envie uma CreateDataSource solicitação com um endpoint de tempo de construção do Agents for Amazon Bedrock. O AWS Command Line Interface exemplo a seguir cria uma fonte ServiceNow de dados. Para obter uma descrição de cada campo, consulte a referência de parâmetros do conector a seguir.

aws bedrock-agent create-data-source \ --name "ServiceNow-connector" \ --knowledge-base-id "your-knowledge-base-id" \ --data-source-configuration file://servicenow-managed-connector.json

O servicenow-managed-connector.json arquivo contém o seguinte:

{ "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR", "managedKnowledgeBaseConnectorConfiguration": { "connectorParameters": { "type": "SERVICENOW", "connectorType": "SERVICENOW", "version": "1", "connectionConfiguration": { "secretArn": "arn:aws:secretsmanager:us-west-2:123456789012:secret:bedrock-servicenow-creds", "authType": "OAUTH2", "hostUrl": "https://INSTANCE.service-now.com" }, "dataEntityConfiguration": { "crawlKnowledgeArticles": true, "crawlServiceCatalogs": true, "crawlKnowledgeArticleAttachments": true, "crawlServiceCatalogAttachments": true, "crawlInactiveServiceCatalogItems": false, "crawlPublicKnowledgeArticlesOnly": false }, "filterConfiguration": { "knowledgeArticleFilter": { "inclusionKnowledgeBaseSysIds": ["optional-kb-sys-id"], "inclusionKnowledgeArticleCategorySysIds": [] }, "serviceCatalogFilter": { "inclusionServiceCatalogSysIds": [], "inclusionServiceCatalogCategorySysIds": [] }, "maxFileSizeInMegaBytes": "500" } } } }

Os dataEntityConfiguration campos controlam quais entidades o conector rastreia. O filterConfiguration campo é opcional; use-o para definir o escopo do rastreamento para bases de conhecimento específicas, categorias de artigos de conhecimento ou catálogos de serviços e para definir um tamanho máximo de arquivo. Sem filtros, o conector rastreia todos os artigos de conhecimento ativos e itens do catálogo de serviços.

Para bases de conhecimento gerenciadas, CreateDataSource é assíncrono: o status da fonte de dados muda de CREATING para AVAILABLE quando a operação é concluída.

Parâmetros do conector

A configuração da fonte de dados usa os seguintes parâmetros do conector. DentroconnectorParameters, defina ambos type e connectorType para SERVICENOW e version defina como1. Para os campos que envolvem connectorParameters (como deletionProtectionConfiguration emediaExtractionConfiguration), consulteConectar uma fonte de dados.

A tabela a seguir descreve os connectionConfiguration campos.

connectionConfiguration
Campo Obrigatório Descrição
secretArn Sim O ARN do AWS Secrets Manager segredo contendo seu clientIdclientSecret, e. instanceUrl
hostUrl Sim O URL da sua ServiceNow instância (por exemplo,https://INSTANCE.service-now.com).
authType Sim O tipo de autenticação. ServiceNow suportesOAUTH2. Consulte Método de autenticação.

A tabela a seguir descreve os dataEntityConfiguration campos que controlam as entidades que o conector rastreia.

dados EntityConfiguration
Campo Obrigatório Descrição
crawlKnowledgeArticles Sim Se você deve rastrear artigos de conhecimento (kb_knowledge).
crawlServiceCatalogs Sim Se você deve rastrear itens do catálogo de serviços (sc_cat_item).
crawlKnowledgeArticleAttachments Sim Se você deve rastrear anexos em artigos de conhecimento.
crawlServiceCatalogAttachments Sim Se é necessário rastrear anexos em itens do catálogo de serviços.
crawlInactiveServiceCatalogItems Sim Se você deve rastrear itens inativos do catálogo de serviços.
crawlPublicKnowledgeArticlesOnly Sim Se deve restringir o rastreamento somente a artigos de conhecimento público.

A tabela a seguir descreve os filterConfiguration campos opcionais, que abrangem o rastreamento.

Configuração do filtro (opcional)
Campo Obrigatório Description
knowledgeArticleFilter Não Rastreamento de artigos de conhecimento sobre escopos. Contém inclusionKnowledgeBaseSysIds (uma lista de IDs de sistema da base de conhecimento) e inclusionKnowledgeArticleCategorySysIds (uma lista de IDs de sistemas da categoria de artigos de conhecimento).
serviceCatalogFilter Não Escopos: rastreamento do catálogo de serviços. Contém inclusionServiceCatalogSysIds (uma lista de IDs de sistema do catálogo de serviços) e inclusionServiceCatalogCategorySysIds (uma lista de IDs de sistema da categoria do catálogo de serviços). Em instâncias grandes, a filtragem por ID do sistema reduz significativamente o tempo de sincronização.
maxFileSizeInMegaBytes Não Tamanho máximo, em megabytes, de qualquer arquivo individual que o conector ingere. Forneça como uma string numérica (por exemplo,"500").

Próximas etapas

Depois de criar a fonte de dados, sincronize-a para ingerir conteúdo em sua base de conhecimento. Para obter detalhes, consulte Sincronizar uma fonte de dados. Como ServiceNow não oferece suporte ao controle de acesso em nível de documento, todos os usuários autenticados que podem consultar a base de conhecimento podem ver todo o conteúdo rastreado.