View a markdown version of this page

Listagem das recomendações - Amazon Bedrock AgentCore
Exemplos de códigoParâmetros de solicitaçãoRespostaErros

Listagem das recomendações

Liste todas as recomendações em sua conta. Os resultados são paginados e podem ser filtrados por status.

Exemplos de código

exemplo
AgentCore CLI

Listar trabalhos de recomendação anteriores (os trabalhos em execução são atualizados a partir do serviço):

agentcore view recommendation

Veja uma única recomendação por ID:

agentcore view recommendation <recommendation-id>

Adicione --json para obter uma saída legível por máquina:

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']}")

Filtrar por status:

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

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

Pagine todos os resultados:

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

Parâmetros de solicitação

Parâmetro Tipo Obrigatório Description

maxResults

Inteiro

Não

Número máximo de resultados por página. Intervalo: 1—100.

nextToken

String

Não

Token de paginação de uma resposta anterior.

statusFilter

String

Não

Filtrar por status. Um dos: PENDINGIN_PROGRESS,COMPLETED,FAILED,DELETING.

Resposta

Campo Tipo Description

recommendationSummaries

Lista

Lista de resumos de recomendações.

nextToken

String

Token de paginação para a próxima página. Ausente quando não há mais resultados.

Campos de resumo da recomendação

Campo Tipo Description

recommendationId

String

Identificador exclusivo.

recommendationArn

String

ARN da recomendação.

name

String

O nome da recomendação.

description

String

Descrição opcional, se fornecida.

type

String

SYSTEM_PROMPT_RECOMMENDATION ou TOOL_DESCRIPTION_RECOMMENDATION.

status

String

Status atual:PENDING,IN_PROGRESS,COMPLETED,FAILED,DELETING.

createdAt

Timestamp

Quando a recomendação foi criada.

updatedAt

Timestamp

Quando a recomendação foi atualizada pela última vez.

Para recuperar todos os detalhes e resultados de uma recomendação, use Obter uma recomendação com o. recommendationId

Erros

Erro Status HTTP Description

ValidationException

400

Parâmetros de paginação ou valor do filtro de status inválidos.

AccessDeniedException

403

Permissões insuficientes.

ThrottlingException

429

Taxa de solicitações excedida.

InternalServerException

500

Service-side erro.