View a markdown version of this page

Modo de mantenimiento de Amazon Bedrock Agents Classic - Amazon Bedrock
Plan de migraciónComparación de capacidadesProcedimiento de migraciónPreguntas frecuentesRecursos adicionales

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.

Modo de mantenimiento de Amazon Bedrock Agents Classic

Amazon Bedrock Agents (lanzado en noviembre de 2023) ahora es Amazon Bedrock Agents Classic y dejará de estar disponible para nuevos clientes a partir del 30 de julio de 2026. Para obtener funcionalidades similares a las de Amazon Bedrock Agents Classic, explore Amazon Bedrock. AgentCore Amazon Bedrock sigue estando disponible, pero el servicio Agents Classic estará en modo de mantenimiento.

Esta guía proporciona información sobre las opciones de migración al modo de mantenimiento para los clientes de Amazon Bedrock Agents Classic.

nota

Amazon Bedrock sigue siendo totalmente compatible. Solo el servicio Amazon Bedrock Agents Classic dejará de estar disponible para nuevos clientes a partir del 30 de julio de 2026. Sus modelos, bases de conocimiento y barreras existentes de Amazon Bedrock no se ven afectados.

Plan de migración

Le recomendamos que migre sus cargas de trabajo de Amazon Bedrock Agents Classic a Amazon Bedrock. AgentCore AgentCore es la plataforma para crear, conectar y optimizar los agentes de IA. El uso gestionado AgentCore proporciona un punto de partida basado en la configuración en el que los desarrolladores pueden declarar el modelo, las herramientas y las instrucciones del agente. AgentCore gestiona el entorno, la computación, la memoria, la identidad y la observabilidad.

El uso del agente gestionado AgentCore (recomendado)

El arnés administrado AgentCore proporciona un punto de partida basado en la configuración en el que los creadores pueden declarar el modelo, las herramientas y las instrucciones del agente. AgentCore gestiona la computación, el entorno, la memoria, la identidad y la observabilidad. El arnés admite:

  • Bucle de orquestación gestionado con conectividad de herramientas integrada

  • Los grupos de acción se muestran como herramientas de MCP a través de AgentCore Gateway (API de REST, funciones de Lambda o code-level @tools)

  • Gateway-fronted integración de la base de conocimientos

  • Herramientas funcionales en línea para patrones de retorno del control y de interacción entre humanos

  • Intérprete de código para la ejecución de código en un entorno aislado

  • Short-term y memoria a largo plazo con estrategias configurables

  • Control de las barandillas a través de una pasarela AgentCore

  • Rastreo persistente e integral de todas las acciones de los agentes

  • Configuración inmediata del sistema para conocer el comportamiento general de los agentes

Code-defined agentes en AgentCore

Para las cargas de trabajo que requieren capacidades más allá del modelo declarativo del arnés, los clientes pueden implementar agentes definidos por código directamente en. AgentCore Esta ruta admite:

  • Anulaciones rápidas en etapas específicas de la orquestación

  • Multi-agent patrones de colaboración y supervisión

  • Lógica de orquestación personalizada

  • Puntos finales más amplios OpenAI-compatible

  • Cualquier marco (Strands LangChain, OpenAI Agents SDK, Claude Agent SDK o personalizado)

Code-defined los agentes siguen beneficiándose de la infraestructura gestionada AgentCore de la empresa, a la vez que proporcionan a los desarrolladores un control total sobre el ciclo de agentes.

Usa el arnés a menos que tengas una razón específica para ser el propietario del bucle (por ejemplo, una base de código de agente existente que migrar o una orquestación avanzada que aún no esté disponible). Los clientes también pueden usar la AgentCore CLI para importar las configuraciones existentes de Bedrock Agents Classic como punto de partida para cualquiera de las rutas.

Comparación de capacidades

