View a markdown version of this page

Enumerar recomendaciones - Amazon Bedrock AgentCore
Ejemplos de códigoParámetros de solicitudRespuestaErrores

Enumerar recomendaciones

Haz una lista de todas las recomendaciones en tu cuenta. Los resultados están paginados y se pueden filtrar por estado.

Ejemplos de código

ejemplo
AgentCore CLI

Enumere los trabajos recomendados anteriormente (los trabajos en ejecución se actualizan desde el servicio):

agentcore view recommendation

Ver una sola recomendación por ID:

agentcore view recommendation <recommendation-id>

Añada --json para obtener una salida legible 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 estado:

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

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

Pagina todos los 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 solicitud

Parámetro Tipo Obligatorio Description (Descripción)

maxResults

Entero

No

Número máximo de resultados por página. Rango: de 1 a 100.

nextToken

Cadena

No

Símbolo de paginación de una respuesta anterior.

statusFilter

Cadena

No

Filtrar por estado. Uno de:PENDING,IN_PROGRESS,COMPLETED,FAILED,DELETING.

Respuesta

Campo Tipo Description (Descripción)

recommendationSummaries

Enumeración

Lista de resúmenes de recomendaciones.

nextToken

Cadena

Símbolo de paginación para la página siguiente. Ausente cuando no hay más resultados.

Campos de resumen de recomendaciones

Campo Tipo Description (Descripción)

recommendationId

Cadena

Identificador único.

recommendationArn

Cadena

ARN de la recomendación.

name

Cadena

El nombre de la recomendación.

description

Cadena

Descripción opcional, si se proporciona.

type

Cadena

SYSTEM_PROMPT_RECOMMENDATION o bien TOOL_DESCRIPTION_RECOMMENDATION.

status

Cadena

Estado actual:PENDING,IN_PROGRESS,COMPLETED,FAILED,DELETING.

createdAt

Timestamp

Cuándo se creó la recomendación.

updatedAt

Timestamp

Cuándo se actualizó la recomendación por última vez.

Para obtener todos los detalles y los resultados de una recomendación, utilice Obtener una recomendación conrecommendationId.

Errores

Error Estado HTTP Description (Descripción)

ValidationException

400

Parámetros de paginación o valor de filtro de estado no válidos.

AccessDeniedException

403

Permisos insuficientes.

ThrottlingException

429

Se superó la tasa de solicitudes.

InternalServerException

500

Service-side error.