View a markdown version of this page

Sinkronisasi catatan dari sumber eksternal - Batu Dasar Amazon AgentCore
Gambaran umumSinkronisasi dari server MCP publikSinkronisasi dari OAuth-protected server MCPSinkronisasi dari IAM-protected server MCPSinkronisasi dari kartu agen A2AMemicu sinkronisasi pada catatan yang ada

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

Sinkronisasi catatan dari sumber eksternal

Migrasi Sekarang Dibuka

AWS Agen Registry telah diluncurkan di bawah agent-registry namespace baru. Dukungan untuk bedrock-agentcore namespace pratinjau publik akan dihentikan pada 17 September 2026. Untuk petunjuk migrasi, lihat Panduan migrasi registri komprehensif.

Gambaran umum

AWS Agen Registry dapat secara otomatis menyinkronkan metadata rekaman dari sumber eksternal dengan menghubungkan ke URL yang disediakan dengan kredenSIAL keluar. Saat Anda memberikan URL dan penyedia kredensia (Opsional untuk sumber daya publik yang tidak memerlukan Otorisasi apa pun untuk mengakses), sistem akan mengekstrak definisi server dan alat dan mengisi deskriptor catatan sesuai dengan skema protokol resmi. Ini juga memperbarui nama, deskripsi, dan versi catatan jika nilai-nilai tersebut ditemukan di sumbernya.

Sinkronisasi dari server MCP publik

Untuk server MCP Publik yang tidak memerlukan otentikasi atau otorisasi:

Konsol