Bedrock Agents Classic AgentCore Equivalente
Bucle de orquestación gestionado Compatible con arnés desde el primer momento AgentCore
Los grupos de acciones se definen mediante OpenAPI, un esquema de funciones y un ejecutor Lambda opcional, a los que se accede desde el agente gestionado Las herramientas se muestran a través de AgentCore Gateway como herramientas MCP que empaquetan las API de REST y las funciones de Lambda o como @tools a nivel de código.
Las bases de conocimiento de Association of Bedrock se basan directamente en la configuración del agente para RAG Gateway-fronted integración de la base de conocimientos en. AgentCore Base de conocimientos accesible a través de una herramienta de recuperación a nivel de código.
Rastrea la interfaz de usuario y las API que muestran el preprocesamiento, la orquestación, las llamadas a grupos de acción, las consultas de KB y las observaciones de principio a fin AgentCore proporciona un seguimiento persistente e integral de todas las acciones de los agentes.
Configuración de anulación inmediata en etapas específicas (preprocesamiento, orquestación, generación de respuestas en KB, posprocesamiento) La línea de comandos del sistema en el arnés (--system-prompt) describe el comportamiento general del agente. Stage-specific las anulaciones de mensajes (preprocesamiento, generación de respuestas en KB, posprocesamiento) no se replican directamente. Para lograr un comportamiento equivalente es necesario combinar la línea de comandos del sistema con la ejecución de comandos y los scripts autogestionados.
Built-in AMAZON.UserInput herramienta para volver a solicitar automáticamente a los usuarios y obtener parámetros durante la orquestación Herramientas funcionales en línea disponibles en Harness. El agente llama a la herramienta, harness hace una pausa y devuelve tool_use al código del cliente, que gestiona la interacción del usuario y devuelve el resultado. Equivale a la devolución del control. Requiere una definición explícita de la herramienta en lugar de la obtención automática.
Built-in AMAZON.CodeInterpreter grupo de acción para la ejecución de código en espacio aislado AgentCore intérprete de código
Configuración de sesión y memoria en el agente (TTL inactivo, tipos de memoria, memoria entre sesiones) AgentCore memoria a corto y largo plazo (con diferentes estrategias de memoria)
Las barreras y la política del agente se adjuntan de forma declarativa al agente y se aplican durante la orquestación Configuración de barandas en Bedrock, con aplicación de políticas en la puerta de enlace AgentCore
Multi-agent funciones de colaboración y enrutamiento (por ejemplo, funciones de agentes supervisores y de orquestación) Limitado. El patrón de supervisor es posible al exponer a los agentes como herramientas de MCP (el agente como herramienta). El modo de enrutamiento multiagente no es sencillo en la actualidad. La colaboración completa entre varios agentes requiere un código marco personalizado.
Orquestador personalizado Compatible durante todo el AgentCore tiempo de ejecución (implementa directamente el código de orquestación personalizado). No está disponible a través de arnés.
Restablecimiento del control (el agente hace una pausa para recibir información externa) Herramientas funcionales integradas en arnés. El agente hace una pausa y devuelve tool_use al cliente.

Procedimiento de migración

Requisitos previos para migrar a Harness AgentCore

  • Node.js Más de 20 y AgentCore CLI, o Python 3.10 o más con boto3

  • AWS credenciales en una región en la que el arnés esté disponible. AgentCore Para obtener más información, consulte AWS Regiones compatibles para AgentCore.

  • Función de ejecución de IAM con los permisos necesarios

  • (Opcional) El kit de herramientas para agentes de AWS que se encuentra en el GitHub sitio web proporciona habilidades especializadas para guiar a los agentes de IA durante la migración.

Migre con el kit de herramientas para agentes para AWS (recomendado)

El kit de herramientas para agentes de AWS que figura en el GitHub sitio web incluye una amazon-bedrock habilidad que guía al agente de IA (o al asistente de codificación) durante la migración de principio a fin. Inspecciona su agente de Bedrock actual, comprueba los requisitos para la migración y asigna cada componente a su AgentCore equivalente de arnés. A continuación, la habilidad lleva a la AgentCore CLI a estructurar y desplegar el arnés. Nunca modifica su agente fuente.

