View a markdown version of this page

Empfehlungen auflisten - Amazon Grundgestein AgentCore
CodebeispieleAnforderungsparameterAntwortFehler

Empfehlungen auflisten

Listet alle Empfehlungen in Ihrem Konto auf. Die Ergebnisse sind paginiert und können nach Status gefiltert werden.

Codebeispiele

Beispiel
AgentCore CLI

Frühere Empfehlungsjobs auflisten (laufende Jobs werden vom Service aktualisiert):

agentcore view recommendation

Eine einzelne Empfehlung nach ID anzeigen:

agentcore view recommendation <recommendation-id>

--jsonFür maschinenlesbare Ausgabe hinzufügen:

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

Nach Status filtern:

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

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

Alle Ergebnisse paginieren:

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

Anforderungsparameter

Parameter Typ Erforderlich Description

maxResults

Ganzzahl

Nein

Maximale Anzahl von Ergebnissen pro Seite. Bereich: 1—100.

nextToken

Zeichenfolge

Nein

Paginierungstoken aus einer früheren Antwort.

statusFilter

Zeichenfolge

Nein

Nach Status filtern. Einer von:PENDING,IN_PROGRESS,COMPLETED,FAILED,DELETING.

Antwort

Feld Typ Description

recommendationSummaries

Auflisten

Liste der Zusammenfassungen der Empfehlungen.

nextToken

Zeichenfolge

Paginierungstoken für die nächste Seite. Fehlt, wenn es keine weiteren Ergebnisse gibt.

Felder für die Zusammenfassung der Empfehlungen

Feld Typ Description

recommendationId

Zeichenfolge

Eindeutiger Bezeichner.

recommendationArn

Zeichenfolge

ARN der Empfehlung.

name

Zeichenfolge

Der Name der Empfehlung.

description

Zeichenfolge

Optionale Beschreibung, falls angegeben.

type

Zeichenfolge

SYSTEM_PROMPT_RECOMMENDATION oder TOOL_DESCRIPTION_RECOMMENDATION.

status

Zeichenfolge

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

createdAt

Zeitstempel

Wann die Empfehlung erstellt wurde.

updatedAt

Zeitstempel

Wann die Empfehlung zuletzt aktualisiert wurde.

Um die vollständigen Details und Ergebnisse einer Empfehlung abzurufen, verwenden Sie Get a recommendations with therecommendationId.

Fehler

Fehler HTTP-Status Description

ValidationException

400

Ungültige Paginierungsparameter oder Statusfilterwert.

AccessDeniedException

403

Unzureichende Berechtigungen.

ThrottlingException

429

Die Anforderungsrate wurde überschritten.

InternalServerException

500

Service-side Fehler.