View a markdown version of this page

Guía completa de migración de registros - Base amazónica AgentCore

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Guía completa de migración de registros

AWS Registro de agentes: migración al nuevo espacio de nombres agent-registry

Introducción

Como parte del lanzamiento del nuevo espacio de agent-registry nombres el 6 de agosto de 2026, AWS Agent Registry está introduciendo cambios importantes en el principal del servicio, los datos y el modelo de API. Si usó AWS Agent Registry en el espacio de bedrock-agentcore nombres, debe completar una migración que abarque tres áreas:

  1. Cambios en el espacio de nombres y la configuración: estamos trasladando AWS Agent Registry del espacio de nombres de AWS Bedrock a su propio espacio de AgentCore nombres dedicado. Este cambio de espacio de nombres solo se aplica al Registro de agentes. AWS Todas las demás AgentCore ofertas, como Identity, Gateway, Runtime y Policy, no se ven afectadas. En el caso del registro de AWS agentes, el espacio de nombres del servicio cambia de a. bedrock-agentcore agent-registry Esto afecta a todas las superficies que hacen referencia al servicio: puntos finales, políticas de IAM, clientes de SDK, comandos de la CLI, ARN de recursos e integraciones de observabilidad. Debes actualizar el código y la infraestructura para usar el nuevo espacio de nombres.

  2. Cambios en el esquema de la API: los modelos de datos de registro y registro se actualizan en función de los comentarios de los clientes desde el espacio de bedrock-agentcore nombres. Estos cambios rompen la compatibilidad con versiones anteriores de los esquemas de API existentes. El código de la aplicación que construye o analiza las solicitudes y respuestas de la API debe actualizarse para reflejar el nuevo esquema, como parte de la migración al nuevo espacio de nombres.

  3. Migración de datos: debes migrar los registros y registros existentes del espacio de nombres antiguo al nuevo. Ofrecemos herramientas de migración para extraer sus datos, transformarlos en el nuevo esquema y cargarlos en el nuevo espacio de nombres. Los datos se migran a la misma cuenta y región; solo cambia el espacio de nombres.

Esta guía cubre cada área en detalle con ejemplos del antes y el después para ayudarlo a planificar y ejecutar la migración.

¿Cuál es el cronograma de migración?

Hay dos hitos importantes que debes recordar para esta migración:

  • 6 de agosto de 2026: se lanza oficialmente el nuevo espacio de agent-registry nombres para AWS Agent Registry. Acceda al servicio en la consola de AWS Agent Registry. Si tiene registros y registros existentes, tiene acceso simultáneo a los espacios de agent-registry nombres bedrock-agentcore y. Las herramientas de migración están disponibles en el repositorio agentcore-samples del sitio web. GitHub Puede iniciar el proceso de migración.

    nota

    Si es un cliente nuevo sin registros o registros existentes al 6 de agosto de 2026, no puede acceder al Registro de AWS agentes a través del espacio de bedrock-agentcore nombres. Comience a usar AWS Agent Registry directamente desde el agent-registry espacio de nombres.

  • 17 de septiembre de 2026: se cierra la ventana de migración. El espacio de bedrock-agentcore nombres anterior se cierra en esta fecha. Pierdes el read/write acceso al servicio y a los datos restantes del espacio de nombres anterior. Después de esta fecha, debe usar el espacio de agent-registry nombres.

Cambios en el espacio de nombres y la configuración

El espacio de agent-registry nombres reemplaza bedrock-agentcore en los siguientes lugares. En esta sección se enumeran todas las superficies que cambian y se proporcionan ejemplos de cómo actualizar el código.

importante

Los cambios en el espacio de nombres solo afectan a las API que ofrece AWS Agent Registry, pero no al resto de AWS Bedrock AgentCore, como AWS AgentCore Identity. Por lo tanto, la identidad de la carga de trabajo y los recursos del proveedor de credenciales de OAuth permanecen en el espacio de nombres. bedrock-agentcore

Puntos de conexión de servicio

Sus aplicaciones deben apuntar a los nuevos nombres de host de los terminales. Los nuevos puntos finales utilizan el .api.aws dominio.

Surface (Superficie) Valor anterior Valor nuevo

Punto final del plano de datos

bedrock-agentcore.{region}.amazonaws.com

agent-registry.{region}.api.aws

Punto de conexión del plano de control

bedrock-agentcore-control.{region}.amazonaws.com

agent-registry-control.{region}.api.aws

IAM y seguridad

Todas las políticas de IAM, las políticas de control de servicios (SCP) y los límites de permisos a los que se hace referencia bedrock-agentcore deben actualizarse. Los ARN de los recursos también cambian para reflejar el nuevo espacio de nombres.

