# Amazon Bedrock - Converse API 연결 만들기

Amazon Bedrock와 통신하려면 Amazon Bedrock - Converse API 분석 소스에 대한 연결을 만듭니다. 분석 활동 센터, 데이터 로드 편집기 또는 스크립트의 만들기 페이지에서 연결을 만듭니다.

## 구성 가능한 설정

외부 제어 매개 변수 구성에 대한 자세한 내용은 다음을 참조하십시오.

* [Converse API 사용](https://docs.aws.amazon.com/bedrock/latest/userguide/conversation-inference-call.html): Converse API에 특정한 구성 매개 변수에 대해 알아봅니다.

* [기초 모델에 대한 추론 요청 매개 변수 및 응답 필드](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html): 사용 중인 모델에 특정한 구성 매개 변수에 대해 알아봅니다.

연결 대화 상자에서 구성 가능한 설정

| 필드 | 설명 및 옵션 |
| --- | --- |
| Model ID or ARN | 사용하려는 모델의 ID 또는 ARN을 입력합니다. 이 정보는 Amazon Bedrock 콘솔의 모델 카드 페이지에서 확인할 수 있습니다.<br><br>Amazon Bedrock Marketplace에 호스팅된 모델이 지원됩니다. 모델을 배포한 후에는 Amazon Bedrock 콘솔에서 해당 ARN을 가져올 수 있습니다.<br><br>현재 사용 중인 모델에서는 교차 지역 추론(CRIS)이 지원됩니다.<br><br>모든 지역에서 모든 모델을 구매할 수 있는 것은 아닙니다. |
| AWS Region | AWS 리소스가 호스팅되는 적절한 지리적 지역을 선택합니다. |
| Use FIPS Endpoint (US Regions Only) | 연결과 AWS 간의 통신에서 FIPS(Federal Information Processing Standard)의 일부 버전을 준수하는 암호화를 사용하는지 선택합니다. |
| Authentication Method | 연결 인증 방법을 선택합니다. AWS Auth v4 Signature(기본값) 또는 Bedrock API Key를 선택할 수 있습니다. |
| AWS Access Key | Authentication Method가 AWS Auth v4 Signature(기본값)로 설정된 경우 적용됩니다.<br><br>AWS 계정을 인증하기 위해 자격 증명으로 제공해야 하는 액세스 키 쌍(다른 하나는 비밀 키)의 일부인 AWS 액세스 키 ID를 입력합니다. |
| AWS Secret Key | Authentication Method가 AWS Auth v4 Signature(기본값)로 설정된 경우 적용됩니다.<br><br>AWS 계정을 인증하기 위해 자격 증명으로 제공해야 하는 액세스 키 쌍(다른 하나는 액세스 키 ID)의 일부인 AWS 비밀 키를 입력합니다. |
| Bedrock API Key | Authentication Method가 Bedrock API Key로 설정된 경우 적용됩니다.<br><br>Amazon Bedrock의 API 키를 입력합니다. |
| System Prompt | 선택적인 파라메타입니다. 이는 프롬프트를 제공하기 전에 모델에 제공하려는 상황별 정보와 추가 지침을 삽입할 수 있는 텍스트 필드입니다. 자세한 내용은 [공식 Converse API 설명서](https://docs.aws.amazon.com/bedrock/latest/userguide/conversation-inference-call.html)를 참조하십시오. |
| Maximum Token Count | 모델에서 생성된 응답의 길이를 설정합니다. |
| Temperature | 모델 응답의 임의성을 제어합니다. 일반적으로 값이 낮을수록 임의성이 낮아집니다.<br><br>사용할 설정은 해당 매개 변수가 사용 중인 특정 모델에 대해 어떻게 구성되어 있는지에 따라 다릅니다. 자세한 내용은 [Amazon Bedrock 설명서](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html)를 참조하십시오. |
| Top P | 토큰 사용 가능성을 제어합니다. 일반적으로 값이 낮을수록 가능성이 낮은 토큰이 제외될 가능성이 높아집니다.<br><br>사용할 설정은 해당 매개 변수가 사용 중인 특정 모델에 대해 어떻게 구성되어 있는지에 따라 다릅니다. 자세한 내용은 [Amazon Bedrock 설명서](https://docs.aws.amazon.com/bedrock/latest/userguide/model-parameters.html)를 참조하십시오. |
| Configuration - Guardrails | Amazon Bedrock - Converse API 커넥터는 Amazon Bedrock 콘솔 내에서 구성된 가드 레일을 지원합니다. 요청에 가드 레일이 적용됩니다.<br><br>가드 레일은 모델 사용자를 악의적이고 부적절한 콘텐츠로부터 보호하는 데 도움이 됩니다. 다음 설정을 구성할 수 있습니다.<br><br><ul> <li> <p> <span>Guardrail Identifier (ARN)</span>: 사용 중인 가드 레일의 식별자입니다.</p> </li> <li> <p> <span>Guardrail Version</span>: 사용 중인 가드 레일의 버전입니다.</p> </li> <li> <p> <span>Guardrail Trace</span>: 원치 않는 콘텐츠를 차단하면서 모델 프로세스를 볼 수 있는 추적 기능을 제공하는 추적입니다.</p> </li> </ul><br><br>가드 레일은 모든 Amazon Bedrock 모델에 사용할 수 없습니다. |
| Association Field | 고유 식별자를 포함하는 입력 데이터 테이블의 필드인 연결 필드를 지정합니다.<br><br>키를 사용하여 소스 필드 테이블과 연결되도록 반환된 결과 테이블에 대한 종료 지점 요청을 수행할 때 소스 데이터에 이 필드를 포함해야 합니다. 지정된 필드는 응답의 필드로 반환되며 응답이 데이터 모델의 소스 데이터와 연결되도록 합니다. 소스 데이터에서 또는 테이블 로드 프로세스의 일부로 고유 ID를 가진 모든 필드가 될 수 있습니다. |
| Name | 연결의 이름입니다. 이름을 입력하지 않으면 기본 이름이 사용됩니다. |

## 새 연결 만들기

분석 활동 센터에서, 기존 응용 프로그램의 데이터 로드 편집기에서, 또는 기존 스크립트의 스크립트에서 분석 커넥터에 대한 연결을 만들 수 있습니다. 연결을 만들려면 아래 단계를 따르십시오.

다음과 같이 하십시오.

1. 데이터 로드 편집기 또는 스크립트를 통해 커넥터에 액세스합니다.

2. 새 연결 만들기를 클릭합니다.

3. 공간에서 연결이 위치할 공간을 선택합니다.

4. 데이터 커넥터 목록에서 Amazon Bedrock - Converse API을 선택합니다.

5. 연결 대화 상자 필드를 작성합니다.

6. 만들기를 클릭합니다.

이제 연결이 데이터 로드 편집기 또는 스크립트의 데이터 연결 아래에 나열됩니다.

연결을 만든 후에는 이를 사용하여 요청 및 이에 대한 플랫폼의 응답과 함께 데이터를 로드할 수 있습니다. 또한 차트 표현식에서 사용할 수 있습니다. 자세한 내용은 다음을 참조하십시오.

* [Amazon Bedrock - Converse API 연결에서 데이터 선택 및 로드](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-converse-api-load.htm)

* [시각화 표현식에서 Amazon Bedrock - Converse API 연결 사용](https://help.qlik.com/ko-KR/cloud-services/Subsystems/Hub/Content/Sense_Hub/LoadData/ac-bedrock-converse-api-use.htm)