기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# ServiceNow 데이터 소스 연결
<a name="kb-managed-ds-servicenow-connect"></a>

인증을 설정하고 보안 인증 정보를 AWS Secrets Manager 보안 암호에 저장한 후 지식 기반에 ServiceNow 데이터 소스를 생성합니다. 이 페이지에서는 AWS Management Console 또는 API를 사용하여 데이터 소스를 생성한 다음 구성할 수 있는 커넥터 파라미터에 대한 참조를 생성하는 방법을 설명합니다.

**참고**  
먼저 인증 설정을 완료합니다. [ServiceNow에 대한 OAuth 2.0 클라이언트 자격 증명 인증 설정](kb-managed-servicenow-oauth2-setup.md)을(를) 참조하세요. 보안 암호 ARN이 필요합니다.

## 데이터 소스 생성
<a name="kb-managed-ds-servicenow-create"></a>

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

**ServiceNow를 관리형 지식 기반에 연결하려면**

1. 그 다음 [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock/)에서 Amazon Bedrock 콘솔을 엽니다. 탐색 창에서 **지식 기반을** 선택하고 관리형 지식 기반을 엽니다.

1. **데이터 소스**에서 데이터 소스의 이름을 입력합니다.

1. **데이터 소스 유형** 목록에서 **ServiceNow**를 선택합니다.

1. **호스트 URL**에 ServiceNow 인스턴스 URL(예: `https://{{INSTANCE}}.service-now.com`)을 입력합니다.

1. **인증**에서 , `clientId` `clientSecret`및가 포함된 AWS Secrets Manager 보안 암호를 선택하거나 생성합니다`instanceUrl`.

1. **동기화 범위에서** 크롤링할 콘텐츠, 즉 지식 문서, 서비스 카탈로그 항목 및 첨부 파일을 선택합니다. 비활성 서비스 카탈로그 항목을 크롤링할지 여부와 크롤링을 공개 지식 문서로만 제한할지 여부를 선택할 수도 있습니다.

1. (선택 사항) 크롤링을 제한하려면 지식 기반, 지식 문서 범주 또는 서비스 카탈로그 필터를 추가합니다.

------
#### [ API ]

ServiceNow 데이터 소스를 생성하려면 Agents for Amazon Bedrock 빌드 타임 엔드포인트를 사용하여 [CreateDataSource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateDataSource.html) 요청을 보냅니다. 다음 AWS Command Line Interface 예시에서는 ServiceNow 데이터 소스를 생성합니다. 각 필드에 대한 설명은 다음 커넥터 파라미터 참조를 참조하세요.

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

`servicenow-managed-connector.json` 파일에는 다음이 포함됩니다.

```
{
    "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"
            }
        }
    }
}
```

`dataEntityConfiguration` 필드는 커넥터가 크롤링하는 개체를 제어합니다. `filterConfiguration` 필드는 선택 사항입니다. 크롤링 범위를 특정 지식 기반, 지식 문서 범주 또는 서비스 카탈로그로 지정하고 최대 파일 크기를 설정하는 데 사용합니다. 필터가 없으면 커넥터는 모든 활성 지식 문서와 서비스 카탈로그 항목을 크롤링합니다.

관리형 지식 기반의 경우 `CreateDataSource`는 비동기식입니다. 작업이 완료되면 데이터 소스 상태가에서 `AVAILABLE` `CREATING`로 전환됩니다.

------

## 커넥터 파라미터
<a name="kb-managed-config-servicenow"></a>

데이터 소스 구성은 다음 커넥터 파라미터를 사용합니다. 내에서 `type` 및를 모두 `connectorType` 로 `connectorParameters`설정하고를 `version`로 `SERVICENOW` 설정합니다`1`. 래핑되는 필드`connectorParameters`(예: `deletionProtectionConfiguration` 및 `mediaExtractionConfiguration`)는 섹션을 참조하세요[데이터 소스 연결](kb-managed-connect-ds.md).

다음 표에서는 `connectionConfiguration` 필드를 설명합니다.


**connectionConfiguration**  

| Field | 필수 | 설명 | 
| --- | --- | --- | 
| secretArn | 예 | clientId, clientSecret및가 포함된 AWS Secrets Manager 보안 암호의 ARN입니다instanceUrl. | 
| hostUrl | 예 | ServiceNow 인스턴스 URL(예: https://{{INSTANCE}}.service-now.com). | 
| authType | 예 | 인증 유형입니다. ServiceNow는를 지원합니다OAUTH2. [인증 방법](kb-managed-ds-servicenow.md#kb-managed-servicenow-auth-methods)을(를) 참조하세요. | 

다음 표에서는 커넥터가 크롤링하는 개체를 제어하는 `dataEntityConfiguration` 필드를 설명합니다.


**dataEntityConfiguration**  

| Field | 필수 | 설명 | 
| --- | --- | --- | 
| crawlKnowledgeArticles | 예 | 지식 문서를 크롤링할지 여부(kb\_knowledge). | 
| crawlServiceCatalogs | 예 | 서비스 카탈로그 항목을 크롤링할지 여부(sc\_cat\_item). | 
| crawlKnowledgeArticleAttachments | 예 | 지식 문서의 첨부 파일을 크롤링할지 여부입니다. | 
| crawlServiceCatalogAttachments | 예 | 서비스 카탈로그 항목에 대한 첨부 파일을 크롤링할지 여부입니다. | 
| crawlInactiveServiceCatalogItems | 예 | 비활성 서비스 카탈로그 항목을 크롤링할지 여부입니다. | 
| crawlPublicKnowledgeArticlesOnly | 예 | 크롤링을 공개 지식 문서로만 제한할지 여부입니다. | 

다음 표에서는 크롤링의 범위를 지정하는 선택적 `filterConfiguration` 필드를 설명합니다.


**filterConfiguration(선택 사항)**  

| Field | 필수 | 설명 | 
| --- | --- | --- | 
| knowledgeArticleFilter | 아니요 | 지식 문서 크롤링의 범위를 지정합니다. inclusionKnowledgeBaseSysIds (지식 기반 시스템 IDs 목록) 및 inclusionKnowledgeArticleCategorySysIds (지식 문서 범주 시스템 IDs 목록)을 포함합니다. | 
| serviceCatalogFilter | 아니요 | 서비스 카탈로그 크롤링의 범위를 지정합니다. inclusionServiceCatalogSysIds (서비스 카탈로그 시스템 IDs 목록) 및 inclusionServiceCatalogCategorySysIds (서비스 카탈로그 범주 시스템 IDs 목록)을 포함합니다. 대규모 인스턴스에서 시스템 ID로 필터링하면 동기화 시간이 크게 단축됩니다. | 
| maxFileSizeInMegaBytes | 아니요 | 커넥터가 수집하는 단일 파일의 최대 크기입니다. 를 숫자 문자열로 입력합니다(예: "500"). | 

## 다음 단계
<a name="kb-managed-ds-servicenow-connect-next"></a>

데이터 소스를 생성한 후 이를 동기화하여 지식 기반에 콘텐츠를 수집합니다. 자세한 내용은 [데이터 소스 동기화](kb-managed-sync.md)을 참조하세요. ServiceNow는 문서 수준 액세스 제어를 지원하지 않으므로 지식 기반을 쿼리할 수 있는 인증된 모든 사용자는 크롤링된 모든 콘텐츠를 볼 수 있습니다.