Surface (Superficie) Valor anterior Valor nuevo

Prefijo de acción de IAM

bedrock-agentcore:*

agent-registry:*

Entidad principal de servicio

bedrock-agentcore.amazonaws.com

agent-registry.amazonaws.com

ARN de registro

arn:aws:bedrock-agentcore:{region}:{account}:registry/{id}

arn:aws:agent-registry:{region}:{account}:registry/{id}

Registrar ARN

arn:aws:bedrock-agentcore:{region}:{account}:registry/{id}/record/{rid}

arn:aws:agent-registry:{region}:{account}:registry/{id}/record/{rid}

Si tienes una automatización que analiza los ARN o los almacena, actualiza también esas referencias. Las políticas personalizadas con condiciones en el prefijo de acción o el principal de servicio de IAM deben actualizarse para que coincidan con los nuevos valores. Para ver la lista completa de los permisos de IAM asociados al registro de AWS agentes, consulte la referencia de permisos de IAM del registro de AWS agentes.

nota

Si actualmente utiliza la política BedrockAgentCoreFullAccess AWS gestionada para acceder al registro de AWS agentes (consulte los detalles de la BedrockAgentCoreFullAccess política), debe sustituirla por la nueva política AgentRegistryFullAccess gestionada (disponible el 6 de agosto de 2026). La política BedrockAgentCoreFullAccess gestionada anterior NO se actualizará para incluir agent-registry:* los permisos.

SDK, CLI e infraestructura

Actualice el código de la aplicación, los scripts de implementación y las plantillas de infraestructura como código para hacer referencia a la nueva clase de cliente y al nuevo espacio de nombres de la CLI.

Surface (Superficie) Valor anterior Valor nuevo

Clase de cliente Dataplane SDK

BedrockAgentCoreClient

AgentRegistryClient

Clase de cliente de SDK de Controlplane

BedrockAgentCoreControlClient

AgentRegistryControlClient

Espacio de nombres CLI

aws bedrock-agentcore

aws agent-registry

Código de cuotas de servicio

bedrock-agentcore

agent-registry

Si anteriormente solicitaste aumentos de cuotas personalizados con el código bedrock-agentcore de servicio, debes volver a solicitarlos aquí. agent-registry

Observabilidad y eventos

Actualice las consultas de CloudTrail Lake, las consultas de Athena, las integraciones de SIEM, las EventBridge reglas, los CloudWatch paneles y las alarmas que hagan referencia al espacio de nombres anterior.

Surface (Superficie) Valor anterior Valor nuevo

CloudTrail fuente del evento

bedrock-agentcore.amazonaws.com

agent-registry.amazonaws.com

EventBridge fuente

aws.bedrock-agentcore

aws.agent-registry

CloudWatch espacio de nombres

AWS/BedrockAgentCore

AWS/AgentRegistry

EventBridge notificaciones

En el espacio de bedrock-agentcore nombres, AWS Agent Registry emitió dos EventBridge eventos de Amazon en la fuente del aws.bedrock-agentcore evento. La fuente de eventos ahora pasa a seraws.agent-registry, los ARN de los recursos adoptan el nuevo espacio de nombres y la cobertura de las notificaciones se amplía a todo el ciclo de vida del registro, el registro y el registro. Los eventos siguen yendo al EventBridge bus predeterminado de la propia cuenta del recurso. Debes actualizar todas EventBridge las reglas que coincidan en la antigua fuente o en las cadenas de tipo detalle antiguas.

Surface (Superficie) Valor anterior Valor nuevo

Origen del evento

aws.bedrock-agentcore

aws.agent-registry

Espacio de nombres ARN de recursos

arn:aws:bedrock-agentcore:{region}:{account}:registry/…​

arn:aws:agent-registry:{region}:{account}:registry/…​

Bus de eventos

Bus predeterminado

Bus predeterminado (sin cambios)

Registry-record eventos

1 tipo de detalle (Registry Record State changed to Pending Approval)

5 tipos de detalles (ciclo de vida de aprobación completo)

Eventos de registro

1 tipo de detalle (Registry State transitions from Creating to Ready)

7 tipos de detalles (ciclo de vida completo del registro)

Carga detail útil de eventos

registryRecordId, registryId (registros)

(sin cambios)

importante

El tipo de detalle del registro (principal) pasó de ser una frase a una cadena de estado corta. Una regla que coincide con el tipo de detalle ya Registry State transitions from Creating to Ready no se activa; actualízala aRegistry Ready. El tipo Registry Record State changed to Pending Approval de detalle del registro no ha cambiado, por lo que las reglas que coincidan con él seguirán funcionando después de actualizar el. source

Registry-record eventos. Se emite cuando un registro de registro pasa de un estado a otro del flujo de trabajo de aprobación. Resourceses el ARN completo del registro; contiene y. detail registryRecordId registryId

