View a markdown version of this page

Crie e gerencie registros - Base da Amazônia AgentCore
Crie um registroListar registrosExibir detalhes do registroAtualizar um registroExcluir um registro

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Crie e gerencie registros

A migração já está aberta

AWS O Agent Registry foi lançado com o novo agent-registry namespace. O suporte para o bedrock-agentcore namespace de visualização pública será descontinuado em 17 de setembro de 2026. Para obter instruções de migração, consulte Guia abrangente de migração de registro.

Crie um registro

Console

exemplo
AWS Agent Registry namespace

  1. Abra o console do AWS Agent Registry.

  2. No painel de navegação, em Descobrir, escolha Registro.

  3. Na seção Registros, escolha Criar registro.

  4. Em Nome, insira um nome para seu registro. O nome deve começar com uma letra ou um dígito. Os caracteres válidos são a-z, 0-9 A-Z, _ (sublinhado), - (hífen),. (ponto) e/(barra frontal). O nome pode ter até 64 caracteres.

  5. (Opcional) Expanda Detalhes adicionais e insira uma Descrição (de 1 a 4.096 caracteres).

  6. (Opcional) Expanda a Autorização de Descoberta para configurar como os consumidores autorizam ao descobrir registros no registro — pesquisando, navegando no catálogo de registros aprovados, obtendo registros aprovados em lote e invocando o endpoint MCP (Autorização de Entrada) do registro. Escolha AWS IAM para usar AWS credenciais padrão ou JSON Web tokens (JWT) para usar suas credenciais de provedor de identidade corporativa. Se você escolher o JWT, poderá criar rapidamente com o Cognito ou trazer seu próprio IdP fornecendo o URL de descoberta, o público, o escopo, as reivindicações personalizadas e os clientes.

  7. Em Aprovação de registro, escolha se deseja ativar Auto-approval. Quando a aprovação automática está desativada, o curador deve revisar e aprovar cada registro antes que ele se torne pesquisável.

  8. (Opcional) Expanda Tags para adicionar tags ao registro. As tags são pares de valores-chave que ajudam você a categorizar, pesquisar e gerenciar seus registros. Cada tag consiste em uma chave obrigatória e um valor opcional.

  9. (Opcional) Expanda a chave KMS para configurar a criptografia em repouso com uma chave gerenciada pelo cliente. Por padrão, seu registro é criptografado com uma AWS chave própria. Para usar sua própria chave, selecione Personalizar configurações de criptografia (avançadas) e insira o ARN da sua chave KMS, ou escolha Criar uma chave AWS KMS para criar uma nova chave. A chave KMS não pode ser alterada após a criação do registro. Para obter mais informações, consulte Proteção de dados no AWS Agent Registry.

  10. Escolha Criar registro.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Abra o AgentCore console https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1# Amazon Bedrock.

  2. No painel de navegação, em Descobrir, escolha Registro.

  3. Na seção Registros, escolha Criar registro.

  4. Em Nome, insira um nome para seu registro. O nome deve começar com uma letra ou um dígito. Os caracteres válidos são a-z, 0-9 A-Z, _ (sublinhado), - (hífen),. (ponto) e/(barra frontal). O nome pode ter até 64 caracteres.

  5. (Opcional) Expanda Detalhes adicionais e insira uma Descrição (de 1 a 4.096 caracteres).

  6. (Opcional) Expanda a Autorização da API de Pesquisa para configurar como os consumidores autorizam ao pesquisar no registro (Autorização de entrada). Escolha AWS IAM para usar AWS credenciais padrão ou JSON Web tokens (JWT) para usar suas credenciais de provedor de identidade corporativa. Se você escolher o JWT, poderá criar rapidamente com o Cognito ou trazer seu próprio IdP fornecendo o URL de descoberta, o público, o escopo, as reivindicações personalizadas e os clientes.

  7. Em Aprovação de registro, escolha se deseja ativar Auto-approval. Quando a aprovação automática está desativada, o curador deve revisar e aprovar cada registro antes que ele se torne pesquisável.

  8. (Opcional) Expanda a chave KMS para configurar a criptografia em repouso com uma chave gerenciada pelo cliente. Por padrão, seu registro é criptografado com uma AWS chave própria. Para usar sua própria chave, selecione Personalizar configurações de criptografia (avançadas) e insira o ARN da sua chave KMS, ou escolha Criar uma chave AWS KMS para criar uma nova chave. A chave KMS não pode ser alterada após a criação do registro. Para obter mais informações, consulte Proteção de dados no AWS Agent Registry.

  9. Escolha Criar registro.