contoh
AWS Agent Registry namespace

  1. Buka halaman detail registri di konsol AWS Agen Registry.

  2. Di bagian Catatan registri, pilih Buat catatan.

  3. Pilih Sin kronisasi dari titik akhir.

  4. Di bawah Detail Rekam, untuk Jenis, pilih MCP. Deskriptor diatur ke server MCP.

  5. Untuk Endpoint, masukkan URL server MCP publik (mis.,https://knowledge-mcp.global.api.aws). Harus URL HTTPS yang valid.

  6. Di bawah Jenis kredensi, pilih Tidak ada.

  7. (Opsional) Di bagian Tag, pilih Tambahkan tag baru untuk melampirkan satu atau lebih tag ke catatan. Setiap tag memiliki kunci dan nilai opsional.

  8. Pilih Buat catatan.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka halaman detail registri di Bedrock-AgentCore konsol.

  2. Di bagian Catatan registri, pilih Buat rekaman.

  3. Pilih Sin kronisasi dari titik akhir.

  4. Di bawah Detail rek aman, pilih MCP sebagai jenis rekaman.

  5. Untuk Endpoint, masukkan URL server MCP publik (mis.,https://knowledge-mcp.global.api.aws). Harus URL HTTPS yang valid.

  6. Di bawah Jenis kredensi, pilih Tidak ada.

  7. Pilih Buat catatan.

Catatan dibuat dalam status CREATING. Registry terhubung ke titik akhir, mengekstrak definisi server dan alat, dan mengisi deskriptor catatan. Setelah sinkronisasi selesai, rekaman bertransisi ke DRAFT. Jika sinkronisasi gagal, rekaman bertransisi ke status CREATE_FAILED dengan detail kesalahan yang tersedia di bidang Status Reason. Untuk pemecahan masalah, lihat Mer ekam kesalahan sinkronisasi.

AWS CLI

contoh
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "aws-knowledge-server" \
  --display-name "AWS Knowledge Server" \
  --record-type MCP \
  --descriptors '{
    "mcpServer": {
      "source": {
        "fromUrl": {
          "url": "https://knowledge-mcp.global.api.aws"
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "aws-knowledge-server" \
  --descriptor-type MCP \
  --synchronization-type URL \
  --synchronization-configuration '{
    "fromUrl":
    {
        "url": "https://knowledge-mcp.global.api.aws"
    }
  }' \
  --region us-east-1

AWS SDK

contoh
AWS Agent Registry namespace
import boto3

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

response = client.create_registry_record(
    registryId='<registryId>',
    name='aws-knowledge-server',
    displayName='AWS Knowledge Server',
    recordType='MCP',
    descriptors={
        'mcpServer': {
            'source': {
                'fromUrl': {
                    'url': 'https://knowledge-mcp.global.api.aws'
                }
            }
        }
    }
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.create_registry_record(
    registryId='<registryId>',
    name='aws-knowledge-server',
    descriptorType='MCP',
    synchronizationType='URL',
    synchronizationConfiguration={
        'fromUrl': {
            'url': 'https://knowledge-mcp.global.api.aws'
        }
    }
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING
catatan

Di agent-registry namespace, konfigurasi sinkronisasi bergerak di dalam setiap deskriptor sebagai source (hanya didukung pada mcpServer dan deskriptor a2aAgentCard utama). BidangsynchronizationType/synchronizationConfigurationtingkat atas tidak ada lagi.

Catatan dibuat dalam status CREATING. Waktu sinkronisasi bervariasi dari detik ke menit, tergantung pada ukuran metadata. Setelah sinkronisasi selesai, ia beralih ke DRAFT dengan deskriptor yang diekstrak dari server MCP, termasuk definisi server dan alat.

Sinkronisasi dari OAuth-protected server MCP

Ketika server MCP dilindungi oleh OAuth, Anda harus membuat klien M2M di server otorisasi, dan kemudian mengkonfigurasi penyedia kredensia dari AgentCore Identitas yang berisi ID klien dan rahasia yang diizinkan untuk memanggil server MCP. Setelah Anda memiliki penyedia kredensi, Anda dapat menyediakannya ke registri untuk sinkronisasi:

Konsol

contoh
AWS Agent Registry namespace

  1. Buka halaman detail registri di konsol AWS Agen Registry.

  2. Di bagian Catatan registri, pilih Buat catatan.

  3. Pilih Sin kronisasi dari titik akhir.

  4. Di bawah Detail Rekam, untuk Jenis, pilih MCP. Deskriptor diatur ke server MCP.

  5. Untuk Endpoint, masukkan URL server OAuth-protected MCP. Harus URL HTTPS yang valid.

  6. Di bawah Jenis kredensi, pilih O Auth.

  7. Untuk penyedia kredensi, pilih atau masukkan penyedia kredensi ARN dari AgentCore Identitas.

  8. (Opsional) Perluas Konfigurasi tambahan untuk mengkonfigurasi:

    1. Cak upan — Cakupan OAuth untuk diminta saat memperoleh token akses.

    2. Parameter kustom — Parameter nilai kunci tambahan untuk permintaan token OAuth.

  9. (Opsional) Di bagian Tag, pilih Tambahkan tag baru untuk melampirkan satu atau lebih tag ke catatan. Setiap tag memiliki kunci dan nilai opsional.

  10. Pilih Buat catatan.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka halaman detail registri di Bedrock-AgentCore konsol.

  2. Di bagian Catatan registri, pilih Buat rekaman.

  3. Pilih Sin kronisasi dari titik akhir.

  4. Di bawah Detail rek aman, pilih MCP sebagai jenis rekaman.

  5. Untuk Endpoint, masukkan URL server OAuth-protected MCP. Harus URL HTTPS yang valid.

  6. Di bawah Jenis kredensi, pilih O Auth.

  7. Untuk penyedia kredensi, pilih atau masukkan penyedia kredensi ARN dari AgentCore Identitas.

  8. (Opsional) Perluas Konfigurasi tambahan untuk mengkonfigurasi:

    1. Cak upan — Cakupan OAuth untuk diminta saat memperoleh token akses.

    2. Parameter kustom — Parameter nilai kunci tambahan untuk permintaan token OAuth.

  9. Pilih Buat catatan.

Catatan dibuat dalam status CREATING. Registri terhubung ke titik akhir menggunakan kredenSIAL OAuth, mengekstrak definisi server dan alat, dan mengisi deskriptor catatan. Setelah sinkronisasi selesai, rekaman bertransisi ke DRAFT. Jika sinkronisasi gagal, rekaman bertransisi ke status CREATE_FAILED dengan detail kesalahan yang tersedia di bidang Status Reason. Untuk pemecahan masalah, lihat Mer ekam kesalahan sinkronisasi.

AWS CLI

contoh
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "oauth-mcp-server" \
  --display-name "OAuth MCP Server" \
  --record-type MCP \
  --descriptors '{
    "mcpServer": {
      "source": {
        "fromUrl": {
          "url": "$MCP_OAUTH_URL",
          "credentialProviderConfigurations": [
            {
              "credentialProviderType": "OAUTH",
              "credentialProvider": {
                "oauthCredentialProvider": {
                  "providerArn": "$OAUTH_PROVIDER_ARN",
                  "grantType": "CLIENT_CREDENTIALS"
                }
              }
            }
          ]
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "oauth-mcp-server" \
  --descriptor-type MCP \
  --synchronization-type URL \
  --synchronization-configuration '{
    "fromUrl":
    {
        "url": "$MCP_OAUTH_URL",
        "credentialProviderConfigurations":
        [
            {
                "credentialProviderType": "OAUTH",
                "credentialProvider":
                {
                    "oauthCredentialProvider":
                    {
                        "providerArn": "$OAUTH_PROVIDER_ARN",
                        "grantType": "CLIENT_CREDENTIALS"
                    }
                }
            }
        ]
    }
  }' \
  --region us-east-1

Izin IAM tambahan diperlukan:

catatan

Izin IAM terkait sinkronisasi ini mengotorisasi identitas beban kerja dan sumber daya penyedia kredensia OAuth yang dikelola oleh Identity. AgentCore Sumber daya tersebut sengaja tetap berada di bawah bedrock-agentcore namespace, jadi kebijakan ini tidak berubah.

{
    "Statement":
    [
        {
            "Effect": "Allow",
            "Action":
            [
                "bedrock-agentcore:GetWorkloadAccessToken"
            ],
            "Resource":
            [
                "arn:aws:bedrock-agentcore:*:<account>:workload-identity-directory/*"
            ]
        },
        {
            "Effect": "Allow",
            "Action":
            [
                "bedrock-agentcore:GetResourceOauth2Token"
            ],
            "Resource":
            [
                "arn:aws:bedrock-agentcore:<region>:<account>:token-vault/default/oauth2credentialprovider/<oauthProviderName>"
            ]
        }
    ]
}
catatan

Lingkup GetResourceOauth2Token pernyataan ke penyedia kredensia OAuth spesifik ARN yang token aksesnya dibutuhkan peran ini. Hindari wildcard di segmen penyedia ARN — pola seperti token-vault/ atau token-vault/default/oauth2credentialprovider/ berikan akses ke setiap penyedia kredensia OAuth di akun, yang dapat mengaktifkan akses kredensi lintas tim. Ikuti prinsip hak istimewa paling sedikit dengan menamai penyedia tertentu di Resource lapangan, misalnyaarn:aws:bedrock-agentcore:<region>:<account>:token-vault/default/oauth2credentialprovider/<oauthProviderName>.

Pembatasan:

  • Penelep UpdateRegistryRecord on CreateRegistryRecord atau harus memiliki identitas beban kerja GetWorkloadAccessToken terkait registri dan GetResourceOauth2Token izin pada penyedia kredensia.

  • Penyedia kredensi harus berasal dari akun yang sama.

Sinkronisasi dari IAM-protected server MCP

Untuk server MCP di Amazon Bedrock AgentCore Runtime atau Amazon Bedrock AgentCore Gateway, tentukan peran IAM untuk penandatanganan SIGv4. Peran harus memiliki izin untuk mengakses layanan target. Misalnya: bedrock-agentcore:InvokeAgentRuntime atau bedrock-agentcore:InvokeAgentRuntimeForUser pada AgentCore Runtime; bedrock-agentcore:InvokeGateway di AgentCore Gateway.

Selain peran IAM, Anda harus menentukan service bidang untuk penandatanganan SIGv4. Jika MCP Anda berjalan pada AgentCore Runtime atau AgentCore Gateway, nilainya seharusnyaagent-registry. Jika MCP Anda berjalan di Amazon API Gateway, seharusnya demikianexecute-api, dan jika MCP Anda berjalan di AWS Lambda, seharusnya demikian. lambda

regionnilainya opsional. Secara default, permintaan akan ditandatangani dengan wilayah yang sama dengan registri.

Konsol

contoh
AWS Agent Registry namespace

  1. Buka halaman detail registri di konsol AWS Agen Registry.

  2. Di bagian Catatan registri, pilih Buat catatan.

  3. Pilih Sin kronisasi dari titik akhir.

  4. Di bawah Detail Rekam, untuk Jenis, pilih MCP. Deskriptor diatur ke server MCP.

  5. Untuk Endpoint, masukkan URL server IAM-protected MCP. Harus URL HTTPS yang valid.

  6. Di bawah Jenis kredensi, pilih I AM.

  7. Untuk Role ARN, masukkan peran IAM ARN yang akan diasumsikan untuk penandatanganan SIGv4.

  8. Untuk Layanan, masukkan nama layanan untuk penandatanganan SIGv4 (misalnya,, agent-registryexecute-api,lambda).

  9. (Opsional) Perluas Konfigur asi tambahan dan pilih Wil ayah untuk penandatanganan SIGv4. Jika tidak ditentukan, wilayah registri sendiri digunakan.

  10. (Opsional) Di bagian Tag, pilih Tambahkan tag baru untuk melampirkan satu atau lebih tag ke rekaman. Setiap tag memiliki kunci dan nilai opsional.

  11. Pilih Buat catatan.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka halaman detail registri di Bedrock-AgentCore konsol.

  2. Di bagian Catatan registri, pilih Buat rekaman.

  3. Pilih Sin kronisasi dari titik akhir.

  4. Di bawah Detail rek aman, pilih MCP sebagai jenis rekaman.

  5. Untuk Endpoint, masukkan URL server IAM-protected MCP. Harus URL HTTPS yang valid.

  6. Di bawah Jenis kredensi, pilih I AM.

  7. Untuk Role ARN, masukkan peran IAM ARN yang akan diasumsikan untuk penandatanganan SIGv4.

  8. Untuk Layanan, masukkan nama layanan untuk penandatanganan SIGv4 (misalnya,, bedrock-agentcoreexecute-api,lambda).

  9. (Opsional) Perluas Konfigur asi tambahan dan pilih Wil ayah untuk penandatanganan SIGv4. Jika tidak ditentukan, wilayah registri sendiri digunakan.

  10. Pilih Buat catatan.

Catatan dibuat dalam status CREATING. Registri terhubung ke titik akhir menggunakan kredenSIAL IAM, mengekstrak definisi server dan alat, dan mengisi deskriptor catatan. Setelah sinkronisasi selesai, rekaman bertransisi ke DRAFT. Jika sinkronisasi gagal, rekaman bertransisi ke status CREATE_FAILED dengan detail kesalahan yang tersedia di bidang Status Reason. Untuk pemecahan masalah, lihat Mer ekam kesalahan sinkronisasi.

AWS CLI

contoh
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "gateway-mcp-server" \
  --display-name "Gateway MCP Server" \
  --record-type MCP \
  --descriptors '{
    "mcpServer": {
      "source": {
        "fromUrl": {
          "url": "$MCP_IAM_URL",
          "credentialProviderConfigurations": [
            {
              "credentialProviderType": "IAM",
              "credentialProvider": {
                "iamCredentialProvider": {
                  "roleArn": "$IAM_ROLE_ARN",
                  "service": "$SIGNING_SERVICE",
                  "region": "$SIGNING_REGION"
                }
              }
            }
          ]
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "gateway-mcp-server" \
  --descriptor-type MCP \
  --synchronization-type URL \
  --synchronization-configuration '{
    "fromUrl":
    {
        "url": "$MCP_IAM_URL",
        "credentialProviderConfigurations":
        [
            {
                "credentialProviderType": "IAM",
                "credentialProvider":
                {
                    "iamCredentialProvider":
                    {
                        "roleArn": "$IAM_ROLE_ARN",
                        "service": "$SIGNING_SERVICE",
                        "region": "$SIGNING_REGION"
                    }
                }
            }
        ]
    }
  }' \
  --region us-east-1

Izin IAM tambahan diperlukan:

catatan

iam:PassRoleKebijakan ini mengizinkan registri untuk menyerahkan peran ke AgentCore Identity untuk sinkronisasi keluar. Nilai iam:PassedToService kondisi bedrock-agentcore.amazonaws.com mengacu pada prinsip layanan AgentCore Identitas dan tidak berubah.

{
    "Statement":
    [
        {
            "Effect": "Allow",
            "Action":
            [
                "iam:PassRole"
            ],
            "Resource":
            [
                "arn:aws:iam::<account>:role/<sync-role>"
            ],
            "Condition":
            {
                "StringEquals":
                {
                    "iam:PassedToService": "bedrock-agentcore.amazonaws.com"
                }
            }
        }
    ]
}

Sinkronisasi dari kartu agen A2A

Berikan URL kartu agen atau URL dasar agen di mana .well-known/agent-card.json dapat ditemukan:

Konsol

contoh
AWS Agent Registry namespace

  1. Buka halaman detail registri di konsol AWS Agen Registry.

  2. Di bagian Catatan registri, pilih Buat catatan.

  3. Pilih Sin kronisasi dari titik akhir.

  4. Di bawah Detail Rekam, untuk Jenis, pilih Agen. Deskriptor diatur ke Kartu Agen A2A.

  5. Untuk Endpoint, masukkan URL kartu agen (mis.,https://agent.example.com/.well-known/agent-card.json). Harus URL HTTPS yang valid.

  6. Di bawah Jenis kredensi, pilih metode otorisasi yang sesuai:

    1. Tidak ada — Untuk kartu agen yang dapat diakses publik.

    2. IAM — Untuk agen yang dihosting di AgentCore Runtime atau Gateway. Berikan nama Role ARN dan Service.

    3. OAuth - Untuk OAuth-protected agen. Pilih atau masukkan penyedia kredensi ARN.

  7. (Opsional) Di bagian Tag, pilih Tambahkan tag baru untuk melampirkan satu atau lebih tag ke rekaman. Setiap tag memiliki kunci dan nilai opsional.

  8. Pilih Buat catatan.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Buka halaman detail registri di Bedrock-AgentCore konsol.

  2. Di bagian Catatan registri, pilih Buat rekaman.

  3. Pilih Sin kronisasi dari titik akhir.

  4. Di bawah Detail rek aman, pilih Agen sebagai jenis rekaman.

  5. Untuk Endpoint, masukkan URL kartu agen (mis.,https://agent.example.com/.well-known/agent-card.json). Harus URL HTTPS yang valid.

  6. Di bawah Jenis kredensi, pilih metode otorisasi yang sesuai:

    1. Tidak ada — Untuk kartu agen yang dapat diakses publik.

    2. IAM — Untuk agen yang dihosting di AgentCore Runtime atau Gateway. Berikan nama Role ARN dan Service.

    3. OAuth - Untuk OAuth-protected agen. Pilih atau masukkan penyedia kredensi ARN.

  7. Pilih Buat catatan.

Catatan dibuat dalam status CREATING. Registry terhubung ke titik akhir, mengekstrak metadata kartu agen, dan mengisi deskriptor catatan. Setelah sinkronisasi selesai, rekaman bertransisi ke DRAFT. Jika sinkronisasi gagal, rekaman bertransisi ke status CREATE_FAILED dengan detail kesalahan yang tersedia di bidang Status Reason. Untuk pemecahan masalah, lihat Mer ekam kesalahan sinkronisasi.

AWS CLI

contoh
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "travel-agent" \
  --display-name "Travel Agent" \
  --record-type AGENT \
  --descriptors '{
    "a2aAgentCard": {
      "source": {
        "fromUrl": {
          "url": "https://agent.example.com/.well-known/agent-card.json"
        }
      }
    }
  }' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "travel-agent" \
  --descriptor-type A2A \
  --synchronization-type URL \
  --synchronization-configuration '{"fromUrl": {"url": "https://agent.example.com/.well-known/agent-card.json"}}' \
  --region us-east-1

Anda juga dapat menentukan penyedia kredensia untuk sinkronisasi A2A, misalnya Anda dapat menyinkronkan dari agen yang dihosting di. AgentCore Gunakan agent-registry sebagai service bidang saat target sinkronisasi adalah agen yang dihosting di AgentCore Runtime atau Gateway.

contoh
AWS Agent Registry namespace
aws agent-registry-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "a2a_agent_record" \
  --display-name "A2A Agent Record" \
  --record-type AGENT \
  --descriptors "{
    \"a2aAgentCard\": {
      \"source\": {
        \"fromUrl\": {
          \"url\": \"$A2A_URL\",
          \"credentialProviderConfigurations\": [{
            \"credentialProviderType\": \"IAM\",
            \"credentialProvider\": {
              \"iamCredentialProvider\": {
                \"roleArn\": \"$IAM_INVOKER_ROLE\",
                \"service\": \"agent-registry\"
              }
            }
          }]
        }
      }
    }
  }"
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry-record \
  --registry-id $REGISTRY_ID \
  --name "a2a_agent_record" \
  --descriptor-type A2A \
  --synchronization-type URL \
  --synchronization-configuration "{
    \"fromUrl\": {
        \"url\": \"$A2A_URL\",
        \"credentialProviderConfigurations\": [{
            \"credentialProviderType\": \"IAM\",
            \"credentialProvider\": {
                \"iamCredentialProvider\": {
                    \"roleArn\": \"$IAM_INVOKER_ROLE\",
                    \"service\": \"bedrock-agentcore\"
                }
            }
        }]
    }
  }"

