View a markdown version of this page

Crie e gerencie registros - Amazon Bedrock AgentCore
Criar um registro de registroListar registros de registroExibir detalhes do registroAtualizar um registro do registroEnvie um registro para aprovaçãoExcluir um registro do registroValidação do esquema

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.

Criar um registro de registro

Console

  1. Abra a página de detalhes do registro.

  2. Na seção Registros do registro, escolha Criar registro.

  3. Escolha um tipo de fonte:

    1. Sincronizar a partir do endpoint — forneça uma URL do endpoint e credenciais opcionais para invocar o endpoint, e o registro buscará metadados da fonte. Disponível somente para os tipos de registro MCP e Agent. Para atualizar o registro após a alteração da fonte, você deve acionar manualmente a sincronização. Consulte Sincronizar registros de fontes externas para obter detalhes.

    2. Manual — Configure manualmente os detalhes do registro e a configuração do protocolo.

Sincronizar a partir do endpoint

  1. Em Detalhes do registro, selecione o tipo de registro: MCP ou Agente.

    nota

    A sincronização só é suportada para os tipos de registro MCP e Agent. As habilidades do agente e os tipos de registro personalizados não oferecem suporte à sincronização. Em vez disso, use o tipo de fonte Manual.

  2. Insira o URL do endpoint. Deve ser um URL HTTPS válido.

  3. Em Tipo de credencial, escolha como o registro autoriza com o endpoint:

    1. IAM — Forneça um ARN de função para assinatura SigV4 e um nome de serviço (por exemplo,,,bedrock-agentcore). execute-api lambda Opcionalmente, especifique uma região para assinatura.

    2. OAuth — Selecione ou insira um ARN do provedor de credenciais em Identity. AgentCore Opcionalmente, configure escopos e parâmetros personalizados em Configuração adicional.

    3. Nenhuma — Sem autorização (para endpoints públicos).

  4. Escolha Create record (Criar registro).

    O registro é criado no status CREATING. O registro se conecta ao endpoint, extrai metadados e preenche os descritores do registro. Após a conclusão da sincronização, o registro passa para DRAFT. Se a sincronização falhar, o registro passa para o status CREATE_FAILED com os detalhes do erro disponíveis no campo Motivo do status na página de detalhes do registro. Para solucionar problemas, consulte Erros de sincronização de registros. Para atualizar o registro quando a fonte mudar, use o botão Sincronizar na página de detalhes do registro ou Re-sync selecione um endpoint durante a edição.

Para exemplos de AWS CLI e SDK de criação de registros com sincronização, consulte Sincronizar registros de fontes externas.

Manual

  1. Em Detalhes do registro, insira:

    1. 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é 255 caracteres.

    2. Descrição (opcional) — 1 a 4.096 caracteres.

    3. Versão do registro — Especifique a versão desse registro (por exemplo, 1.0.0, v2.1).

  2. Em Tipo de registro, selecione uma das seguintes opções: MCP, Agent, Agent Skills ou Custom.

  3. Um editor de tipo específico é exibido. Insira sua configuração de protocolo no formato JSON.

    1. Para os tipos Agente e MCP, ative Mostrar esquema oficial para exibir o esquema de referência lado a lado para obter orientação.

    2. O console valida seu JSON em relação ao esquema oficial e mostra erros embutidos (por exemplo, “Nome” da propriedade ausente) com um botão Diagnosticar com o Amazon Q.

  4. Escolha uma destas opções:

    1. Criar como rascunho — cria o registro no status Rascunho.

    2. Criar e enviar para aprovação — cria o registro e o envia imediatamente para aprovação.

AWS CLI

aws bedrock-agentcore-control create-registry-record \
  --registry-id <registryId> \
  --name "MyMCPServer" \
  --descriptor-type MCP \
  --descriptors '{"mcp": {"server": {"inlineContent": "{\"name\": \"my/mcp-server\", \"description\": \"My MCP server\", \"version\": \"1.0.0\"}"}}}' \
  --record-version "1.0" \
  --region us-east-1

