본문으로 건너뛰기

BedrockAgent


리소스 아이콘​

리소스 개요​

AWS Bedrock 위에서 실행되는 AI 에이전트를 생성하고 관리하는 서비스입니다.

연관 리소스​

상위 리소스​

리소스 설정 값​

기본 설정​

  • foundation_model : Bedrock에서 사용할 기본 LLM(기반 모델)을 지정하는 옵션 - amazon.titan-text-express-v1, amazon.nova-pro-v1, amazon.nova-lite-v1, amazon.nova-micro-v1, anthropic.claude-sonnet-4-20250514-v1:0, anthropic.claude-sonnet-4-5-20250929-v1:0, anthropic.claude-haiku-4-5-20251001-v1:0, anthropic.claude-3-sonnet-20240229-v1:0, anthropic.claude-3-opus-20240229-v1:0, anthropic.claude-3-haiku-20240307-v1:0, anthropic.claude-3-5-sonnet-20240620-v1:0, anthropic.claude-3-5-sonnet-20241022-v2:0, anthropic.claude-3-5-haiku-20241022-v1:0, anthropic.claude-3-7-sonnet-20250219-v1:0, deepseek.r1-v1, openai.gpt-oss-120b-1, openai.gpt-oss-20b-1, qwen.qwen3-coder-30b-a3b-v1, qwen.qwen3-32b-v1
  • description : 해당 에이전트에 대한 설명
  • idle_session_ttl_in_seconds : 세션이 유휴 상태일 때 자동 종료되기까지의 시간(초)
  • instruction : 에이전트가 따를 기본 지시문(시스템 프롬프트)
  • customer_encryption_key_arn : 사용자가 지정한 KMS 키(ARN)로 Bedrock 리소스 데이터를 암호화하도록 설정
  • target_bedrock_knowledge_base : 지식 베이스와 연결할 Bedrock 에이전트의 ARN
  • knowledge_base_association_description : 지식 베이스와 에이전트 간 연관 관계에 대한 설명
  • knowledge_base_state : 지식 베이스의 현재 상태 - ENABLED, DISABLED

가드레일 설정 (guardrail_configuration)​

  • guardrail_configuration.guardrail_use_method : 가드레일을 적용하는 방식을 지정 - already_exists, create_new
  • guardrail_configuration.guardrail_identifier : 사용할 가드레일의 고유 식별자(ID)를 지정
  • guardrail_configuration.target_bedrock_guardrail : 연결할 Bedrock 가드레일 리소스를 지정
  • guardrail_configuration.guardrail_version : 사용할 가드레일 리소스의 버전을 지정

프롬프트 오버라이드 설정 (prompt_override_configuration)​

프롬프트 설정 (prompt_override_configuration.prompt_configurations)​

  • prompt_override_configuration.prompt_configurations.prompt_creation_mode : 프롬프트를 자동 생성할지 수동 지정할지를 설정 - DEFAULT, OVERRIDDEN

  • prompt_override_configuration.prompt_configurations.prompt_type : 프롬프트의 유형을 지정 - PRE_PROCESSING, ORCHESTRATION, POST_PROCESSING, KNOWLEDGE_BASE_RESPONSE_GENERATION

  • prompt_override_configuration.prompt_configurations.base_prompt_template : 프롬프트의 기본 문장 구조(템플릿)를 정의

  • prompt_override_configuration.prompt_configurations.prompt_state : 프롬프트의 현재 상태 - ENABLED, DISABLED

  • prompt_override_configuration.prompt_configurations.parser_mode : 모델의 출력 형식을 해석하는 방식 - DEFAULT, OVERRIDDEN

  • prompt_override_configuration.prompt_configurations.max_length : 프롬프트 실행 시 모델 응답의 최대 길이

  • prompt_override_configuration.prompt_configurations.stop_sequences : 모델이 텍스트 생성을 중단해야 하는 문자열 시퀀스를 지정

  • prompt_override_configuration.prompt_configurations.temperature : 생성 결과의 창의성(무작위성)을 조절하는 옵션

  • prompt_override_configuration.prompt_configurations.top_p : 확률 누적값 기반으로 단어 선택 범위를 제한하는 옵션

  • prompt_override_configuration.prompt_configurations.top_k : 확률이 높은 상위 K개의 단어만 후보로 두는 옵션

  • prompt_override_configuration.override_lambda : 기본 프롬프트 동작을 커스터마이징하기 위해 호출할 AWS Lambda 함수를 지정

참고 자료​