O status do registro começa como Criando e passa para Pronto quando o provisionamento é concluído.

nota

Para registros habilitados para JWT, é necessário pelo menos um campo de configuração de autorização do JWT: públicos permitidos, clientes permitidos, escopos permitidos ou declarações personalizadas. Se você configurar mais de um, o AWS Agent Registry verificará todos eles.

AWS CLI

IAM-based registro:

exemplo
AWS Agent Registry namespace
aws agent-registry-control create-registry \
  --name "MyRegistry" \
  --description "Production registry" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry \
  --name "MyRegistry" \
  --description "Production registry" \
  --region us-east-1

JWT-based registro:

exemplo
AWS Agent Registry namespace
aws agent-registry-control create-registry \
  --name "MyOAuthRegistry" \
  --discovery-configuration '{"authorizerType": "CUSTOM_JWT", "authorizerConfiguration": {"customJWTAuthorizer": {"discoveryUrl": "https://cognito-idp.us-east-1.amazonaws.com/<poolId>/.well-known/openid-configuration", "allowedClients": ["<appClientId>"]}}}' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry \
  --name "MyOAuthRegistry" \
  --authorizer-type CUSTOM_JWT \
  --authorizer-configuration '{"customJWTAuthorizer": {"discoveryUrl": "https://cognito-idp.us-east-1.amazonaws.com/<poolId>/.well-known/openid-configuration", "allowedClients": ["<appClientId>"]}}' \
  --region us-east-1

Registro com uma chave gerenciada pelo cliente

exemplo
AWS Agent Registry namespace
aws agent-registry-control create-registry \
  --name "MyEncryptedRegistry" \
  --description "Registry with customer managed encryption" \
  --encryption-configuration '{"kmsKeyArn":"arn:aws:kms:us-east-1:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"}' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control create-registry \
  --name "MyEncryptedRegistry" \
  --description "Registry with customer managed encryption" \
  --encryption-configuration '{"kmsKeyArn":"arn:aws:kms:us-east-1:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"}' \
  --region us-east-1
nota

Você só pode definir o --encryption-configuration parâmetro durante a criação do registro. Você não pode alterar a chave KMS após a criação do registro. Se você omitir esse parâmetro, o registro usará uma chave AWS própria por padrão.

AWS SDK

IAM-based registro:

exemplo
AWS Agent Registry namespace
import boto3

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

response = client.create_registry(
    name='MyRegistry',
    description='Production registry'
)
print(response['registryArn'])
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.create_registry(
    name='MyRegistry',
    description='Production registry'
)
print(response['registryArn'])

JWT-based registro:

exemplo
AWS Agent Registry namespace
import boto3

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

response = client.create_registry(
    name='MyOAuthRegistry',
    discoveryConfiguration={
        'authorizerType': 'CUSTOM_JWT',
        'authorizerConfiguration': {
            'customJWTAuthorizer': {
                'discoveryUrl': 'https://cognito-idp.us-east-1.amazonaws.com/<poolId>/.well-known/openid-configuration',
                'allowedClients': ['<appClientId>']
            }
        }
    }
)
print(response['registryArn'])
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.create_registry(
    name='MyOAuthRegistry',
    authorizerType='CUSTOM_JWT',
    authorizerConfiguration={
        'customJWTAuthorizer': {
            'discoveryUrl': 'https://cognito-idp.us-east-1.amazonaws.com/<poolId>/.well-known/openid-configuration',
            'allowedClients': ['<appClientId>']
        }
    }
)
print(response['registryArn'])

