배포 옵션¶

구성 방법¶

GenU를 사용하면 parameter.ts 또는 AWS CDK context를 통해 설정을 변경할 수 있습니다.

여러 환경에 대한 설정을 정의할 수 있으므로 새 환경을 구축할 때는 parameter.ts를 사용하는 것을 권장합니다. 하위 호환성을 위해 매개변수는 context > parameter.ts 순서로 검색됩니다.

Context 사용 시: CDK context는 '-c'로 지정할 수 있지만, 코드 변경이 없으므로 프론트엔드 빌드가 트리거되지 않습니다. 이 자산의 경우 cdk.json에서 모든 설정을 변경하는 것을 권장합니다.

parameter.ts 값 변경 방법¶

packages/cdk/parameter.ts의 값을 변경하여 설정을 구성합니다.

// parameter.ts
const envs: Record<string, Partial<StackInput>> = {
  dev: {
    ragEnabled: false,
    // 필요에 따라 다른 매개변수 사용자 정의
  },
  staging: {
    ragEnabled: false,
    // 필요에 따라 다른 매개변수 사용자 정의
  },
  prod: {
    ragEnabled: true,
    // 필요에 따라 다른 매개변수 사용자 정의
  },
};

CDK context의 env로 지정된 환경이 parameter.ts에 정의되어 있으면 parameter.ts의 값이 우선됩니다. 지정된 env 환경이 parameter.ts에 정의되지 않은 경우 context 값으로 환경이 생성됩니다.

packages/cdk/cdk.json의 context에서 env를 지정하거나 -c로 env를 전환할 수 있습니다.

// cdk.json
{
  "context": {
    "env": "dev"
  }
}

# cdk.json context.env에 지정된 env로 배포
npm run cdk:deploy

# 환경을 prod로 설정하여 배포
npm run cdk:deploy -- -c env=prod

로컬에서 개발할 때는 다음과 같이 env를 지정합니다:

# cdk.json context.env에 지정된 백엔드를 사용하여 로컬 개발
npm run web:devw

# dev2 환경 백엔드를 사용하여 로컬 개발
npm run web:devw --env=dev2

cdk.json 값 변경 방법¶

packages/cdk/cdk.json의 context 아래 값을 변경하여 설정을 구성합니다. 예를 들어, "ragEnabled": true로 설정하면 RAG 채팅 사용 사례가 활성화됩니다. context 값을 설정한 후 다음 명령으로 재배포하여 설정을 적용합니다:

npm run cdk:deploy

사용 사례 구성¶

RAG Chat (Amazon Kendra) 사용 사례 활성화¶

ragEnabled를 true로 설정합니다. (기본값은 false)

검색 성능을 향상시킬 수 있는 선호 언어로 kendraIndexLanguage를 설정할 수도 있습니다.

parameter.ts 편집

// parameter.ts
const envs: Record<string, Partial<StackInput>> = {
  dev: {
    ragEnabled: true,
    kendraIndexLanguage: 'en',
  },
};

배포 옵션¶

구성 방법¶

parameter.ts 값 변경 방법¶

cdk.json 값 변경 방법¶

사용 사례 구성¶

RAG Chat (Amazon Kendra) 사용 사례 활성화¶

기존 Amazon Kendra 인덱스 사용¶

RAG Chat (Knowledge Base) 사용 사례 활성화¶

고급 파싱 활성화¶

청킹 전략 변경¶

변경사항 적용을 위한 Knowledge Base 또는 OpenSearch Service 재생성¶

관리 콘솔에서 OpenSearch Service 인덱스 확인 방법¶

메타데이터 필터 구성¶

Agent Chat 사용 사례 활성화¶

Code Interpreter Agent 배포¶

Search Agent 배포¶

수동으로 생성된 Agents 추가¶

Amazon Bedrock Agent용 Knowledge Bases 배포¶

Agents 인라인 표시¶

MCP Chat 사용 사례 활성화¶

Flow Chat 사용 사례 활성화¶

Voice Chat 사용 사례 활성화¶

Image Generation 사용 사례 활성화¶

Video Generation 사용 사례 활성화¶

Video Analysis 사용 사례 활성화¶

프롬프트 최적화 도구 활성화¶

특정 사용 사례 숨기기¶

Use Case Builder 구성¶

Amazon Bedrock 모델 변경¶

여러 지역의 모델 동시 사용¶

예제: 도쿄 지역을 기본으로 사용하면서 버지니아 북부 및 오레곤 지역의 최신 모델도 사용¶

예제: us-east-1 (버지니아)에서 Amazon Bedrock 모델 사용¶

예제: us-west-2 (오레곤)에서 Amazon Bedrock 모델 사용¶

예제: us (버지니아 북부 또는 오레곤)에서 Amazon Bedrock의 교차 지역 추론 모델 사용¶

예제: ap-northeast-1 (도쿄)에서 Amazon Bedrock 모델 사용¶

Amazon SageMaker를 사용한 사용자 정의 모델 사용¶

배포된 모델을 호출하도록 GenU 구성¶

보안 관련 설정¶

자체 가입 비활성화¶

가입용 이메일 도메인 제한¶

AWS WAF 제한 활성화¶

IP 주소 제한¶

지리적 제한¶

SAML 인증¶

가드레일¶

비용 관련 설정¶

Kendra 인덱스 자동 생성 및 삭제 일정 설정¶

모니터링 대시보드 활성화¶

사용자 정의 도메인 사용¶

다른 AWS 계정에서 Bedrock 사용¶

동일한 계정에서 여러 환경 배포¶