View a markdown version of this page

데이터 소스 연결 - Amazon Bedrock

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

데이터 소스 연결

지식 기반에 대한 구성을 완료한 후 지원되는 데이터 소스를 지식 기반에 연결합니다.

Amazon Bedrock 관리형 지식 기반은 비정형 데이터 소스에 대한 연결을 지원합니다. 주제를 선택하여 해당 유형의 데이터 소스에 연결하는 방법을 알아봅니다.

참고

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

Amazon Bedrock 콘솔을 사용하여 데이터 소스에 연결하는 방법을 알아보려면 이 페이지 하단에서 데이터 소스 유형에 해당하는 주제를 선택합니다.

Amazon Bedrock API를 사용하여 데이터 소스에 연결하려면 Amazon Bedrock Agents 런타임 엔드포인트를 사용하여 CreateDataSource 요청을 보냅니다.

필수 필드:

필드 설명
knowledgeBaseId 기술 자료의 ID입니다.
name 데이터 소스의 이름입니다.
dataSourceConfiguration type 필드에 데이터 소스 유형을 지정하고 해당 구성을 포함합니다. 커넥터별 구성에 대한 자세한 내용은이 페이지 하단의 주제에서 커넥터 주제를 선택합니다.

내에서 다음을 지정dataSourceConfiguration해야 합니다.

  • type - 반드시 MANAGED_KNOWLEDGE_BASE_CONNECTOR여야 합니다.

  • managedKnowledgeBaseConnectorConfiguration - 커넥터에 대한 구성입니다. 다음 필드가 포함됩니다.

    • connectorParameters (필수) - 커넥터 유형을 type 지정하는 필드와 로 설정된 필수 version 필드를 포함합니다1. 지원되는 유형 값은 S3, ONEDRIVE, CONFLUENCE, SHAREPOINT, 및 WEB_CRAWLER입니다GOOGLE_DRIVE. 의 나머지 필드는 커넥터 유형에 따라 connectorParameters 다릅니다. 자세한 내용은 각 데이터 커넥터 페이지를 참조하세요.

    • deletionProtectionConfiguration (선택 사항) - 인덱싱된 콘텐츠가 실수로 대량 삭제되지 않도록 보호합니다. deletionProtectionStatus (ENABLED 또는 DISABLED)를 포함하고, 활성화된 경우 선택 사항deletionProtectionThreshold(0~100, 기본값은 15)을 포함합니다. 임계값은 동기화 작업이 인덱스에서 삭제할 수 있는 문서의 최대 백분율입니다. 동기화가이 백분율보다 많이 삭제되는 경우 동기화는 삭제 단계를 건너뛰고 인덱싱된 문서를 그대로 둡니다. 사용자 지정 커넥터에는 지원되지 않습니다.

    • mediaExtractionConfiguration (선택 사항) - 데이터 소스 파일에서 미디어(이미지, 오디오, 비디오)를 추출하기 위한 구성입니다.

선택적 필드:

필드 설명
description 데이터 소스에 대한 설명을 입력합니다.
vectorIngestionConfiguration 수집 프로세스를 사용자 지정하기 위한 구성이 포함되어 있습니다. 자세한 내용은 데이터 소스에 대한 수집 사용자 지정 단원을 참조하십시오.
clientToken API 요청이 한 번만 완료되도록 합니다. 자세한 내용은 멱등성 보장하기를 참조하세요.

다음 예제에서는 S3 커넥터가 있는 CreateDataSource 요청을 보여줍니다.

{
    "knowledgeBaseId": "your-knowledge-base-id",
    "name": "my-s3-data-source",
    "description": "S3 data source for my managed knowledge base",
    "dataSourceConfiguration": {
        "type": "MANAGED_KNOWLEDGE_BASE_CONNECTOR",
        "managedKnowledgeBaseConnectorConfiguration": {
            "mediaExtractionConfiguration": {
                "imageExtractionConfiguration": {
                    "imageExtractionStatus": "ENABLED"
                }
            },
            "deletionProtectionConfiguration": {
                "deletionProtectionStatus": "ENABLED",
                "deletionProtectionThreshold": 15
            },
            "connectorParameters": {
                "type": "S3",
                "version": "1",
                "connectionConfiguration": {
                    "bucketName": "my-bucket-name",
                    "bucketOwnerAccountId": "123456789012"
                },
                "filterConfiguration": {
                    "maxFileSizeInMegaBytes": "50"
                }
            }
        }
    }
}

특정 커넥터 및 해당 구성에 대해 자세히 알아보려면 아래에서 주제를 선택합니다.

주제