Registro com uma chave gerenciada pelo cliente

exemplo
AWS Agent Registry namespace
import boto3

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

response = client.create_registry(
    name='MyEncryptedRegistry',
    description='Registry with customer managed encryption',
    encryptionConfiguration={
        'kmsKeyArn': 'arn:aws:kms:us-east-1:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222'
    }
)
print(response['registryArn'])
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.create_registry(
    name='MyEncryptedRegistry',
    description='Registry with customer managed encryption',
    encryptionConfiguration={
        'kmsKeyArn': 'arn:aws:kms:us-east-1:111122223333:key/a1b2c3d4-5678-90ab-cdef-EXAMPLE22222'
    }
)
print(response['registryArn'])

Listar registros

Console

exemplo
AWS Agent Registry namespace

  1. Abra o console do AWS Agent Registry.

  2. No painel de navegação, em Descobrir, escolha Registro.

  3. A tabela Registros exibe todos os registros em sua conta com as seguintes colunas:

    1. Nome — O nome do registro (vinculado à página de detalhes).

    2. Descrição — A descrição do registro, se fornecida.

    3. Tipo de autenticação — O método de autorização de entrada (AWS_IAM ou CUSTOM_JWT).

    4. Status — O status atual (Criando, Pronto, Atualizando, Excluindo ou um estado de falha).

    5. ARN — O nome de recurso da Amazon de registro.

    6. Criado — O carimbo de data/hora da criação.

    7. Última atualização — O carimbo de data/hora da última modificação.

  4. Use a barra de pesquisa Localizar registros para filtrar por nome.

  5. Use os controles de paginação para navegar pelos resultados.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Abra o AgentCore console https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1# Amazon Bedrock.

  2. No painel de navegação, em Descobrir, escolha Registro.

  3. A tabela Registros exibe todos os registros em sua conta com as seguintes colunas:

    1. Nome — O nome do registro (vinculado à página de detalhes).

    2. Descrição — A descrição do registro, se fornecida.

    3. Tipo de autorização — O método de autorização de entrada (AWS_IAM ou CUSTOM_JWT).

    4. Status — O status atual (Criando, Pronto, Atualizando, Excluindo ou um estado de falha).

    5. ARN — O nome de recurso da Amazon de registro.

    6. Criado — O carimbo de data/hora da criação.

    7. Última atualização — O carimbo de data/hora da última modificação.

  4. Use a barra de pesquisa Localizar registros para filtrar por nome.

  5. Use os controles de paginação para navegar pelos resultados.

AWS CLI

exemplo
AWS Agent Registry namespace
aws agent-registry-control list-registries \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control list-registries \
  --region us-east-1

AWS SDK

exemplo
AWS Agent Registry namespace
import boto3

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