AWS SDK

import boto3
import json

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

server_content = json.dumps({
    "name": "my/mcp-server",
    "description": "My MCP server",
    "version": "1.0.0"
})

response = client.create_registry_record(
    registryId='<registryId>',
    name='MyMCPServer',
    descriptorType='MCP',
    descriptors={
        'mcp': {
            'server': {
                'inlineContent': server_content
            }
        }
    },
    recordVersion='1.0'
)
print(f"Record ARN: {response['recordArn']}")
print(f"Status: {response['status']}")  # CREATING

Listar registros de registro

Console

  1. Abra a página de detalhes do registro.

  2. A seção Registros do registro exibe:

    1. Contadores de resumo de status — Total enviado, aprovação pendente, aprovado, obsoleto, rejeitado.

    2. Tabela de registros com colunas: nome, descrição, status, tipo de registro, ARN do registro, última atualização.

  3. Use a barra Pesquisar registros para filtrar por nome.

  4. Use o menu suspenso Atualizar status para realizar alterações de status em massa nos registros selecionados.

AWS CLI

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

AWS SDK

import boto3

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

response = client.list_registry_records(
    registryId='<registryId>'
)
for record in response['registryRecords']:
    print(f"{record['name']} - {record['status']} - {record['descriptorType']}")

Exibir detalhes do registro

Console

  1. Na página de detalhes do registro, escolha um nome de registro na tabela de registros.

  2. A página de detalhes do registro exibe:

    1. Seção de detalhes do registro — Nome, Descrição, ARN do registro, Status (mostrado como um selo ao lado do nome do registro), Versão, Data da última atualização, Tipo de registro, ID do registro, Data de criação.

    2. Seção de configuração de sincronização (se configurada) — Tipo de sincronização, URL de origem e detalhes do provedor de credenciais (ARN da função do IAM, ARN do serviço, região ou provedor de OAuth, tipo de concessão, escopos, parâmetros personalizados).

    3. Seção de configuração de protocolo — O conteúdo do descritor exibido como JSON formatado (por exemplo, “Cartão de agente” para registros A2A, “Servidor” e “Ferramentas” para registros MCP).

  3. Ações disponíveis:

    1. Botão de sincronização (somente registros MCP e Agent) — Aciona uma nova sincronização a partir do endpoint configurado. Abre uma caixa de diálogo de confirmação antes de continuar. O registro muda para o status ATUALIZANDO durante a sincronização.

    2. Lista suspensa de status de atualização — Enviar para aprovação, Aprovar, Rejeitar ou Descontinuar.

    3. Three-dot menu (ffy) — Editar ou excluir.

AWS CLI

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

AWS SDK

import boto3

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

response = client.get_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Name: {response['name']}")
print(f"Description: {response['description']}")
print(f"Status: {response['status']}")
print(f"Descriptor Type: {response['descriptorType']}")
print(f"Version: {response['recordVersion']}")

Atualizar um registro do registro

