View a markdown version of this page

Daftar rekomendasi - Batuan Dasar Amazon AgentCore
Sampel KodePermintaan parameterResponsKesalahan

Daftar rekomendasi

Buat daftar semua rekomendasi di akun Anda. Hasil diberi paginasi dan dapat disaring berdasarkan status.

Sampel Kode

contoh
AgentCore CLI

Buat daftar pekerjaan rekomendasi sebelumnya (pekerjaan yang sedang berjalan disegarkan dari layanan):

agentcore view recommendation

Lihat satu rekomendasi berdasarkan ID:

agentcore view recommendation <recommendation-id>

Tambahkan --json untuk output yang dapat dibaca mesin:

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

Filter berdasarkan status:

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

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

Paginasi melalui semua hasil:

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

Permintaan parameter

Parameter Tipe Diperlukan Deskripsi

maxResults

Bulat

Tidak

Jumlah maksimum hasil per halaman. Rentang: 1—100.

nextToken

String

Tidak

Token pagination dari respons sebelumnya.

statusFilter

String

Tidak

Filter berdasarkan status. Salah satu dari:PENDING,IN_PROGRESS,COMPLETED,FAILED,DELETING.

Respons

Bidang Tipe Deskripsi

recommendationSummaries

Daftar

Daftar ringkasan rekomendasi.

nextToken

String

Token pagination untuk halaman berikutnya. Absen ketika tidak ada hasil lagi.

Bidang ringkasan rekomendasi

Bidang Tipe Deskripsi

recommendationId

String

Pengidentifikasi unik.

recommendationArn

String

ARN dari rekomendasi.

name

String

Nama rekomendasi.

description

String

Deskripsi opsional, jika disediakan.

type

String

SYSTEM_PROMPT_RECOMMENDATION atau TOOL_DESCRIPTION_RECOMMENDATION.

status

String

Status saat ini:PENDING,IN_PROGRESS,COMPLETED,FAILED,DELETING.

createdAt

Stempel waktu

Ketika rekomendasi dibuat.

updatedAt

Stempel waktu

Ketika rekomendasi terakhir diperbarui.

Untuk mengambil detail lengkap dan hasil rekomendasi, gunakan Dapatkan rekomendasi dengan. recommendationId

Kesalahan

Kesalahan Status HTTP Deskripsi

ValidationException

400

Parameter pagination atau nilai filter status tidak valid.

AccessDeniedException

403

Izin tidak mencukupi.

ThrottlingException

429

Tingkat permintaan terlampaui.

InternalServerException

500

Service-side kesalahan.