InfoGrab DocsInfoGrab Docs

AWS Bedrock Chat Model 노드 문서

요약

AWS Bedrock Chat Model 노드를 사용하면 AWS Bedrock 플랫폼을 활용하는 LLM 모델을 사용할 수 있습니다. 이 페이지에서는 AWS Bedrock Chat Model 노드의 노드 매개변수와 더 많은 리소스로 연결되는 링크를 확인할 수 있습니다.

AWS Bedrock Chat Model 노드를 사용하면 AWS Bedrock 플랫폼을 활용하는 LLM 모델을 사용할 수 있습니다.

이 페이지에서는 AWS Bedrock Chat Model 노드의 노드 매개변수와 더 많은 리소스로 연결되는 링크를 확인할 수 있습니다.

Note

자격 증명

이 노드의 인증 정보는 여기에서 확인할 수 있습니다.

프라이빗 DNS 없이 VPC 인터페이스 엔드포인트(PrivateLink)를 통해 Bedrock을 라우팅하는 경우, 자격 증명에서 Bedrock Endpoint와 Bedrock Runtime Endpoint 커스텀 엔드포인트를 설정하세요.

참고

이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.

노드 매개변수#

  • Authentication: 인증 방법을 선택합니다:
    • AWS (IAM): IAM 액세스 키를 사용합니다. AWS 자격 증명을 선택합니다.
    • AWS (Assume Role): 일시적으로 IAM 역할을 위임받습니다. AWS (Assume Role) 자격 증명을 선택합니다.
  • Model: 완성(completion)을 생성하는 모델을 선택합니다.

사용 가능한 모델에 대해 자세히 알아보려면 Amazon Bedrock 모델 문서를 참고하세요.

노드 옵션#

  • Maximum Number of Tokens: 사용할 최대 토큰 수를 입력합니다. 이 값이 완성 길이를 설정합니다.
  • Sampling Temperature: 이 옵션을 사용하여 샘플링 과정의 무작위성을 제어합니다. 온도(temperature)가 높을수록 더 다양한 샘플링이 이루어지지만, 환각(hallucination)이 발생할 위험이 커집니다.
  • Top P: 토큰 선택을 위한 확률 임계값을 설정합니다. 값이 낮을수록 확률이 높은 토큰으로 풀이 제한되고, 값이 높을수록 더 다양한 옵션을 허용합니다.
  • Max Retries: 요청을 재시도할 최대 횟수를 입력합니다.
  • Timeout: 요청이 완료될 때까지 대기할 최대 시간을 밀리초 단위로 입력합니다. 긴 생성 작업의 경우 이 값을 늘리세요. 타임아웃을 비활성화하려면 0으로 설정합니다.
  • Additional Model Request Fields: 모델 계열별 추론 매개변수를 JSON으로 입력합니다. 예를 들어 Claude의 top_k 또는 Nova의 inferenceConfig가 있습니다. 각 모델 계열이 지원하는 매개변수는 AWS 모델 매개변수 문서를 참고하세요.
  • Latency Optimization: 요청이 Standard(표준) 또는 Optimized(최적화) 지연 시간 중 어느 것을 사용할지 선택합니다. Optimized 모드는 지원되는 모델과 리전에서 응답 시간을 단축할 수 있습니다. 지원 여부는 AWS 지연 시간 최적화 추론 문서를 참고하세요.
  • Guardrail: 요청에 Amazon Bedrock 가드레일을 적용합니다. 자세한 내용은 AWS Guardrails 사용하기를 참고하세요.

Using AWS Guardrails#

Guardrails를 사용하면 조직에서 모델 호출에 콘텐츠 및 안전 정책을 적용할 수 있습니다. 가드레일은 모델과 동일한 AWS 리전에 존재해야 합니다. Guardrail 옵션에는 다음 필드가 있습니다:

  • Guardrail Identifier: 적용할 가드레일의 ID 또는 전체 ARN입니다.
  • Guardrail Version: 사용할 가드레일 버전입니다. 숫자 버전 문자열(예: 1) 또는 작업 초안을 의미하는 DRAFT를 사용할 수 있으며, 기본값은 DRAFT입니다.
  • Trace: AWS가 응답에 가드레일 평가에 대한 진단 추적 정보를 포함할지 여부입니다: Disabled(기본값), Enabled, 또는 Enabled (Full) 중에서 선택합니다. 참고: 추적을 활성화하면 AWS가 응답에 가드레일 평가 세부 정보(일치한 입력 콘텐츠, 예: PII 발견 내용을 그대로 포함할 수 있음)를 포함합니다. n8n은 현재 이를 AI 로그에 노출하지 않습니다.