Tipo de detalle Desencadenador

Registry Record State changed to Draft

La versión del registro ingresa DRAFT

Registry Record State changed to Pending Approval

SubmitRegistryRecordForApprovalllamado (sin cambios)

Registry Record State changed to Approved

Graba las transiciones a APPROVED

Registry Record State changed to Rejected

Graba transiciones a REJECTED

Registry Record State changed to Deprecated

Graba transiciones a DEPRECATED

Registrar eventos. Se emite durante el aprovisionamiento del registro y las transiciones del ciclo de vida. Resourceses el ARN completo del registro; detail contiene registryId y. registryName

Tipo de detalle Desencadenador

Registry Creating

Ingresos de registro CREATING

Registry Ready

El registro pasa a ser READY (reemplaza el valor Registry State transitions from Creating to Ready del espacio de bedrock-agentcore nombres)

Registry Create Failed

Ingresos de registro CREATE_FAILED

Registry Updating

Ingresos de registro UPDATING

Registry Update Failed

Ingresos de registro UPDATE_FAILED

Registry Deleting

Ingresos de registro DELETING

Registry Delete Failed

Ingresos de registro DELETE_FAILED

Ejemplo de evento (registro de registro).

Antes (espacio de bedrock-agentcore nombres, quedará obsoleto):

{ "version": "0", "detail-type": "Registry Record State changed to Pending Approval", "source": "aws.bedrock-agentcore", "account": "123456789012", "region": "us-west-2", "resources": ["arn:aws:bedrock-agentcore:us-west-2:123456789012:registry/REG_ID/record/REC_ID"], "detail": { "registryRecordId": "REC_ID", "registryId": "REG_ID" } }

Después (espacio de agent-registry nombres):

{ "version": "0", "detail-type": "Registry Record State changed to Pending Approval", "source": "aws.agent-registry", "account": "123456789012", "region": "us-west-2", "resources": ["arn:aws:agent-registry:us-west-2:123456789012:registry/REG_ID/record/REC_ID"], "detail": { "registryRecordId": "REC_ID", "registryId": "REG_ID" } }
nota

Para hacer coincidir cualquier cambio de estado en un registro de registro con una sola regla, haga coincidir el signo source (aws.agent-registry) más el prefijo dedetail-type. Registry Record State changed to Para hacer coincidir cualquier cambio en el ciclo de vida del registro, haga coincidir el prefijo del tipo de detalle del «Registro».

Ejemplo: actualizar las políticas de IAM

Sustituya el prefijo de la acción y el espacio de nombres ARN del recurso en todas sus políticas de IAM.

Antes (espacio de bedrock-agentcore nombres, quedará obsoleto):