Memicu sinkronisasi pada catatan yang ada

Konsol

  1. Buka halaman detail rekaman untuk rekaman MCP atau Agen yang telah dikonfigurasi sinkronisasi.

contoh
AWS Agent Registry namespace

  1. Dari halaman detail rekaman di konsol AWS Agen Registry, pilih Kel ola, lalu pilih Sin kronisasi.

  2. Dalam dialog konfirmasi, tinjau pesan bahwa sinkronisasi akan mengembalikan catatan ke status draf.

  3. Pilih Sin kronisasi untuk mengonfirmasi.

Atau, Anda dapat memicu sinkronisasi selama pengeditan:

  1. Dari halaman detail rekaman, pilih Kel ola, lalu pilih Edit.

  2. Di bawah Sinkronisasi dari titik akhir, pilih kotak centang Re-sync dari titik akhir.

  3. Pilih Simpan perubahan.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Dari halaman detail rekaman di Bedrock-AgentCore konsol, pilih tombol Sinkronisasi di tindakan header.

  2. Dalam dialog konfirmasi, tinjau pesan bahwa sinkronisasi akan mengembalikan catatan ke status draf.

  3. Pilih Sin kronisasi untuk mengonfirmasi.

Atau, Anda dapat memicu sinkronisasi selama pengeditan:

  1. Dari halaman detail rekaman, pilih menu tiga titik (), lalu pilih Edit.

  2. Di bawah Sinkronisasi dari titik akhir, pilih kotak centang Re-sync dari titik akhir.

  3. Pilih Simpan perubahan.