Para usar la habilidad:

  1. Instale el kit de herramientas del agente para AWS. Para obtener instrucciones sobre cómo instalar el kit de herramientas del agente y habilitar la habilidad, consulte el kit de herramientas del agente para AWS README en el sitio web. GitHub

  2. Habilita la amazon-bedrock habilidad para tu agente.

  3. (Opcional) Para un acceso simplificado a AWS, configure el servidor AWS MCP. La habilidad también funciona con la AWS CLI y boto3.

  4. Instale la versión más reciente de la AgentCore CLI. La habilidad usa la AgentCore CLI para estructurar e implementar el arnés.

  5. Dígale a su agente: «Ayúdeme a migrar mi agente de Bedrock al AgentCore arnés». Proporcione el identificador, el nombre o el ARN del agente, junto con la AWS región y el perfil cuando se le solicite la habilidad.

  6. Confirma la cuenta, la región y el agente de origen en cada punto de control. La habilidad presenta un inventario de componentes, una evaluación de elegibilidad y un plan de migración por escrito. Hace una pausa para su aprobación antes de la implementación.

También puedes usar esta habilidad para responder a las preguntas de migración sin necesidad de realizar una migración. Si su agente usa una función sin una ruta de acceso validada, la habilidad se detiene y sugiere alternativas.

Migre manualmente

Si prefiere migrar sin la habilidad o si su agente no reúne los requisitos para optar por la ruta basada en las habilidades, siga estos pasos para crear el arnés con la AgentCore CLI. Utilice la versión más reciente de la AgentCore CLI.

Paso 1: Crear y configurar

agentcore create --name my-research-agent

Si ya tiene un Bedrock Agent que quiere replicar, revise su configuración (modelo, grupos de acción, KB, anulaciones rápidas) y asigne cada uno de ellos al parámetro de arnés correspondiente:

  • model — --model-id

  • action groups— Herramientas de puerta de enlace

  • KBs— Puerta de enlace o herramienta de recuperación

  • prompt — --system-prompt

Añadir herramientas:

agentcore add tool --harness my-research-agent \
  --type agentcore_browser --name browser
agentcore add tool --harness my-research-agent \
  --type agentcore_code_interpreter --name code-interpreter

Para conectar los grupos de acción existentes a través de Gateway:

agentcore add tool --harness my-research-agent \
  --type agentcore_gateway --name my-gateway \
  --gateway-arn arn:aws:bedrock-agentcore:us-west-2:123456789012:gateway/my-gw

Paso 2: Configurar el modelo y el indicador del sistema

agentcore add harness \
  --name my-research-agent \
  --model-id us.anthropic.claude-sonnet-4-6-20250514-v1:0 \
  --system-prompt "You are a research assistant." \
  --tools agentcore-browser,code-interpreter

Paso 3: implementar e invocar

agentcore deploy
agentcore invoke --harness my-research-agent \
  --session-id "$(uuidgen)" \
  "Research tropical vacation options under $3k"

Anule el modelo en cualquier invocación sin volver a implementarlo:

agentcore invoke --harness my-research-agent \
  --model-id us.anthropic.claude-opus-4-5-20251101-v1:0 \
  "Summarize this research paper"
Memoria

Está habilitado de forma predeterminada. Para asignar la memoria a usuarios individuales, pase lo siguiente: --actor-id

agentcore invoke --harness my-research-agent \
  --session-id "$(uuidgen)" --actor-id alice \
  "What did we discuss about the Portugal trip?"

Cada actor obtiene una memoria aislada. Long-term El alcance de las estrategias extrae el conocimiento mediante la identificación del actor.

Preguntas frecuentes

Impact

¿Dejarán de trabajar mis agentes actuales?

¡No!. Los agentes existentes siguen funcionando con normalidad. Todas las API (UpdateAgent,, GetAgent, ListAgents, DeleteAgent,, PrepareAgent, InvokeAgent,,, API de grupos de acción, API de bases de conocimientos, API de alias, etc.) permanecen disponibles para todos los clientes. Solo CreateAgent y InvokeInlineAgent están restringidas para cuentas sin uso previo.

