Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Jelajahi catatan yang disetujui

Sebagai konsumen, Anda dapat menelusuri katalog catatan yang disetujui dalam registri menggunakan dua API bidang data — ListDiscoverableRegistryRecords untuk daftar halaman, dan BatchGetDiscoverableRegistryRecord untuk pengambilan massal konten rekaman penuh berdasarkan ID catatan. Kedua API hanya tersedia di bawah agent-registry namespace dan hanya mengembalikan catatan yang revisi terbarunya memiliki status Dis etujui. Catatan dalam status D raf, Penund aan persetujuan, Dit olak, atau Tidak digunakan lagi tidak dikembalikan. Untuk mencari catatan dengan kueri bahasa alami, gunakan SearchDiscoverableRegistryRecords sebagai gantinya. Lihat Mencari catatan registri.

Daftar catatan yang disetujui

Gunakan ListDiscoverableRegistryRecords untuk mengembalikan ringkasan halaman dari setiap catatan yang disetujui dalam registri. Ringkasan tidak termasuk deskriptor rekaman - gunakan BatchGetDiscoverableRegistryRecord untuk mengambil konten deskriptor lengkap setelah mengidentifikasi catatan yang Anda butuhkan.

Permintaan parameter

Setiap ringkasan dalam tanggapan berisi: registryArnrecordArn,recordId,name,displayName,description,recordType,recordVersion,status,createdAt,updatedAt.

Urutan respons dan paginasi

Hasil diurutkan berdasarkan abjad berdasarkan nama catatan.

ListDiscoverableRegistryRecordstidak menjamin halaman padat. Setiap respons individu dapat berisi lebih sedikit dari maxResults catatan, atau nol catatan, bahkan ketika ada lebih banyak catatan yang cocok. Lanjutkan memanggil API dengan pengembalian nextToken pada setiap permintaan berikutnya sampai respons berisi tidak ada nextToken (atau nextToken adanull) untuk mengambil setiap catatan yang cocok.

Konsol

AWS CLI

aws agent-registry list-discoverable-registry-records \
  --registry-id "<registryARN>" \
  --filters '[{"name": "recordType", "values": ["MCP"]}]' \
  --max-results 50 \
  --region us-east-1

Untuk menelusuri hasil, nextToken berikan nilai dari respons sebelumnya:

aws agent-registry list-discoverable-registry-records \
  --registry-id "<registryARN>" \
  --next-token "<tokenFromPreviousResponse>" \
  --region us-east-1

AWS SDK

import boto3

client = boto3.client('agent-registry')

paginator = client.get_paginator('list_discoverable_registry_records')

for page in paginator.paginate(
    registryId='<registryARN>',
    filters=[{'name': 'recordType', 'values': ['MCP']}]
):
    for record in page['registryRecords']:
        print(f"{record['displayName']} ({record['name']}) - {record['recordType']} v{record['recordVersion']}")

Klien HTTP

curl -X POST "https://agent-registry.<region>.api.aws/registries/<registryARN>/discoverable-records-list" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "filters": [{"name": "recordType", "values": ["MCP"]}],
    "maxResults": 50
  }'

Ambil batch catatan yang disetujui

Gunakan BatchGetDiscoverableRegistryRecord untuk mengambil konten deskriptor lengkap hingga 100 ID rekaman dalam satu panggilan. Kasus penggunaan umum: setelah menelusuri ListDiscoverableRegistryRecords dan mengidentifikasi catatan yang Anda inginkan, ambil deskriptor mereka dalam satu panggilan daripada membuat satu SearchDiscoverableRegistryRecords panggilan per rekaman.

Permintaan parameter

Respons

Panggilan mengembalikan HTTP 200 bahkan pada kegagalan sebagian — catatan yang tidak dapat diambil muncul dalam errors daftar daripada menyebabkan seluruh panggilan gagal. Setiap entri kesalahan bergema registryId dan recordId dari permintaan, ditambah: errorCode

Batch-level kegagalan (registri tidak ada, pemanggil tidak memiliki akses ke registri, kesalahan layanan yang tidak dapat dipulihkan) kembali melalui kesalahan operasi standar, bukan daftar per catatan. errors

AWS CLI

aws agent-registry batch-get-discoverable-registry-record \
  --entries '[{"registryId": "<registryARN>", "recordIds": ["<recordId1>", "<recordId2>", "<recordId3>"]}]' \
  --region us-east-1

AWS SDK

import boto3

client = boto3.client('agent-registry')

response = client.batch_get_discoverable_registry_record(
    entries=[
        {
            'registryId': '<registryARN>',
            'recordIds': ['<recordId1>', '<recordId2>', '<recordId3>']
        }
    ]
)

for record in response['registryRecords']:
    print(f"Retrieved: {record['displayName']} ({record['recordId']})")

for error in response['errors']:
    print(f"Failed: {error['recordId']} ({error['errorCode']}): {error.get('message', '')}")

Klien HTTP

curl -X POST "https://agent-registry.<region>.api.aws/discoverable-records-batch" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <accessToken>" \
  -d '{
    "entries": [
      {
        "registryId": "<registryARN>",
        "recordIds": ["<recordId1>", "<recordId2>", "<recordId3>"]
      }
    ]
  }'