View a markdown version of this page

Crie e gerencie registros - Amazon Bedrock AgentCore
Crie um registroListar registrosExibir detalhes do registroAtualizar um registroExcluir um registro

Crie e gerencie registros

Próxima migração de namespace

AWS O Agent Registry está atualmente em versão prévia pública no namespace bedrock-agentcore. A partir de 6 de agosto de 2026, o serviço passa para o namespace agent-registry. Se você usa o AWS Agent Registry, deve atualizar seus endpoints, políticas do IAM, clientes SDK, scripts de CLI e dados de registro. Para obter mais informações sobre a migração da versão prévia pública, consulte o guia abrangente de migração do registro.

Crie um registro

Console

  1. Abra o AgentCore console 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 dígito. Os caracteres válidos são a-z, 0-9 A-Z, _ (sublinhado), - (hífen),. (ponto) e/(barra para frente). O nome pode ter até 64 caracteres.

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

  6. (Opcional) Expanda a Autorização da API de Pesquisa para configurar como os consumidores autorizam ao pesquisar o registro (Autorização de entrada). Escolha AWS IAM para usar AWS credenciais padrão ou tokens Web JSON (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 declaraçõ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, um curador deve revisar e aprovar cada registro antes que ele se torne pesquisável.

  8. Escolha Criar registro.

O status do registro começa como Criando e muda 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 Registro do AWS Agente verificará todos eles.

AWS CLI

IAM-based registro: 

aws bedrock-agentcore-control create-registry \
  --name "MyRegistry" \
  --description "Production registry" \
  --region us-east-1

JWT-based registro: 

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

AWS SDK

IAM-based registro: 

import boto3

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

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

JWT-based registro: 

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

Listar registros

Console

  1. Abra o AgentCore console 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 do registro.

    6. Criado — A data e hora da criação.

    7. Última atualização — A data e 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

aws bedrock-agentcore-control list-registries \
  --region us-east-1

AWS SDK

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

  1. Abra o AgentCore console 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 Search API Authorization (Inbound Authorization) mostra o tipo de autorização atual.

AWS CLI

aws bedrock-agentcore-control get-registry \
  --registry-id "<registryId>" \
  --region us-east-1

AWS SDK

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

  1. Abra o AgentCore console 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 uma das seguintes opções:

    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-approvaldesative. As alterações afetam somente os registros enviados após a atualização.

  5. Escolha Salvar alterações.

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 publicados como “Aprovação pendente” após a alteração ser feita.

nota

O URL de descoberta (para um registro autorizado pelo JWT) não pode ser alterado após a criação do registro. O tipo de autorização de entrada (IAM ou JWT) não pode ser alterado após a criação do registro.

AWS CLI

aws bedrock-agentcore-control update-registry \
  --registry-id "<registryId>" \
  --description '{"optionalValue": "Updated description"}' \
  --region us-east-1

AWS SDK

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

  1. Abra o AgentCore console 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

aws bedrock-agentcore-control delete-registry \
  --registry-id "<registryId>" \
  --region us-east-1

AWS SDK

import boto3

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

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