Transisi rekaman ke status UPDATE selama sinkronisasi. Setelah selesai, ia kembali ke DRAFT dengan deskriptor yang diperbarui dari sumbernya. Jika sinkronisasi gagal, rekaman bertransisi ke status UPDATE_FAILED dengan detail kesalahan yang tersedia di bidang Status Reason. Untuk pemecahan masalah, lihat Mer ekam kesalahan sinkronisasi.

AWS CLI

contoh
AWS Agent Registry namespace
aws agent-registry-control update-registry-record \
  --registry-id $REGISTRY_ID \
  --record-id $RECORD_ID \
  --trigger-synchronization \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry-record \
  --registry-id $REGISTRY_ID \
  --record-id $RECORD_ID \
  --trigger-synchronization \
  --region us-east-1

AWS SDK

contoh
AWS Agent Registry namespace
import boto3

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

response = client.update_registry_record(
    registryId='<registryId>',
    recordId='<recordId>',
    triggerSynchronization=True
)
print(f"Status: {response['status']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

client = boto3.client('bedrock-agentcore-control')

response = client.update_registry_record(
    registryId='<registryId>',
    recordId='<recordId>',
    triggerSynchronization=True
)
print(f"Status: {response['status']}")
catatan

Jika catatan dalam status Non-draf (misalnya, DISETUJUI), pembaruan membuat revisi DRAFT baru. Revisi yang disetujui tetap dapat ditemukan.

Pemecahan masalah: lihat Mer ekam kesalahan sinkronisasi.