{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Action": [ "bedrock-agentcore:CreateRegistry", "bedrock-agentcore:GetRegistry", "bedrock-agentcore:UpdateRegistry", "bedrock-agentcore:ListRegistries", "bedrock-agentcore:DeleteRegistry", "bedrock-agentcore:CreateRegistryRecord", "bedrock-agentcore:GetRegistryRecord", "bedrock-agentcore:UpdateRegistryRecord", "bedrock-agentcore:ListRegistryRecords", "bedrock-agentcore:DeleteRegistryRecord", "bedrock-agentcore:SubmitRegistryRecordForApproval", "bedrock-agentcore:UpdateRegistryRecordStatus", "bedrock-agentcore:SearchRegistryRecords" ], "Resource": ["arn:aws:bedrock-agentcore:us-west-2:123456789012:*"] }] }

Después (espacio de agent-registry nombres):

{ "Version": "2012-10-17", "Statement": [{ "Effect": "Allow", "Action": [ "agent-registry:CreateRegistry", "agent-registry:GetRegistry", "agent-registry:UpdateRegistry", "agent-registry:ListRegistries", "agent-registry:DeleteRegistry", "agent-registry:CreateRegistryRecord", "agent-registry:GetRegistryRecord", "agent-registry:UpdateRegistryRecord", "agent-registry:ListRegistryRecords", "agent-registry:DeleteRegistryRecord", "agent-registry:SubmitRegistryRecordForApproval", "agent-registry:UpdateRegistryRecordStatus", "agent-registry:SearchDiscoverableRegistryRecords", "agent-registry:ListDiscoverableRegistryRecords", "agent-registry:GetDiscoverableRegistryRecord" ], "Resource": ["arn:aws:agent-registry:us-west-2:123456789012:*"] }] }
nota

La BatchGetDiscoverableRegistryRecord API no tiene su propia acción de IAM. Autoriza cada registro solicitado para que no participe en la agent-registry:GetDiscoverableRegistryRecord acción. Asegúrese de que su política incluya GetDiscoverableRegistryRecord el usoBatchGet.

importante

Los recursos del proveedor de credenciales de OAuth e identidad de Workload permanecen en el espacio de nombres. bedrock-agentcore Si tus registros utilizan la sincronización de URL (source.fromUrl) con credenciales de OAuth o IAM, debes conservar los siguientes permisos junto con los nuevos permisos: agent-registry:*

"bedrock-agentcore:CreateWorkloadIdentity", "bedrock-agentcore:GetWorkloadIdentity", "bedrock-agentcore:DeleteWorkloadIdentity"

No sustituyas todas las bedrock-agentcore acciones: estos recursos de identidad conservan intencionadamente el antiguo espacio de nombres.

Ejemplo: actualizar la configuración del cliente del SDK

Actualiza el nombre del servicio, la clase de cliente y la URL del punto final en tus llamadas al SDK.

Antes (espacio de bedrock-agentcore nombres, quedará obsoleto):

import boto3 session = boto3.Session(region_name="us-west-2") cp_client = session.client( "bedrock-agentcore-control", endpoint_url="https://bedrock-agentcore-control.us-west-2.amazonaws.com" ) dp_client = session.client( "bedrock-agentcore", endpoint_url="https://bedrock-agentcore.us-west-2.amazonaws.com" )

Después (espacio de agent-registry nombres):

import boto3 session = boto3.Session(region_name="us-west-2") cp_client = session.client( "agent-registry-control", endpoint_url="https://agent-registry-control.us-west-2.api.aws" ) dp_client = session.client( "agent-registry", endpoint_url="https://agent-registry.us-west-2.api.aws" )

Ejemplo: actualizar los comandos de la CLI

Sustituya el espacio de nombres de la CLI en todos los scripts y automatizaciones.

Antes (espacio de bedrock-agentcore nombres, quedará obsoleto):

aws bedrock-agentcore-control create-registry \ --name "MyRegistry" \ --description "Production registry" \ --region us-west-2 \ --endpoint-url https://bedrock-agentcore-control.us-west-2.amazonaws.com

Después (espacio de agent-registry nombres):

aws agent-registry-control create-registry \ --name "MyRegistry" \ --description "Production registry" \ --region us-west-2 \ --endpoint-url https://agent-registry-control.us-west-2.api.aws

Cambios en el esquema de la API

Además de la migración del espacio de nombres, actualizamos los modelos de datos de registro y registro del espacio de agent-registry nombres. Estos cambios mejoran la coherencia y la extensibilidad de la API en función de los comentarios del espacio de nombres. bedrock-agentcore Esta sección cubre cada categoría de cambio con ejemplos de antes y después para que puedas actualizar el código de tu aplicación.

Cambio 1: actualizaciones de la entidad de registro

La configuración de autorización del recurso de registro, que controla la forma en que se accede al plano de datos del registro, ahora se encuentra en un discoveryConfiguration contenedor dedicado que hace explícito su propósito. La configuración de aprobación (que controla si los registros enviados al PENDING_APPROVAL estado pasan automáticamente al APPROVED estado) pasa de ser una matriz de enumeración booleana a una matriz de enumeración extensible.

Los cambios de campo específicos son:

  • authorizerTypey authorizerConfiguration se mueven dentro de un discoveryConfiguration objeto nuevo.

  • approvalConfiguration.autoApproval(booleano) se reemplaza por approvalConfiguration.autoApprovalRules (matriz de cadenas de enumeración). El valor "APPROVE_ALL" tiene el mismo significado semántico que. autoApproval: true Se aplican las reglas especificadas en la lista de enumeración. No especificar (nulo) significa que se necesita la aprobación.

Antes (espacio de bedrock-agentcore nombres, quedará obsoleto):

{ "name": "string", "description": "string", "authorizerConfiguration": { ... }, "authorizerType": "string", "approvalConfiguration": { "autoApproval": true } }

Después (espacio de agent-registry nombres): con Approval ALL

{ "name": "string", "description": "string", "discoveryConfiguration": { "authorizerConfiguration": { ... }, "authorizerType": "string" }, "approvalConfiguration": { "autoApprovalRules": ["APPROVE_ALL"] } }

Después (espacio de agent-registry nombres): con NULL en la lista de enumeración

{ "name": "string", "description": "Registry with manual approval only", "approvalConfiguration": { "autoApprovalRules": [] } }

Cambio 2: nuevos campos obligatorios en los registros de registro

Los registros de registro incluyen dos nuevos campos obligatorios de nivel superior para facilitar la categorización y la deduplicación. Debe especificar ambos campos al crear un registro de registro mediante la CreateRegistryRecord API y puede cambiarlos más adelante mediante la API. UpdateRegistryRecord

Campo Tipo Description (Descripción)

name

Cadena (obligatoria)

Un identificador único dentro del registro que puede especificar el cliente. Cada registro debe tener un nombre único en el registro. Cuando también recordVersion esté presente, la combinación de name y recordVersion debe ser única.

recordType

Enum (obligatorio)

El tipo semántico del registro. Valores válidos: AGENT, MCP, SKILL, CUSTOM. Determina bajo qué clave descriptora principal es válida. descriptors Puedes usar API como ListRegistryRecords y SearchDiscoverableRegistryRecords para filtrar los resultados según este tipo semántico.

Cambio 3: Reestructuración de registros

El descriptors campo pasa de ser una unión discriminada a una estructura de clave plana.

En el modelo anterior, el descriptorType campo (MCP,, A2AAGENT_SKILLS,CUSTOM) determinaba la forma interior. Esto combinaba el contenido del descriptor con una clasificación burda de protocolo o formato. Ese campo ya no existe. recordType, un atributo de nivel superior independiente, lo reemplaza en la categorización semántica. La API aplica claves descriptoras válidas para cada uno recordType en tiempo de ejecución, en lugar de hacerlo estructuralmente en la forma. Cada clave de nivel superior que aparece debajo descriptors ahora representa un tipo de descriptor principal granular (por ejemplo,,,,a2aAgentCard). mcpServer agentSkillsDefinition custom Los descriptores complementarios (por ejemplo,tools,skillMd) se encuentran debajo del descriptor principal. additionalData El inlineContent campo pasa a ser. data Los protocolVersion campos schemaVersion y se consolidan endataSchemaVersion.

El synchronizationConfiguration atributo de nivel superior se convierte en cada descriptor (incluidos los secundarios) source y se mueve dentro de éladditionalData.

El name campo existente pasa a serdisplayName, lo que hace que su significado sea más explícito. Un name campo nuevo desde cero sirve como clave de deduplicación y debe ser único en todos los registros de un registro. Si especifica ambos name recordVersion para el mismo registro, su combinación debe ser única.

Se cambia el nombre de los siguientes campos:

Antes Después Notas

name

displayName

Nombre para mostrar del registro. También habrá un nuevo name campo que es la clave de deduplicación.

descriptorType

Eliminaciones

Reemplazado por el campo de nivel superior. recordType

inlineContent

data

La carga útil del contenido de cada descriptor.

schemaVersion / protocolVersion

dataSchemaVersion

Campo de versión unificado para todos los tipos de descriptores.

synchronizationConfiguration

source

Se mueve dentro de cada descriptor (incluidos additionalData los secundarios).

Antes (espacio de bedrock-agentcore nombres, quedará obsoleto):

{ "recordId": "string", "name": "string", "descriptorType": "string", // A2A, MCP, AGENT_SKILL, CUSTOM "descriptors": { "agent": { "a2aAgentCard": { "inlineContent": "string", "schemaVersion": "string" } }, "agentSkills": { "skillDefinition": { "inlineContent": "string", "schemaVersion": "string" }, "skillMd": { "inlineContent": "string" } }, "mcp": { "server": { "inlineContent": "string", "schemaVersion": "string" }, "tools": { "inlineContent": "string", "protocolVersion": "string" } }, "custom": { "inlineContent": "string" } }, "synchronizationType": "URL", "synchronizationConfiguration": { "fromUrl": { "url": "string", "credentialProviderConfigurations": [ { "credentialProvider": { ... }, "credentialProviderType": "string" } ] } }, ... }

Después (espacio de agent-registry nombres):

{ "recordId": "string", "displayName": "string", "name": "string", "recordVersion": "string", "recordType": "AGENT" | "MCP" | "SKILL" | "CUSTOM", "descriptors": { "a2aAgentCard": { "data": "string", "dataSchemaVersion": "string", "source": { "fromUrl": { "url": "string", "credentialProviderConfigurations": [...] } } }, "mcpServer": { "data": "string", "dataSchemaVersion": "string", "source": { "fromUrl": { ... } }, "additionalData": { "tools": { "data": "string", "dataSchemaVersion": "string" } } }, "agentSkillsDefinition": { "data": "string", "dataSchemaVersion": "string", "additionalData": { "skillMd": { "data": "string", "dataSchemaVersion": "string", "source": { "fromUrl": { ... } } } } }, "custom"?: { "data": "string" } } ... }

Existen las siguientes limitaciones:

Se puede rellenar exactamente una clave descriptora principal por registro. Los descriptores principales válidos por recordType son:

  • AGENTE: a2aAgentCard,, mcpServer custom

  • MCP: mcpServer, custom

  • HABILIDAD: agentSkillsDefinition, custom

  • PERSONALIZADO: custom

sourcees por descriptor y no por bloque único de nivel superior. Se adjunta a los descriptores que contienen un source campo en el esquema, y. mcpServer a2aAgentCard El tools hijo (debajomcpServer.additionalData), el agentSkillsDefinition padre y el custom descriptor no llevan el número. source

En el espacio de agent-registry nombres, solo source.fromUrl se admite.

Auto-synchronization solo se activa para los descriptores mcpServer y a2aAgentCard principales, es decir, los tipos de registro MCP y AGENT. La letra «sourceon» del skillMd hijo persiste, pero no se usa para ejecutar la sincronización, y los registros SKILL no se pueden sincronizar automáticamente. Los registros PERSONALIZADOS se deben crear manualmente proporcionándolos directamente. data

Cambio 4: actualizaciones de los filtros del plano de datos

SearchRegistryRecordsse convierte en SearchDiscoverableRegistryRecords (POST /discoverable-records-search). Su solicitud y respuesta recogen los nuevos nombres de campo y modelo de datos:

  • Filtrar por recordType (reemplazadescriptorType).

  • Filtrar por recordVersion (reemplazaversion).

  • La respuesta devuelve los descriptores en el nuevo formato, sin credentialProviderConfigurations ellos.

La herramienta de búsqueda MCP search_registry_records pasa a sersearch_discoverable_registry_records, devuelve el nuevo formato de descriptor y utiliza los nuevos nombres de los filtros.

Cambio 5: Nuevas API de navegación

Dos nuevas API de plano de datos permiten crear experiencias de navegación y catálogo a partir de los registros aprobados. Estas API no requieren ninguna migración explícita; las mencionamos aquí como adiciones al modelo de API de registro de AWS agentes en el espacio de agent-registry nombres.

ListDiscoverableRegistryRecords— Devuelve una lista paginada de los registros de registro aprobados. Utilícela para crear interfaces de navegación sobre el contenido publicado.

// HTTP: POST /registries/{registryId}/discoverable-records-list { "registryId": "string", // path param, required (ARN or ID) "maxResults": 1-100, // query param, optional "nextToken": "string", // query param, optional "filters": [ { "name": "recordType", "values": ["MCP"] } ] } { "registryRecords": [ { "registryArn": "string", "recordArn": "string", "recordId": "string", "name": "string", "displayName": "string", "description": "string", "recordType": "string", "recordVersion": "string", "status": "string", "createdAt": "string", "updatedAt": "string" } ], "nextToken": "string" }

BatchGetDiscoverableRegistryRecord— Recupera todos los detalles de un lote de registros de uno o más registros en una sola llamada.

// HTTP: POST /discoverable-records-batch { "entries": [ { "registryId": "reg-AAA", "recordIds": ["rec-111", "rec-222"] } ] } { "registryRecords": [ { "registryArn": "string", "recordArn": "string", "recordId": "string", "name": "string", "displayName": "string", "description": "string", "recordType": "string", "descriptors": { ... }, "recordVersion": "string", "status": "string", "createdAt": "string", "updatedAt": "string" } ], "errors": [ { "registryId": "string", "recordId": "string", "errorCode": "RESOURCE_NOT_FOUND" | "ACCESS_DENIED" | "INTERNAL_ERROR", "message": "string" } ] }

La respuesta incluye una registryRecords matriz con los detalles completos del registro y una errors matriz para los registros que no se hayan podido recuperar.

En el momento del lanzamiento, se acepta exactamente una entrada (un registro, de 1 a 100 ID de registro). La forma agrupada es compatible desde el futuro con el procesamiento por lotes entre registros en versiones futuras.

Cambio 6: las API de lista adoptan el parámetro de filtros estructurados

En el espacio de bedrock-agentcore nombres, las API de lista muestran cada campo filtrable como su propio parámetro de consulta (por ejemplo,--status READY). --recordType MCP En el espacio de agent-registry nombres, un único filters parámetro estructurado reemplaza estos parámetros discretos. El filters valor es una lista de { "name": "<dotted.path>", "values": ["<value>"] } entradas donde name hay una ruta de atributos delimitada por puntos. Los nuevos campos filtrables, incluidos los anidados, se convierten en nuevas name rutas en lugar de en nuevos parámetros de API. Las operaciones de lista también cambian de a. GET POST Los parámetros de paginación (maxResults,nextToken) no se modifican.

Antes (espacio de bedrock-agentcore nombres, quedará obsoleto):

GET /registries?status=READY&authorizerType=AWS_IAM GET /registries/{registryId}/records?name=my-agent&status=APPROVED&recordType=MCP

Después (espacio de agent-registry nombres):

// ListRegistries // POST /registries-list { "filters": [ { "name": "status", "values": ["READY"] }, { "name": "discoveryConfiguration.authorizerType", "values": ["AWS_IAM"] } ], "maxResults": 100, "nextToken": "string" } // ListRegistryRecords // POST /registries/{registryId}/records-list { "filters": [ { "name": "name", "values": ["my-agent"] }, { "name": "status", "values": ["APPROVED"] }, { "name": "recordType", "values": ["MCP"] } ], "maxResults": 100, "nextToken": "string" }

Migración de datos

Debe migrar los registros y registros de registro existentes del espacio de nombres al espacio de bedrock-agentcore nombres. agent-registry Proporcionamos una herramienta de migración para ayudar con la migración. La herramienta se encarga de la extracción de los datos existentes, la transformación del esquema anterior al nuevo y la carga en los registros del nuevo espacio de nombres. La herramienta crea nuevos registros en el espacio de agent-registry nombres dentro de la misma cuenta y región. Migra todos los registros existentes de tus registros antiguos a los nuevos, teniendo en cuenta los cambios en el espacio de nombres y en el esquema de la API.

La herramienta de migración está disponible en el repositorio agentcore-samples del sitio web. GitHub Para obtener instrucciones de configuración completas, referencias de comandos y orientación operativa, consulte el archivo README del repositorio.

Cómo elegir el enfoque de migración

El enfoque correcto depende de si basta con una migración completa de una sola vez o de si se necesita una ejecución desatendida y la capacidad de ejecutar una carga incremental en el momento de la transición.

Caso 1: migración sencilla

  • Perfil: basta con una migración completa de una sola vez. No es necesario ejecutar cargas incrementales ni dejar los trabajos ejecutándose sin supervisión.

  • Enfoque: ejecute la herramienta de migración directamente desde su terminal o AWS CloudShell. No hay infraestructura que implementar. La herramienta se conecta al espacio de bedrock-agentcore nombres, extrae los registros y registros, transforma los datos en el agent-registry esquema y los crea en el nuevo espacio de nombres. Esta es la ruta más sencilla y no requiere el despliegue de infraestructura.

Caso 2: migración gestionada con AWS Adherencia

  • Perfil: Prefiere la ejecución desatendida o planea ejecutar ambas versiones del registro en paralelo durante un período y necesita una carga incremental en el momento de la transición para capturar todos los registros creados o actualizados en el espacio de bedrock-agentcore nombres después de la ejecución completa inicial.

  • Enfoque: Implemente la migración en forma de tareas de AWS Glue utilizando la pila de CDK proporcionada. Los trabajos se ejecutan en su cuenta sin depender de una sesión de terminal abierta.

    El flujo típico es: ejecutar una migración completa para actualizar el espacio de agent-registry nombres y, a continuación, operar ambos espacios de nombres en paralelo mientras validas y actualizas las integraciones. Cuando esté listo para terminar, ejecute una carga incremental para sincronizar cualquier registro que haya cambiado durante el período paralelo, verifique y transfiera el tráfico al espacio de nombres. agent-registry

Caso 3: migración Active-active

  • Perfil: Ha creado una plataforma o una canalización de automatización sobre la base de las API del espacio de bedrock-agentcore nombres y está escribiendo continuamente nuevos registros en producción.

  • Enfoque: comience con una migración completa utilizando el AWS Glue-based enfoque administrado para llevar todos los datos históricos al espacio de agent-registry nombres. A continuación, dirija su plataforma o canalización al espacio de agent-registry nombres además del espacio de bedrock-agentcore nombres; su aplicación escribirá en ambos simultáneamente. Usa este período activo-activo para validar tus integraciones y generar confianza en el espacio de nombres. agent-registry Una vez que esté satisfecho, interrumpa todas las lecturas y escrituras en la integración del espacio de nombres agent-registry y desactive la integración del espacio de nombres. bedrock-agentcore

Verificación de la migración

Tras ejecutar la migración, confirme que los datos se han migrado correctamente:

  • Enumere todos los registros del nuevo espacio de nombres mediante el comando de la list-registries CLI y confirme que el recuento coincide con su fuente.

  • Para cada registro, compare el recuento de registros con. list-registry-records

  • Spot-check registros individuales para confirmar que los descriptores se transformaron correctamente (cambios de nombres de campos, reestructuración de descriptores).

  • Actualice sus políticas, terminales y clientes de SDK de IAM tal y como se describe en la sección de cambios en el espacio de nombres y la configuración.

  • Comprueba que tus aplicaciones puedan leer y escribir correctamente con el nuevo espacio de nombres.

Actualice las políticas de confianza de IAM para los registros sincronizados

Si alguno de tus registros utiliza la opción Sincronizar con el tipo de credencial de rol de IAM, debes actualizar la política de confianza del rol antes de ejecutar la carga en tiempo real. El principal de servicio que asume el rol cambió de bedrock-agentcore.amazonaws.com a agent-registry.amazonaws.com en en el nuevo espacio de nombres. Los registros que utilizan credenciales de OAuth o no tienen autorización no se ven afectados.

nota

La herramienta de migración no puede detectarlo; la herramienta nunca asume la función de sincronización. El servicio de registro lo asume de forma asincrónica una vez creado el registro. Si omite este paso, el registro migrado llegará al espacio de agent-registry nombres y apuntará al mismo rol y la sincronización fallará hasta que el rol confíe en el nuevo principal.

Actualice la política de confianza del rol al que hace referencia cada registro afectado.

Antes (espacio de bedrock-agentcore nombres, quedará obsoleto):

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "bedrock-agentcore.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }

Después (espacio de agent-registry nombres):

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "agent-registry.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }

Si un registro ya ha fallado por este motivo, el registro migrado existe en CREATE_FAILED estado. La herramienta de migración se niega a sobrescribir un registro en estado de error, por lo que corregir la política de confianza por sí solo no resuelve el problema. Para recuperarlo:

  1. Actualice la política de confianza del rol afectado.

  2. Elimine el CREATE_FAILED registro del espacio de agent-registry nombres.

  3. Re-run la carga.

Preguntas frecuentes

¿Qué está cambiando en AWS ¿Registro de agentes?

AWS El registro de agentes se está trasladando del espacio de bedrock-agentcore nombres al nuevo espacio de agent-registry nombres dedicado. La migración abarca tres áreas: cambios en el espacio de nombres y configuración (puntos finales, IAM, SDK, CLI, ARN, observabilidad), cambios en el esquema de API (modelo de datos reestructurado para registros y registros) y migración de datos (traslado de los registros y registros existentes al nuevo espacio de nombres).

¿Puedo seguir usando Registry en el espacio de nombres básico de agentcore?

Su uso actual del Registro en el espacio de bedrock-agentcore nombres continúa funcionando sin interrupción durante el período de migración. Sin embargo, le recomendamos que comience la migración tan pronto como las herramientas estén disponibles para asegurarse de que dispone de tiempo suficiente para completar tanto la migración de datos como las actualizaciones del código.

Sin embargo, si no tenía registros o registros existentes al 6 de agosto de 2026, no podrá acceder al espacio de bedrock-agentcore nombres del Registro de AWS agentes a partir del 6 de agosto de 2026. Si tenía registros o registros existentes al 6 de agosto de 2026, tendrá acceso al espacio de bedrock-agentcore nombres del Registro de AWS agentes durante el período de migración (del 6 de agosto de 2026 al 17 de septiembre de 2026).

¿Mis datos se migrarán automáticamente?

No. Debe iniciar la migración usted mismo utilizando las herramientas de migración que proporcionamos. Consulta la sección Migración de datos para obtener más información sobre los enfoques disponibles en función de tu escala.

¿Qué cambios en el esquema de la API se incluyen?

Además del cambio en el espacio de nombres, actualizamos el modelo de datos de la API en seis áreas: la entidad de registro (la configuración de autorización se agrupa endiscoveryConfiguration), los nuevos campos del registro (nameyrecordType) del registro, la reestructuración del registro (los descriptores se han reducido y los nombres de los campos), las actualizaciones de los filtros de la API de búsqueda (,)recordType, las nuevas API de navegación (ListDiscoverableRegistryRecords,recordVersion) y los filtros estructurados para las operaciones de lista. BatchGetDiscoverableRegistryRecord

¿Cuánto tiempo durará la migración de datos?

El tiempo de migración depende de la cantidad de registros y registros de su cuenta. En el caso de las cuentas con menos de 100 registros, la migración se completa en minutos si se ejecuta de forma local. En el caso de las cuentas con miles de registros, espera que la migración se complete en menos de 15 minutos si se ejecuta como una tarea gestionada.

¿Qué sucede si tengo una implementación a gran escala con escrituras activas?

Si está escribiendo datos de forma activa en el espacio de bedrock-agentcore nombres en producción, utilice el enfoque de migración activa-activa tal como se describe en el caso 3. Comience con una migración completa para actualizar el espacio de agent-registry nombres y, a continuación, escriba en ambos espacios de nombres simultáneamente para validar sus integraciones y fomentar la confianza en el nuevo espacio de nombres. Reduzca las lecturas y escrituras para agent-registry cuando esté listo.

¿Dónde puedo obtener ayuda?

Si tienes preguntas o necesitas ayuda con la migración, ponte en contacto con el equipo de AWS soporte.