View a markdown version of this page

Elencazione dei consigli - Amazon Bedrock AgentCore
Esempi di codiceParametri della richiestaRispostaErrori

Elencazione dei consigli

Elenca tutti i consigli nel tuo account. I risultati sono suddivisi in pagine e possono essere filtrati in base allo stato.

Esempi di codice

Esempio
AgentCore CLI

Elenca i lavori di raccomandazione precedenti (i lavori in esecuzione vengono aggiornati dal servizio):

agentcore view recommendation

Visualizza una singola raccomandazione per ID:

agentcore view recommendation <recommendation-id>

Aggiungi --json per un output leggibile dalla macchina:

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

Filtra per stato:

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

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

Impagina tutti i risultati:

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

Parametri della richiesta

Parametro Tipo Campo obbligatorio Description

maxResults

Numero intero

No

Numero massimo di risultati per pagina. Intervallo: 1—100.

nextToken

Stringa

No

Token di impaginazione di una risposta precedente.

statusFilter

Stringa

No

Filtra per stato. Uno dei:PENDING,IN_PROGRESS,COMPLETED,FAILED,DELETING.

Risposta

Campo Tipo Description

recommendationSummaries

List

Elenco dei riepiloghi delle raccomandazioni.

nextToken

Stringa

Token di impaginazione per la pagina successiva. Assente quando non ci sono più risultati.

Campi di riepilogo dei

Campo Tipo Description

recommendationId

Stringa

Identificatore univoco.

recommendationArn

Stringa

ARN della raccomandazione.

name

Stringa

Il nome della raccomandazione.

description

Stringa

Descrizione facoltativa, se fornita.

type

Stringa

SYSTEM_PROMPT_RECOMMENDATION o TOOL_DESCRIPTION_RECOMMENDATION.

status

Stringa

Stato attuale:PENDING,IN_PROGRESS,COMPLETED,FAILED,DELETING.

createdAt

Time stamp

Quando è stata creata la raccomandazione.

updatedAt

Time stamp

Data dell'ultimo aggiornamento della raccomandazione.

Per recuperare tutti i dettagli e i risultati di una raccomandazione, usa Ottieni una raccomandazione con. recommendationId

Errori

Errore Stato HTTP Description

ValidationException

400

Parametri di impaginazione o valore del filtro di stato non validi.

AccessDeniedException

403

Autorizzazioni insufficienti.

ThrottlingException

429

Frequenza di richiesta superata.

InternalServerException

500

Service-side errore.