가드레일이 개입하면 노드는 모델 출력 대신 가드레일에 구성된 차단 메시지를 오류가 아닌 정상 응답으로 반환합니다. n8n은 근본적인 중단 사유(stop reason)를 노출하지 않으므로, 다운스트림에서 개입 여부를 감지하려면 가드레일의 차단 메시지 텍스트와 일치시키세요. 잘못된 가드레일 식별자나 버전을 지정하면 AWS 검증 오류로 노드가 실패합니다. Guardrails는 스트리밍 요청과 비스트리밍 요청 모두에 적용됩니다.

Note

IAM 권한

자격 증명에는 호출 권한 외에도 가드레일 리소스에 대한 bedrock:ApplyGuardrail 권한이 필요합니다. 이 권한이 없으면 가드레일이 설정된 후 요청이 AccessDeniedException으로 실패합니다. 조직에서 모든 호출에 가드레일을 요구해야 하는 경우, 이 선택적 노드 필드에 의존하기보다 IAM에서 호출 권한에 bedrock:GuardrailIdentifier 조건 키를 강제하세요.

프록시 제한 사항#

이 노드는 NO_PROXY 환경 변수를 지원하지 않습니다.

템플릿 및 예제#

AWS Bedrock Chat Model 노드 문서 통합 템플릿 찾아보기 또는 전체 템플릿 검색

관련 자료#

해당 서비스에 대한 자세한 내용은 LangChain의 AWS Bedrock Chat Model 문서를 참고하세요.

참고

이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.

AWS Bedrock Chat Model 노드 문서

n8n v2.34
원문 보기

요약

AWS Bedrock Chat Model 노드를 사용하면 AWS Bedrock 플랫폼을 활용하는 LLM 모델을 사용할 수 있습니다. 이 페이지에서는 AWS Bedrock Chat Model 노드의 노드 매개변수와 더 많은 리소스로 연결되는 링크를 확인할 수 있습니다.

AWS Bedrock Chat Model 노드를 사용하면 AWS Bedrock 플랫폼을 활용하는 LLM 모델을 사용할 수 있습니다.

이 페이지에서는 AWS Bedrock Chat Model 노드의 노드 매개변수와 더 많은 리소스로 연결되는 링크를 확인할 수 있습니다.

Note

자격 증명

이 노드의 인증 정보는 여기에서 확인할 수 있습니다.

프라이빗 DNS 없이 VPC 인터페이스 엔드포인트(PrivateLink)를 통해 Bedrock을 라우팅하는 경우, 자격 증명에서 Bedrock Endpoint와 Bedrock Runtime Endpoint 커스텀 엔드포인트를 설정하세요.

참고

이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.

노드 매개변수#

  • Authentication: 인증 방법을 선택합니다:
    • AWS (IAM): IAM 액세스 키를 사용합니다. AWS 자격 증명을 선택합니다.
    • AWS (Assume Role): 일시적으로 IAM 역할을 위임받습니다. AWS (Assume Role) 자격 증명을 선택합니다.
  • Model: 완성(completion)을 생성하는 모델을 선택합니다.

사용 가능한 모델에 대해 자세히 알아보려면 Amazon Bedrock 모델 문서를 참고하세요.