¿Cómo puedo saber si mi cuenta está afectada?

Si tu cuenta ha tenido actividad en Bedrock Agents en los últimos 12 meses, estás en la lista de usuarios permitidos y no te afecta. Esto se aplica por cuenta. Si tiene varias AWS cuentas, solo están permitidas aquellas que hayan utilizado Bedrock Agents anteriormente. Las cuentas que no hayan sido utilizadas anteriormente recibirán un AccessDeniedException (HTTP 403) cuando CreateAgent llamen o. InvokeInlineAgent

¿Qué error veré si mi cuenta no está en la lista de permitidos?

Código de error: AccessDeniedException (HTTP 403)

Mensaje: «Bedrock Agents está en modo de mantenimiento. La creación de nuevos agentes no está disponible para cuentas sin un uso previo del servicio. Para obtener más información, consulte el modo de mantenimiento de Amazon Bedrock Agents Classic».

¿Tengo que tomar medidas?

No de inmediato. Sus cargas de trabajo actuales no se ven afectadas. Sin embargo, recomendamos evaluar el desarrollo AgentCore de nuevos agentes y las futuras migraciones, ya que no se añadirán nuevas funciones a Bedrock Agents Classic.

¿Puedo solicitar una excepción para Bedrock Agents en una cuenta nueva después del 30 de julio?

¡No!. No hay ningún proceso de excepción. AWS determina automáticamente la lista de permitidos en función de si su cuenta ha tenido actividad en Bedrock Agents en los últimos 12 meses. Si necesita funciones de agente en una cuenta nueva, utilice Amazon Bedrock AgentCore, que ofrece funciones equivalentes y ampliadas.

¿Qué pasa con el cambio de nombre a «Bedrock Agents Classic»?

Se trata únicamente de una actualización de nombres. No tiene que hacer nada. Los espacios de nombres de API (bedrock-agent), los clientes de SDK, los tipos de CloudFormation recursos y los prefijos de acción de IAM existentes permanecen sin cambios.

¿Seguirán funcionando mis plantillas, las de CDK o CloudFormation Terraform?

Sí. Las plantillas de IaC existentes que crean o administran Bedrock Agents seguirán funcionando para las cuentas incluidas en la lista de permitidos. Si aprovisiona nuevos entornos en cuentas sin haber utilizado previamente Bedrock Agents, utilice en su lugar los recursos de Amazon Bedrock AgentCore en sus plantillas.

¿Habrá nuevas versiones de modelos disponibles en Bedrock Agents Classic?

¡No!. El catálogo de modelos disponible en Bedrock Agents Classic está congelado a partir de la fecha de entrada en vigor del modo de mantenimiento (30 de julio de 2026). Los nuevos modelos lanzados después de esa fecha estarán disponibles hasta AgentCore el final. La propia Amazon Bedrock (inferencia de modelos, bases de conocimiento, Guardrails) sigue recibiendo nuevos modelos. Esta restricción solo se aplica a la capa de orquestación de Bedrock Agents Classic.

¿Cambiarán los precios de Bedrock Agents Classic?

Bedrock Agents Classic en sí es gratuito. Seguirá pagando únicamente por la inferencia del modelo subyacente y los recursos asociados (bases de conocimiento, invocaciones de Lambda, etc.) como antes.

Migración

¿Cuál es la ruta de migración recomendada?

AgentCore es la plataforma recomendada. Hay dos rutas disponibles:

  • AgentCore harness: una experiencia basada en la configuración similar a Bedrock Agents Classic. Declare su modelo, sus herramientas y sus instrucciones; AgentCore gestiona la computación, la memoria, la identidad y la observabilidad. Este es el análogo más parecido a la experiencia gestionada por Bedrock Agents.

  • Code-defined agentes activados AgentCore: para cargas de trabajo que requieren una orquestación avanzada, una colaboración entre varios agentes o una lógica personalizada. Implemente cualquier marco (Strands LangChain, OpenAI Agents SDK, Claude Agent SDK o personalizado) en su infraestructura gestionada. AgentCore