Console

  1. Na página de detalhes do registro, escolha o menu de três pontos (recover) e, em seguida, escolha Editar.

  2. Na página Editar registro, atualize qualquer uma das seguintes opções:

    1. Nome, Descrição, Versão do registro em Detalhes do registro.

    2. Tipo de registro — altere o tipo de protocolo, se necessário.

  3. (Somente registros MCP e Agent) Em Sincronizar a partir do endpoint, configure opcionalmente a sincronização:

    Você pode atualizar registros por meio da sincronização, independentemente de eles terem sido criados originalmente com a sincronização. Quando a sincronização é acionada durante uma atualização, o registro passa para o status ATUALIZANDO. Se for bem-sucedida, uma nova versão do registro será criada no status RASCUNHO. Se falhar, o registro passa para o status UPDATE_FAILED com detalhes do erro no campo Motivo do status. Os dados sincronizados substituem o nome, a descrição, a versão, as definições da ferramenta e as definições do servidor do registro pelos valores encontrados na fonte, mas não modificam os campos que a fonte não fornece. Um administrador ou curador deve revisar e aprovar o novo rascunho para que ele fique visível na pesquisa. Até lá, a revisão aprovada anteriormente (se houver) permanece pesquisável. Para obter mais informações sobre o comportamento de revisão dupla, consulte Ciclo de vida do registro.

    1. Insira uma URL do Endpoint para habilitar a sincronização. Os campos do tipo de credencial aparecem quando um endpoint é fornecido. Se o registro já tiver a sincronização configurada, os campos do endpoint e do provedor de credenciais serão pré-preenchidos com a configuração existente.

    2. Escolha um tipo de credencial (IAM, OAuth ou Nenhuma) e preencha os campos obrigatórios. Se o registro tiver sido configurado anteriormente com um provedor de credenciais, os valores existentes serão pré-preenchidos.

    3. Re-sync Selecione no endpoint para acionar uma nova sincronização ao salvar. O registro muda para o status ATUALIZANDO durante a sincronização.

    4. Para remover a sincronização, escolha o botão Limpar ao lado do campo do endpoint. Isso redefine o endpoint e todos os campos de credenciais.

  4. Em Configuração de registro, atualize as definições do registro no editor JSON.

    1. Você pode configurar o endpoint para sincronização e editar manualmente as definições do registro. Quando a sincronização é acionada, o registro busca os metadados mais recentes do endpoint e atualiza o nome, a descrição, a versão, as definições da ferramenta e as definições do servidor do registro com os valores encontrados na fonte, tendo precedência sobre qualquer edição manual nesses campos. Os campos que a fonte não fornece não são modificados.

  5. O console valida seu JSON em relação ao esquema oficial e mostra erros embutidos com o botão Diagnosticar com o Amazon Q.

  6. Escolha uma destas opções:

    1. Salvar alterações — Salva o registro como rascunho.

    2. Salvar e enviar para aprovação — Salva e envia em uma única etapa.

Um banner de sucesso confirma: “[Nome] foi atualizado e enviado para aprovação com sucesso”.

AWS CLI

aws bedrock-agentcore-control update-registry-record \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --description "Updated description" \
  --region us-east-1

AWS SDK

import boto3

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

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

Envie um registro para aprovação

Console

Na página de detalhes do registro -

  1. Escolha a lista suspensa de status da atualização

  2. Em seguida, escolha Enviar para aprovação.

    1. Como alternativa, use Criar e enviar para aprovação ou Salvar e enviar para aprovação durante a criação ou edição.

nota

Se a Auto-Approval configuração do Registro estiver definida como VERDADEIRA, o envio de um registro para aprovação o aprovará automaticamente. Caso contrário, se a Auto-Approval configuração for definida como FALSA, o registro passará para o status “Aprovação pendente” e aguardará que o curador aprove ou rejeite. Além disso, uma EventBridge notificação da Amazon é acionada indicando que um novo registro foi solicitado para aprovação.

AWS CLI

aws bedrock-agentcore-control submit-registry-record-for-approval \
  --registry-id "<registryId>" \
  --record-id "<recordId>" \
  --region us-east-1

AWS SDK

import boto3

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

response = client.submit_registry_record_for_approval(
    registryId='<registryId>',
    recordId='<recordId>'
)
print(f"Status: {response['status']}")  # PENDING_APPROVAL or APPROVED

Excluir um registro do registro

Console

  1. Na página de detalhes do registro, escolha o menu de três pontos (recover) e, em seguida, escolha Excluir.

  2. Confirme a exclusão digitando 'delete' quando solicitado

A exclusão é permanente e não pode ser desfeita.

AWS CLI

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

AWS SDK

import boto3

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

response = client.delete_registry_record(
    registryId='<registryId>',
    recordId='<recordId>'
)
print("Record deleted successfully")

Validação do esquema

Quando você cria ou edita um registro, o console e a API validam sua configuração de protocolo em relação ao esquema oficial do tipo de registro selecionado. Mais detalhes sobre validações podem ser encontrados em Tipos de registro compatíveis.