노드 옵션#

  • Maximum Number of Tokens: 사용할 최대 토큰 수를 입력합니다. 이 값이 완성 길이를 설정합니다.
  • Sampling Temperature: 이 옵션을 사용하여 샘플링 과정의 무작위성을 제어합니다. 온도(temperature)가 높을수록 더 다양한 샘플링이 이루어지지만, 환각(hallucination)이 발생할 위험이 커집니다.
  • Top P: 토큰 선택을 위한 확률 임계값을 설정합니다. 값이 낮을수록 확률이 높은 토큰으로 풀이 제한되고, 값이 높을수록 더 다양한 옵션을 허용합니다.
  • Max Retries: 요청을 재시도할 최대 횟수를 입력합니다.
  • Timeout: 요청이 완료될 때까지 대기할 최대 시간을 밀리초 단위로 입력합니다. 긴 생성 작업의 경우 이 값을 늘리세요. 타임아웃을 비활성화하려면 0으로 설정합니다.
  • Additional Model Request Fields: 모델 계열별 추론 매개변수를 JSON으로 입력합니다. 예를 들어 Claude의 top_k 또는 Nova의 inferenceConfig가 있습니다. 각 모델 계열이 지원하는 매개변수는 AWS 모델 매개변수 문서를 참고하세요.
  • Latency Optimization: 요청이 Standard(표준) 또는 Optimized(최적화) 지연 시간 중 어느 것을 사용할지 선택합니다. Optimized 모드는 지원되는 모델과 리전에서 응답 시간을 단축할 수 있습니다. 지원 여부는 AWS 지연 시간 최적화 추론 문서를 참고하세요.
  • Guardrail: 요청에 Amazon Bedrock 가드레일을 적용합니다. 자세한 내용은 AWS Guardrails 사용하기를 참고하세요.

Using AWS Guardrails#

Guardrails를 사용하면 조직에서 모델 호출에 콘텐츠 및 안전 정책을 적용할 수 있습니다. 가드레일은 모델과 동일한 AWS 리전에 존재해야 합니다. Guardrail 옵션에는 다음 필드가 있습니다:

  • Guardrail Identifier: 적용할 가드레일의 ID 또는 전체 ARN입니다.
  • Guardrail Version: 사용할 가드레일 버전입니다. 숫자 버전 문자열(예: 1) 또는 작업 초안을 의미하는 DRAFT를 사용할 수 있으며, 기본값은 DRAFT입니다.
  • Trace: AWS가 응답에 가드레일 평가에 대한 진단 추적 정보를 포함할지 여부입니다: Disabled(기본값), Enabled, 또는 Enabled (Full) 중에서 선택합니다. 참고: 추적을 활성화하면 AWS가 응답에 가드레일 평가 세부 정보(일치한 입력 콘텐츠, 예: PII 발견 내용을 그대로 포함할 수 있음)를 포함합니다. n8n은 현재 이를 AI 로그에 노출하지 않습니다.

가드레일이 개입하면 노드는 모델 출력 대신 가드레일에 구성된 차단 메시지를 오류가 아닌 정상 응답으로 반환합니다. n8n은 근본적인 중단 사유(stop reason)를 노출하지 않으므로, 다운스트림에서 개입 여부를 감지하려면 가드레일의 차단 메시지 텍스트와 일치시키세요. 잘못된 가드레일 식별자나 버전을 지정하면 AWS 검증 오류로 노드가 실패합니다. Guardrails는 스트리밍 요청과 비스트리밍 요청 모두에 적용됩니다.

Note

IAM 권한

자격 증명에는 호출 권한 외에도 가드레일 리소스에 대한 bedrock:ApplyGuardrail 권한이 필요합니다. 이 권한이 없으면 가드레일이 설정된 후 요청이 AccessDeniedException으로 실패합니다. 조직에서 모든 호출에 가드레일을 요구해야 하는 경우, 이 선택적 노드 필드에 의존하기보다 IAM에서 호출 권한에 bedrock:GuardrailIdentifier 조건 키를 강제하세요.

프록시 제한 사항#

이 노드는 NO_PROXY 환경 변수를 지원하지 않습니다.

템플릿 및 예제#

AWS Bedrock Chat Model 노드 문서 통합 템플릿 찾아보기 또는 전체 템플릿 검색

관련 자료#

해당 서비스에 대한 자세한 내용은 LangChain의 AWS Bedrock Chat Model 문서를 참고하세요.

참고

이 섹션의 상세 내용은 n8n 공식 문서를 참조하세요.