¿Existe una herramienta de migración automatizada?

Sí. En el kit de herramientas para agentes de AWS del sitio web encontrará información sobre las habilidades de los agentes que le ayudarán a migrar Bedrock Agents Classic directamente a AgentCore Harness. GitHub Esta habilidad también está disponible a través del AWS servidor MCP. Para obtener instrucciones sobre la instalación y el uso de la habilidad, consulte el kit de herramientas del agente para AWS README en el sitio web. GitHub Empieza con el mensaje «Ayúdame a migrar mi Bedrock Agent a AgentCore harness».

¿Cuánto dura la migración?

Para los agentes sencillos (modelos, grupos de acción y base de conocimientos), la importación de la CLI o la configuración del arnés llevan horas. El esfuerzo principal consiste en revisar el código generado o redistribuir los grupos de acción detrás AgentCore de Gateway. Los agentes complejos con orquestadores personalizados o que colaboren entre varios agentes requerirán un trabajo de programación más importante.

¿Hay una fecha límite para migrar?

No hay una fecha límite para la migración. Bedrock Agents Classic permanece disponible para los clientes actuales en modo de mantenimiento sin una fecha prevista de finalización de su vida útil. Sin embargo, dado que no está prevista ninguna función nueva, recomendamos realizar la migración para aprovechar las ventajas de la AgentCore innovación continua.

¿Qué pasa con mis bases de conocimiento de Bedrock?

Las bases de conocimiento siguen funcionando y no se ven afectadas por el modo de mantenimiento. Al migrar a AgentCore, conéctelas a través de una AgentCore puerta de enlace. El recurso subyacente de la base de conocimientos no ha cambiado.

¿Qué pasa con mis barandas Bedrock?

Las barandillas configuradas en el modelo Bedrock aún se aplican cuando se invoca el modelo. AgentCore Agent-level La aplicación de las barandillas está disponible a través de las políticas de pasarela. AgentCore

¿Puedo seguir usando los mismos modelos?

¿Sí?. AgentCore es compatible con el catálogo completo de modelos de Bedrock, además de proveedores adicionales (OpenAI, Gemini y cualquier OpenAI-compatible punto final). Puede cambiar de proveedor de modelos a mitad de sesión sin tener que volver a implementarlo.

¿Qué pasa con la colaboración entre varios agentes?

Puede crear patrones para varios agentes durante el AgentCore tiempo de ejecución con cualquier marco compatible. El arnés administrado admite un patrón de agente como herramienta para casos de uso más sencillos con varios agentes.

¿Qué pasa con los agentes en línea?

Las cuentas que InvokeInlineAgent se hayan usado en los últimos 12 meses pueden seguir usando agentes en línea. Para los nuevos desarrollos, el arnés AgentCore gestionado proporciona capacidades de agente efímero equivalentes con funciones adicionales (memoria, sesiones con estado, conectividad de herramientas a través de una puerta de enlace). Próximamente se publicará una guía de migración para los agentes en línea.

¿En qué regiones está AgentCore disponible?

AgentCore está disponible en estas regiones. Si sus cargas de trabajo de Bedrock Agents Classic AgentCore se ejecutan en una región en la que aún no están disponibles, puede seguir usando Bedrock Agents Classic en esas regiones mientras migra el nuevo desarrollo a AgentCore una región compatible.

Precios y soporte

¿Cuánto AgentCore cuesta?

AgentCore utiliza precios basados en el consumo en todas sus capacidades (tiempo de ejecución, memoria, puerta de enlace). No hay ningún cargo adicional por la orquestación del arnés. AgentCoreEl arnés es más eficiente desde el punto de vista simbólico que las instrucciones internas de Bedrock Agents Classic, por lo que los clientes pueden ver costos de inferencia comparables o inferiores a los de los modelos. AgentCoreConsulta los precios para obtener más información.

Recursos adicionales