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

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

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

참고

프롬프트 관리가 미리 보기 중이며 변경될 수 있습니다.

프롬프트를 생성할 때 다음 옵션이 있습니다.

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

  • 런타임에 채울 수 있는 변수를 프롬프트 메시지에 포함합니다.

  • 프롬프트를 실행할 모델을 선택하거나 런타임에 채우도록 합니다. 모델을 선택하는 경우 사용할 추론 구성을 수정할 수도 있습니다. 다양한 모델에 대한 추론 파라미터를 보려면 섹션을 참조하세요파운데이션 모델의 추론 요청 파라미터 및 응답 필드.

  • 다양한 메시지, 모델 또는 구성을 사용하는 프롬프트 변형을 생성하여 출력을 비교하여 사용 사례에 가장 적합한 변형을 결정할 수 있습니다.

프롬프트 관리를 사용하여 프롬프트를 생성하는 방법을 알아보려면 선택한 방법에 해당하는 탭을 선택하고 다음 단계를 따릅니다.

Console
프롬프트를 생성하려면

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

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

  3. (선택 사항) 프롬프트의 기본 이름과 해당 설명을 변경합니다.

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

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

프롬프트를 구성하려면

  1. 프롬프트 빌더에 아직 없는 경우 다음을 수행합니다.

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

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

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

  2. 프롬프트 창의 메시지 상자에 프롬프트를 입력합니다. 이중 곱슬 브레이스를 사용하여 변수( {{variable}}). 프롬프트 변수에 대한 다음 사항에 유의하세요.

    • 포함하는 각 변수는 테스트 변수 섹션에 표시됩니다.

    • 프롬프트를 테스트하거나 프롬프트 흐름에서 프롬프트를 구성할 때 이러한 변수를 실제 값으로 바꿀 수 있습니다.

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

    • 구성 창에서 추론 실행 모델을 선택하고 추론 파라미터 를 설정합니다.

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

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

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

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

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

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

  4. 프롬프트 구성을 마치면 다음 옵션이 있습니다.

API

프롬프트를 생성하려면 Agents for Amazon Bedrock 빌드 시간 엔드포인트 를 사용하여 CreatePrompt 요청(요청 및 응답 형식과 필드 세부 정보는 링크 참조)을 보냅니다.

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

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

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

{
        "name": "string",
        "modelId": "string",
        "templateType": "TEXT",
        "templateConfiguration": {
            "text": {
                "text": "string",
                "inputVariables": [
                    {
                        "name": "string"
                    },
                    ...
                ]
            }
        },
        "inferenceConfiguration": {
            "text": {
                "maxTokens": int,
                "stopSequences": ["string", ...],
                "temperature": float,
                "topK": int,
                "topP": float
            }
        },
        "metadata": [
            {
                "key": "string",
                "value": "string"
            },
            ...
        ]
}

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

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

  • modelId - 추론을 실행할 모델 ID 또는 추론 프로파일을 입력합니다.

  • templateType – 를 입력합니다TEXT(현재 텍스트 프롬프트만 지원됨).

  • templateConfiguration - text 필드가 에 매핑됩니다TextPromptTemplateConfiguration. 다음 필드를 작성합니다.

    • 텍스트 - 프롬프트에 대한 메시지입니다. 변수를 이중 컬 브레이스로 묶습니다.{{variable}}.

    • inputVariables - 목록의 각 객체에 대해 name 필드에 생성한 각 변수를 입력합니다.

  • inferenceConfiguration - text 필드가 에 매핑됩니다PromptModelInferenceConfiguration. 추론 파라미터에 대한 자세한 내용은 섹션을 참조하세요추론 파라미터를 사용한 영향 응답 생성.

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

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

필드 사용 사례
설명 프롬프트에 대한 설명을 제공합니다.
clientToken API 요청이 한 번만 완료되도록 하려면 자세한 내용은 Idmpotency 보장을 참조하세요.
tags 태그를 흐름과 연결합니다. 자세한 내용은 Amazon Bedrock 리소스 태그 지정 단원을 참조하십시오.
customerEncryptionKeyArn KMS 키를 사용하여 흐름을 암호화합니다. 자세한 내용은 Amazon Bedrock이 흐름을 암호화 및 복호화할 수 있도록 허용하는 주요 정책 단원을 참조하십시오.

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