response = client.list_registries()
for registry in response['registries']:
    print(f"{registry['name']} - {registry['status']} - {registry['registryArn']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.list_registries()
for registry in response['registries']:
    print(f"{registry['name']} - {registry['status']} - {registry['registryArn']}")

Exibir detalhes do registro

Console

exemplo
AWS Agent Registry namespace

  1. Abra o console do AWS Agent Registry.

  2. No painel de navegação, em Descobrir, escolha Registro.

  3. Escolha o nome do registro na tabela Registros.

  4. A página de detalhes do registro exibe as seguintes seções dobráveis:

    1. Detalhes do registro — Exibe nome, status, descrição Auto-approval (ativado ou desativado), ARN do registro, data da última atualização e data de criação.

    2. Registros do registro — Mostra contadores resumidos de status (total enviado, aprovação pendente, aprovado, obsoleto, rejeitado) e uma tabela de registros dos registros enviados a esse registro. A partir daqui, você pode criar, visualizar ou gerenciar registros.

    3. Autorização de descoberta (autorização de entrada) — Mostra o tipo de autorização atual (AWS_IAM ou CUSTOM_JWT) e, para JWT-authorized registros, a configuração do autorizador JWT.

    4. Código de amostra — fornece código de amostra para operações comuns (criar, aprovar, listar e descobrir registros) que você pode copiar e adaptar.

    5. Tags — Mostra as tags associadas ao registro como uma tabela de valores-chave. Para adicionar, remover ou modificar tags, escolha Editar nesta seção para abrir a página Editar tags.

  5. Para modificar o registro, escolha Editar. Para excluir o registro, escolha Excluir.

  6. Para pesquisar ou procurar registros aprovados nesse registro, escolha Diretório de registros no canto superior direito da página (ou no painel de navegação). Consulte Comece a usar o Agent Registry para ver o passo a passo da descoberta.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Abra o AgentCore console https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1# Amazon Bedrock.

  2. No painel de navegação, em Descobrir, escolha Registro.

  3. Escolha o nome do registro na tabela Registros.

  4. A página de detalhes do registro tem duas guias:

    1. Gerenciar registros — Visualize e gerencie registros de registro.

    2. Pesquisar registros — Pesquise registros aprovados no registro.

  5. A seção Detalhes do Registro exibe: Nome, Status, Descrição Auto-approval (Ativado ou Desativado), ARN do Registro, Data da última atualização, Data de criação.

  6. A seção Registros do Registro mostra contadores resumidos de status (Total enviado, Aprovação pendente, Aprovado, Obsoleto, Rejeitado) e uma tabela de registros.

  7. A seção Autorização da API de Pesquisa (Autorização de Entrada) mostra o tipo de autorização atual.

AWS CLI

exemplo
AWS Agent Registry namespace
aws agent-registry-control get-registry \
  --registry-id "<registryId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control get-registry \
  --registry-id "<registryId>" \
  --region us-east-1

AWS SDK

exemplo
AWS Agent Registry namespace
import boto3

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

response = client.get_registry(
    registryId='<registryId>'
)
print(f"Name: {response['name']}")
print(f"Status: {response['status']}")
print(f"ARN: {response['registryArn']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.get_registry(
    registryId='<registryId>'
)
print(f"Name: {response['name']}")
print(f"Status: {response['status']}")
print(f"ARN: {response['registryArn']}")

Atualizar um registro

Console

exemplo
AWS Agent Registry namespace

  1. Abra o console do AWS Agent Registry.

  2. No painel de navegação, em Descobrir, escolha Registro.

  3. Selecione o botão de rádio ao lado do registro que você deseja editar e escolha Editar. Como alternativa, escolha o nome do registro e escolha Editar.

  4. Na página Editar registro, atualize qualquer um dos seguintes:

    1. Nome — Altere o nome do registro (mesmas regras de nomenclatura da criação).

    2. Descrição — Em Detalhes adicionais, atualize ou adicione uma descrição.

    3. Aprovação do registro — Ative ou Auto-approval desative. As alterações afetam somente os registros enviados após a atualização.

    4. Autorização de descoberta — Para JWT-authorized registros, atualize a configuração do autorizador JWT (clientes permitidos, públicos, escopos ou declarações personalizadas). O próprio tipo de autorização de entrada (IAM ou JWT) não pode ser alterado após a criação do registro.

  5. Escolha Salvar alterações.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Abra o AgentCore console https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1# Amazon Bedrock.

  2. No painel de navegação, em Descobrir, escolha Registro.

  3. Selecione o botão de rádio ao lado do registro que você deseja editar e escolha Editar. Como alternativa, escolha o nome do registro e escolha Editar.

  4. Na página Editar registro, atualize qualquer um dos seguintes:

    1. Nome — Altere o nome do registro (mesmas regras de nomenclatura da criação).

    2. Descrição — Em Detalhes adicionais, atualize ou adicione uma descrição.

    3. Aprovação do registro — Ative ou Auto-approval desative. As alterações afetam somente os registros enviados após a atualização.

  5. Escolha Salvar alterações.

nota

As tags não são editadas na página Editar registro. Para modificar tags, acesse a página de detalhes do registro, escolha Editar na seção Tags, adicione ou remova tags na página Editar tags e escolha Salvar alterações. (As tags só são suportadas no console do AWS Agent Registry.)

nota

A atualização da configuração de aprovação automática de OFF para ON afeta somente os registros enviados após a alteração. Os registros existentes que já estão “Aprovados pendentes” não são afetados e ainda devem ser aprovados ou rejeitados UpdateRegistryRecordStatus chamando a API. Alterar a configuração de ON para OFF afeta somente os registros que são publicados em “Aprovação pendente” após a alteração ser feita.

nota

O tipo de autorização de entrada (IAM ou JWT) e o URL de descoberta do JWT não podem ser alterados após a criação do registro. Para JWT-authorized registros, você só pode atualizar a configuração do autorizador (clientes permitidos, públicos, escopos, reivindicações personalizadas).

AWS CLI

exemplo
AWS Agent Registry namespace
aws agent-registry-control update-registry \
  --registry-id "<registryId>" \
  --description '{"optionalValue": "Updated description"}' \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control update-registry \
  --registry-id "<registryId>" \
  --description '{"optionalValue": "Updated description"}' \
  --region us-east-1

AWS SDK

exemplo
AWS Agent Registry namespace
import boto3

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

response = client.update_registry(
    registryId='<registryId>',
    description={'optionalValue': 'Updated description'}
)
print(f"Updated: {response['name']} - Status: {response['status']}")
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.update_registry(
    registryId='<registryId>',
    description={'optionalValue': 'Updated description'}
)
print(f"Updated: {response['name']} - Status: {response['status']}")

Excluir um registro

Console

exemplo
AWS Agent Registry namespace

  1. Abra o console do AWS Agent Registry.

  2. No painel de navegação, em Descobrir, escolha Registro.

  3. Selecione o botão de rádio ao lado do registro que você deseja excluir e escolha Excluir.

  4. Na caixa de diálogo de confirmação, revise o aviso: você deve primeiro excluir todos os registros do registro antes de excluir o registro.

  5. Digite delete no campo de confirmação.

  6. Escolha Excluir.

Amazon Bedrock AgentCore namespace (to be deprecated)

  1. Abra o AgentCore console https://console.aws.amazon.com/bedrock-agentcore/home?region=us-east-1# Amazon Bedrock.

  2. No painel de navegação, em Descobrir, escolha Registro.

  3. Selecione o botão de rádio ao lado do registro que você deseja excluir e escolha Excluir.

  4. Na caixa de diálogo de confirmação, revise o aviso: você deve primeiro excluir todos os registros do registro antes de excluir o registro.

  5. Digite delete no campo de confirmação.

  6. Escolha Excluir.

O status do registro muda para Excluindo. Um banner de sucesso confirma quando a exclusão é concluída.

AWS CLI

exemplo
AWS Agent Registry namespace
aws agent-registry-control delete-registry \
  --registry-id "<registryId>" \
  --region us-east-1
Amazon Bedrock AgentCore namespace (to be deprecated)
aws bedrock-agentcore-control delete-registry \
  --registry-id "<registryId>" \
  --region us-east-1

AWS SDK

exemplo
AWS Agent Registry namespace
import boto3

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

response = client.delete_registry(
    registryId='<registryId>'
)
print(f"Status: {response['status']}")  # DELETING
Amazon Bedrock AgentCore namespace (to be deprecated)
import boto3

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

response = client.delete_registry(
    registryId='<registryId>'
)
print(f"Status: {response['status']}")  # DELETING