View a markdown version of this page

권장 사항 나열 - Amazon Bedrock AgentCore
코드 샘플요청 파라미터응답오류

권장 사항 나열

계정의 모든 권장 사항을 나열합니다. 결과는 페이지 매김되며 상태별로 필터링할 수 있습니다.

코드 샘플

예
AgentCore CLI

과거 권장 작업 나열(실행 작업은 서비스에서 새로 고쳐짐):

agentcore view recommendation

ID별로 단일 권장 사항을 봅니다.

agentcore view recommendation <recommendation-id>

기계가 읽을 수 있는 출력을 --json 위해를 추가합니다.

agentcore view recommendation --json
AWS SDK (boto3)
import boto3

client = boto3.client("bedrock-agentcore", region_name="us-west-2")

# List all recommendations
response = client.list_recommendations()
for rec in response["recommendationSummaries"]:
    print(f"{rec['recommendationId']} | {rec['name']} | {rec['type']} | {rec['status']}")

상태별로 필터링:

response = client.list_recommendations(statusFilter="COMPLETED")

for rec in response["recommendationSummaries"]:
    print(f"{rec['recommendationId']}  {rec['name']}  {rec['status']}")

모든 결과를 페이지 매김합니다.

paginator = client.get_paginator("list_recommendations")
for page in paginator.paginate(statusFilter="COMPLETED"):
    for rec in page["recommendationSummaries"]:
        print(rec["recommendationId"])

요청 파라미터

파라미터 유형 필수 설명

maxResults

Integer

아니요

페이지당 최대 결과 수입니다. 범위: 1~100.

nextToken

문자열

No

이전 응답의 페이지 매김 토큰입니다.

statusFilter

문자열

No

상태를 기준으로 필터링합니다. 중 하나: PENDING, IN_PROGRESS, COMPLETED, FAILED, DELETING.

응답

Field 유형 설명

recommendationSummaries

목록

권장 사항 요약 목록입니다.

nextToken

문자열

다음 페이지의 페이지 매김 토큰입니다. 더 이상 결과가 없으면 없습니다.

권장 사항 요약 필드

Field 유형 설명

recommendationId

문자열

고유 식별자입니다.

recommendationArn

문자열

권장 사항의 ARN입니다.

name

문자열

권장 사항 이름입니다.

description

문자열

제공된 경우 선택적 설명입니다.

type

문자열

SYSTEM_PROMPT_RECOMMENDATION 또는 TOOL_DESCRIPTION_RECOMMENDATION

status

문자열

현재 상태: PENDING, IN_PROGRESS, COMPLETED, FAILED, DELETING.

createdAt

타임스탬프

권장 사항이 생성된 시간입니다.

updatedAt

타임스탬프

권장 사항이 마지막으로 업데이트된 시간입니다.

권장 사항의 전체 세부 정보 및 결과를 검색하려면 에서 권장 사항 가져오기를 사용합니다recommendationId.

오류

오류 HTTP 상태 설명

ValidationException

400

페이지 매김 파라미터 또는 상태 필터 값이 잘못되었습니다.

AccessDeniedException

403

권한이 부족합니다.

ThrottlingException

429

요청 속도가 초과되었습니다.

InternalServerException

500

서비스 측 오류입니다.