View a markdown version of this page

Liste des recommandations - Amazon Bedrock AgentCore
Exemples de codeParamètres de demandeRéponseErreurs

Liste des recommandations

Répertoriez toutes les recommandations de votre compte. Les résultats sont paginés et peuvent être filtrés par statut.

Exemples de code

Exemple
AgentCore CLI

Répertoriez les tâches recommandées précédentes (les tâches en cours sont actualisées depuis le service) :

agentcore view recommendation

Afficher une seule recommandation par ID :

agentcore view recommendation <recommendation-id>

Ajoutez --json pour une sortie lisible par machine :

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

Filtrer par statut :

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

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

Paginez tous les résultats :

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

Paramètres de demande

Paramètre Type Obligatoire Description

maxResults

Entier

Non

Nombre maximum de résultats par page. Gamme : 1 à 100

nextToken

String

Non

Jeton de pagination provenant d'une réponse précédente.

statusFilter

String

Non

Filtrez par statut. L'un des : PENDINGIN_PROGRESS,COMPLETED,FAILED,DELETING.

Réponse

Champ Type Description

recommendationSummaries

List

Liste des résumés des recommandations.

nextToken

String

Jeton de pagination pour la page suivante. Absent lorsqu'il n'y a plus de résultats.

Champs récapitulatifs des recommandations

Champ Type Description

recommendationId

String

Identifiant unique.

recommendationArn

String

ARN de la recommandation.

name

String

Le nom de la recommandation.

description

String

Description facultative, si elle est fournie.

type

String

SYSTEM_PROMPT_RECOMMENDATION ou TOOL_DESCRIPTION_RECOMMENDATION.

status

String

État actuel :PENDING,IN_PROGRESS,COMPLETED,FAILED,DELETING.

createdAt

Horodatage

Date à laquelle la recommandation a été créée.

updatedAt

Horodatage

Date de dernière mise à jour de la recommandation.

Pour récupérer tous les détails et les résultats d'une recommandation, utilisez Obtenir une recommandation avec lerecommendationId.

Erreurs

Erreur Statut HTTP Description

ValidationException

400

Paramètres de pagination ou valeur de filtre d'état non valides.

AccessDeniedException

403

Autorisations insuffisantes.

ThrottlingException

429

Le taux de demandes a été dépassé.

InternalServerException

500

Service-side erreur.