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
<a name="kb-managed-ds-servicenow-connect"></a>

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](kb-managed-servicenow-oauth2-setup.md). Você precisa do ARN secreto.

## Crie a fonte de dados
<a name="kb-managed-ds-servicenow-create"></a>

------
#### [ Console ]

**Para se conectar ServiceNow à sua base de conhecimento gerenciada**

1. Abra o console Amazon Bedrock em [ https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/). No painel de navegação, escolha ** Knowledge Bases ** e abra sua base de conhecimento gerenciada.

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

1. Na ** lista Tipo de fonte de ** dados, selecione ** ServiceNow**.

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

1. Em ** Autenticação**, selecione ou crie um AWS Secrets Manager segredo contendo seu `clientId``clientSecret`, `instanceUrl` e.

1. 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.

1. (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 ](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) 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 name="kb-managed-config-servicenow"></a>

A configuração da fonte de dados usa os seguintes parâmetros do conector. Dentro`connectorParameters`, defina ambos `type` e `connectorType` para `SERVICENOW` e `version` defina como`1`. Para os campos que envolvem `connectorParameters` (como `deletionProtectionConfiguration` e`mediaExtractionConfiguration`), consulte[Conectar uma fonte de dados](kb-managed-connect-ds.md).

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](kb-managed-ds-servicenow.md#kb-managed-servicenow-auth-methods). | 

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
<a name="kb-managed-ds-servicenow-connect-next"></a>

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](kb-managed-sync.md). 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.