View a markdown version of this page

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

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Elencazione dei consigli

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

Esempi di codice

Esempio
AgentCore CLI

Elenca i lavori consigliati 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 ottenere 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']}")

Passa in rassegna 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 derivante da una risposta precedente.

statusFilter

Stringa

No

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

Risposta

Campo Tipo Description

recommendationSummaries

List

Elenco dei riassunti delle raccomandazioni.

nextToken

Stringa

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

Campi di riepilogo delle

Campo Tipo Description

recommendationId

Stringa

Identificatore univoco

recommendationArn

Stringa

ARN della raccomandazione.

name

Stringa

Il nome della raccomandazione.

description

Stringa

Descrizione opzionale, 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 del consiglio.

Per recuperare tutti i dettagli e i risultati di un consiglio, usa Ottieni un consiglio 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

Percentuale di richieste superata.

InternalServerException

500

Service-side errore.