시스템 프롬프트 권장 사항 시작
에이전트에 최적화된 시스템 프롬프트를 생성하려면 권장 사항을 시작합니다. 이 서비스는 에이전트 추적을 분석하고, 실패 패턴을 식별하고, 대상 평가자의 성능을 개선하는 수정된 시스템 프롬프트를 생성합니다.
참고
권장 사항은 LLMs에서 생성됩니다. 적용하기 전에 검토하고 테스트합니다.
코드 샘플
예
요청 파라미터
| 파라미터 | 유형 | 필수 | 설명 |
|---|---|---|---|
|
|
문자열 |
예 |
권장 사항의 이름입니다. 최대 48자입니다. 패턴: |
|
|
문자열 |
예 |
|
|
|
객체 |
예 |
권장 사항에 대한 구성과 |
|
|
문자열 |
No |
선택적 설명 최대 4096자입니다. |
|
|
문자열 |
No |
Idempotency 토큰입니다. 동일한 클라이언트 토큰으로 요청을 재시도하면 서비스는 새 클라이언트 토큰을 생성하는 대신 기존 권장 사항을 반환합니다. |
systemPromptRecommendationConfig 필드
| Field | 유형 | 필수 | 설명 |
|---|---|---|---|
|
|
결합 |
예 |
최적화할 현재 시스템 프롬프트입니다. |
|
|
결합 |
예 |
분석을 위한 추적 소스입니다. 권장 사항은 소스 추적을 참조하세요. |
|
|
객체 |
예 |
대상 평가자를 지정하는 평가 구성입니다. 정확히 하나의 평가자 참조가 있는 |
평가자 선택
개선하려는 방향에 맞는 평가자를 선택합니다. 선택한 평가자는 권장 사항이 최적화되는 대상을 결정합니다. 평가자의 점수가 높으면 최적화 프로그램이 프롬프트를 푸시하는 대상이 됩니다.
기본 제공 평가자를 사용하거나 사용자 지정 평가자 ARN을 제공할 수 있습니다. 다음 지침에 따라 선택합니다.
-
에이전트가 완료해야 할 명확한 작업(예약, 검색, 다단계 워크플로)이 있는 경우가 올바른 신호
Builtin.GoalSuccessRate입니다. -
에이전트가 더 개방형이고 상호 작용 자체의 품질을 중시하는 경우
Builtin.Helpfulness가 더 적합합니다. -
관심 있는 품질이 도메인별로 다르거나 기본 제공 평가자에 의해 캡처되지 않은 경우 사용자 지정 평가자를 사용하여 측정을 가장 잘 표현합니다.
참고
권장 사항은 기본 제공, 사용자 지정 LLM-as-judge 및 코드 기반 평가자를 지원하지만, 평가자는 숫자 값을 최적화 신호로 반환해야 합니다. 사용자 지정 LLM-as-judge 평가자의 경우 numerical 스케일( 아님)ratingScale을 사용하여를 구성합니다categorical. 코드 기반 평가자의 경우 응답 스키마에 value 필드를 포함합니다.
API에서 정확히 하나의 평가자 참조로 evaluationConfig.evaluators 목록에 평가자를 지정합니다.
"evaluationConfig": { "evaluators": [ {"evaluatorArn": "arn:aws:bedrock-agentcore:::evaluator/Builtin.GoalSuccessRate"} ] }
CLI에서 --evaluator 플래그를 사용합니다.
--evaluator Builtin.GoalSuccessRate
시스템 프롬프트 입력 모드
| Mode | CLI 플래그 | API 필드 |
|---|---|---|
|
인라인 텍스트 |
|
|
|
구성 번들 |
|
|
구성 번들을 사용할 때 최적화된 시스템 프롬프트가 적용된 새 번들 버전이 결과에 포함됩니다.
응답
| Field | 유형 | 설명 |
|---|---|---|
|
|
문자열 |
권장 사항의 고유 식별자입니다. |
|
|
문자열 |
권장 사항의 ARN입니다. |
|
|
문자열 |
지정한 이름입니다. |
|
|
문자열 |
|
|
|
문자열 |
초기 상태: |
|
|
타임스탬프 |
권장 사항이 생성된 시간입니다. |
|
|
타임스탬프 |
권장 사항이 마지막으로 업데이트된 시간입니다. |
권장 사항 결과
권장 사항이 COMPLETED 상태에 도달하면(권장 사항 가져오기를 통해 검색) 결과에 다음이 포함됩니다.
| Field | 유형 | 설명 |
|---|---|---|
|
|
문자열 |
최적화된 시스템 프롬프트 텍스트입니다. |
|
|
객체 |
입력이 구성 번들일 때 표시됩니다. 최적화된 프롬프트가 적용된 새 번들 버전을 포함하고 |
|
|
문자열 |
권장 사항이 생성된 이유와 제안된 변경 사항의 근거에 대한 설명입니다. |
|
|
문자열 |
권장 사항이 실패한 경우 표시됩니다. 실패를 설명하는 오류 코드입니다. |
|
|
문자열 |
권장 사항이 실패한 경우 표시됩니다. 사람이 읽을 수 있는 오류 설명입니다. |
오류
| 오류 | HTTP 상태 | 설명 |
|---|---|---|
|
|
400 |
잘못된 요청 파라미터입니다. 필드 제약 조건 및 필수 필드를 확인합니다. |
|
|
403 |
권한이 부족합니다. IAM 정책을 확인합니다. |
|
|
409 |
동일한 클라이언트 토큰을 사용하는 권장 사항이 이미 다른 파라미터와 함께 존재합니다. |
|
|
402 |
최대 동시 권장 사항 수를 초과했습니다. |
|
|
429 |
요청 속도가 초과되었습니다. 지수 백오프를 사용하여 재시도하세요. |
|
|
500 |
서비스 측 오류입니다. 요청을 다시 시도하세요. |