프롬프트 관리를 사용하여 프롬프트 생성 - Amazon Bedrock

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

프롬프트 관리를 사용하여 프롬프트 생성

프롬프트를 만들 때 다음과 같은 옵션을 선택할 수 있습니다.

  • FM이 출력을 생성하기 위한 입력 역할을 하는 프롬프트 메시지를 작성합니다.

  • 이중 중괄호를 사용하여 프롬프트를 호출할 때 채울 수 있는 프롬프트 메시지에 변수(의 경우와 같음{{variable}})를 포함합니다.

  • 프롬프트를 호출할 모델을 선택하거나 에이전트와 함께 프롬프트를 사용하려면 지정하지 않은 상태로 둡니다. 모델을 선택하는 경우 사용할 추론 구성을 수정할 수도 있습니다. 여러 모델의 추론 파라미터를 확인하려면 파운데이션 모델의 추론 요청 파라미터 및 응답 필드 섹션을 참조하세요.

프롬프트에 대해 선택한 모델이 Converse를 지원하는 경우API(자세한 내용은 참조와 대화 수행 Converse API 작업) 프롬프트를 구성할 때 다음을 포함할 수 있습니다.

  • 모델에 지침 또는 컨텍스트를 제공하는 시스템 프롬프트입니다.

  • 이전 프롬프트(사용자 메시지) 및 모델 응답(보조 메시지)은 최종 사용자 메시지에 대한 응답을 생성할 때 모델이 고려할 대화 기록입니다.

  • (모델에서 지원하는 경우) 응답을 생성할 때 사용할 모델용 도구입니다.

프롬프트 관리를 사용하여 프롬프트를 생성하는 방법을 알아보려면 원하는 메서드의 탭을 선택한 다음 다음 단계를 따릅니다.

Console
프롬프트를 생성하려면

  1. IAM Amazon Bedrock 권한이 있는 역할을 AWS Management Console 사용하여에 로그인하고 시작하기에서 Amazon Bedrock 콘솔을 AWS Management Console 엽니다.

  2. 왼쪽 탐색 창에서 프롬프트 관리를 선택합니다. 그런 다음 프롬프트 생성을 선택합니다.

  3. 프롬프트의 이름과 선택적 설명을 입력합니다.

  4. 고객 관리형 키로 프롬프트를 암호화하려면 KMS 키 선택 섹션에서 암호화 설정 사용자 지정(고급)을 선택합니다. 이 필드를 생략하면 프롬프트가 로 암호화됩니다 AWS 관리형 키. 자세한 내용은 AWS KMS 키를 참조하세요.

  5. 프롬프트 생성을 선택합니다. 프롬프트가 생성되고 새로 생성된 프롬프트에 대한 프롬프트 빌더로 이동하여 프롬프트를 구성할 수 있습니다.

  6. 다음 절차를 계속 수행하여 프롬프트를 구성하거나 나중에 프롬프트 빌더로 돌아갈 수 있습니다.

프롬프트를 구성하는 방법

  1. 프롬프트 빌더가 아직 열려 있지 않은 경우 다음을 수행합니다.

    1. IAM Amazon Bedrock 권한이 있는 역할을 AWS Management Console 사용하여에 로그인하고 시작하기에서 Amazon Bedrock 콘솔을 AWS Management Console 엽니다.

    2. 왼쪽 탐색 창에서 프롬프트 관리를 선택합니다. 그런 다음 프롬프트 섹션에서 프롬프트를 선택합니다.

    3. 프롬프트 초안 섹션에서 프롬프트 빌더에서 편집을 선택합니다.

  2. 프롬프트 창을 사용하여 프롬프트를 구성합니다. 마지막 사용자 메시지 상자에 프롬프트를 입력합니다. 모델이 Converse API 또는를 지원하는 경우 AnthropicClaude 메시지 API- 컨텍스트를 위해 시스템 프롬프트와 이전 사용자 메시지 및 도우미 메시지를 포함할 수도 있습니다.

    프롬프트를 작성할 때 변수를 이중 중괄호로 포함할 수 있습니다(의 경우와 같음{{variable}}). 포함하는 각 변수는 테스트 변수 섹션에 표시됩니다.

  3. (선택 사항) 다음과 같은 방법으로 프롬프트를 수정할 수 있습니다.

    • 구성 창에서 다음을 수행합니다.

      1. 추론 실행을 위한 생성형 AI 리소스를 선택합니다.

        참고

        에이전트를 선택하는 경우 콘솔에서만 프롬프트를 테스트할 수 있습니다. 에서 에이전트를 사용하여 프롬프트를 테스트하는 방법을 알아보려면 섹션을 API참조하세요프롬프트 관리를 사용하여 프롬프트 테스트.

      2. 추론 파라미터를 설정합니다.

      3. 선택한 모델이 도구를 지원하는 경우 프롬프트와 함께 도구를 사용하도록 도구 구성을 선택합니다.

    • 프롬프트의 다양한 변형을 비교하려면 작업을 선택하고 프롬프트 변형 비교를 선택합니다. 비교 페이지에서 다음 작업을 수행할 수 있습니다.

      • 변형을 추가하려면 더하기 기호를 선택합니다. 최대 3개의 변형을 추가할 수 있습니다.

      • 변형의 세부 정보를 지정한 후 테스트 변수를 지정하고 실행을 선택하여 변형의 출력을 테스트할 수 있습니다.

      • 변형을 삭제하려면 점 3개를 선택하고 비교에서 제거를 선택합니다.

      • 규격 초안을 바꾸고 비교 모드를 종료하려면 초안으로 저장을 선택합니다. 다른 모든 변형은 삭제됩니다.

      • 비교 모드를 종료하려면 비교 모드 종료를 선택합니다.

  4. 프롬프트 구성을 마치면 다음과 같은 옵션을 선택할 수 있습니다.

API

프롬프트를 생성하려면 Amazon Bedrock용 에이전트 빌드 시간 엔드포인트로 CreatePrompt 요청을 보냅니다.

필수 필드는 다음과 같습니다.

필드 간략한 설명
name 프롬프트의 이름입니다.
variants 프롬프트에 대한 여러 구성 목록입니다(아래 참조).
defaultVariant 기본 변형의 이름입니다.

variants 목록의 각 변형은 다음 일반 구조의 PromptVariant 객체입니다.

{
        "name": "string",
        # modelId or genAiResource (see below)
        "templateType": "TEXT",
        "templateConfiguration": # see below,
        "inferenceConfiguration": {
            "text": {
                "maxTokens": int,
                "stopSequences": ["string", ...],
                "temperature": float,
                "topP": float
            }
        },
        "additionalModelRequestFields": {
            "key": "value",
            ...
        },
        "metadata": [
            {
                "key": "string",
                "value": "string"
            },
            ...
        ]
}

다음과 같이 필드를 입력합니다.

  • name - 변형의 이름을 입력합니다.

  • 사용할 모델 호출 리소스에 따라 다음 필드 중 하나를 포함합니다.

    • modelId - 프롬프트에 사용할 파운데이션 모델 또는 추론 프로파일을 지정하려면 ARN 또는 ID를 입력합니다.

    • genAiResource - 에이전트를 지정하려면 ID 또는를 입력합니다ARN. 의 값은 다음 형식의 JSON 객체genAiResource입니다.

      {
    "genAiResource": {
    "agent": {
        "agentIdentifier": "string"
    }   
}
      참고

      genAiResource 필드를 포함하는 경우 콘솔에서만 프롬프트를 테스트할 수 있습니다. 에서 에이전트를 사용하여 프롬프트를 테스트하려면 프롬프트의 텍스트를의 inputText 필드에 직접 입력해야 API합니다. InvokeAgent 요청.

  • templateType – TEXT 또는를 입력합니다CHAT. CHAT는 Converse를 지원하는 모델과만 호환됩니다API.

  • templateConfiguration - 값은 지정한 템플릿 유형에 따라 다릅니다.

  • inferenceConfiguration - text 필드가에 매핑됩니다PromptModelInferenceConfiguration. 이 필드에는 모든 모델에 공통적인 추론 파라미터가 포함되어 있습니다. 추론 파라미터에 대한 자세한 내용은 추론 파라미터를 사용하여 응답 생성에 영향을 주는 방법 섹션을 참조하세요.

  • additionalModelRequest필드 -이 필드를 사용하여 추론을 실행하는 모델과 관련된 추론 파라미터를 지정합니다. 모델별 추론 파라미터에 대한 자세한 내용은 섹션을 참조하세요파운데이션 모델의 추론 요청 파라미터 및 응답 필드.

  • metadata - 프롬프트 변형과 연결할 메타데이터입니다. 배열에 키-값 페어를 추가하여 메타데이터로 프롬프트 변형에 태그를 지정할 수 있습니다.

다음 필드는 선택 사항입니다.

필드 사용 사례
설명 프롬프트에 대한 설명을 제공합니다.
clientToken API 요청이 한 번만 완료되도록 하려면 자세한 내용은 Ensuring idempotency를 참조하세요.
tags 태그를 흐름에 연결합니다. 자세한 내용은 Amazon Bedrock 리소스 태그 지정 단원을 참조하십시오.

응답은 DRAFT 버전을 생성하고 ID를 반환하며ARN,이 ID를 다른 프롬프트 관련 API 요청의 프롬프트 식별자로 사용할 수 있습니다.