View a markdown version of this page

Modo de manutenção clássico do Amazon Bedrock Agents - Amazon Bedrock
Plano de migraçãoComparando capacidadesProcedimento de migraçãoPerguntas frequentesRecursos adicionais do

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á.

Modo de manutenção clássico do Amazon Bedrock Agents

O Amazon Bedrock Agents (lançado em novembro de 2023) agora é o Amazon Bedrock Agents Classic e não estará mais aberto a novos clientes a partir de 30 de julho de 2026. Para obter recursos semelhantes aos Amazon Bedrock Agents Classic, explore o Amazon Bedrock AgentCore. O Amazon Bedrock continua disponível, mas o serviço Agents Classic estará em modo de manutenção.

Este guia fornece informações sobre as opções de migração do modo de manutenção para clientes do Amazon Bedrock Agents Classic.

nota

O Amazon Bedrock continua sendo totalmente suportado. Somente o serviço Amazon Bedrock Agents Classic não está mais aberto para novos clientes a partir de 30 de julho de 2026. Seus modelos, bases de conhecimento e guardrails existentes do Amazon Bedrock não são afetados.

Plano de migração

Recomendamos que você migre suas cargas de trabalho do Amazon Bedrock Agents Classic para o Amazon Bedrock. AgentCore AgentCore é a plataforma para criar, conectar e otimizar agentes de IA. O equipamento gerenciado em AgentCore fornece um ponto de partida baseado em configuração, no qual os desenvolvedores podem declarar o modelo, as ferramentas e as instruções do agente. AgentCore lida com o ambiente, a computação, a memória, a identidade e a observabilidade.

O aproveitamento do agente gerenciado em AgentCore (recomendado)

O equipamento gerenciado em AgentCore fornece um ponto de partida baseado em configuração, no qual os criadores podem declarar o modelo, as ferramentas e as instruções do agente. AgentCore lida com computação, ambiente, memória, identidade e observabilidade. O arnês suporta:

  • Loop de orquestração gerenciado com conectividade de ferramentas integrada

  • Grupos de ação expostos como ferramentas MCP por meio de AgentCore gateway (APIs REST, funções Lambda ou @tools em nível de código)

  • Gateway-fronted integração da base de conhecimento

  • Ferramentas de função em linha para retorno de controle e padrões humano-in-the-loop

  • Intérprete de código para execução de código em sandbox

  • Short-term e memória de longo prazo com estratégias configuráveis

  • Aplicação de guardrail por meio de gateway AgentCore

  • Rastreamento persistente e de ponta a ponta de todas as ações do agente

  • Configuração do prompt do sistema para o comportamento geral do agente

Code-defined agentes em AgentCore

Para cargas de trabalho que exigem recursos além do modelo declarativo do equipamento, os clientes podem implantar agentes definidos por código diretamente no. AgentCore Esse caminho oferece suporte a:

  • Substituições imediatas em estágios específicos de orquestração

  • Multi-agent padrões de colaboração e supervisão

  • Lógica de orquestração personalizada

  • OpenAI-compatible Endpoints mais amplos

  • Qualquer estrutura (Strands LangChain, OpenAI Agents SDK, Claude Agent SDK ou personalizada)

Code-defined os agentes ainda se beneficiam AgentCore da infraestrutura gerenciada da, ao mesmo tempo em que oferecem aos desenvolvedores controle total sobre o ciclo de agentes.

Use o equipamento, a menos que você tenha um motivo específico para ser o proprietário do loop (por exemplo, uma base de código de agente existente para migrar ou uma orquestração avançada que o equipamento ainda não expressa). Os clientes também podem usar a AgentCore CLI para importar as configurações existentes do Bedrock Agents Classic como ponto de partida para qualquer caminho.

Comparando capacidades

Bedrock Agents Classic AgentCore Equivalente
Loop de orquestração gerenciado Suportado pronto para uso com arnês AgentCore
Grupos de ação definidos por meio do OpenAPI//function schema + executor Lambda opcional, chamado pelo agente gerenciado Ferramentas expostas por meio do AgentCore gateway como ferramentas MCP que envolvem APIs REST e funções Lambda ou @tools em nível de código.
Associação de Bedrock Knowledge Bases diretamente na configuração do agente para RAG Gateway-fronted integração da base de conhecimento em AgentCore. Base de conhecimento acessível por meio de uma ferramenta de recuperação em nível de código.
Interface de usuário e APIs de rastreamento que mostram pré-processamento, orquestração, chamadas de grupos de ação, consultas de KB e observações de ponta a ponta AgentCore fornece rastreamento persistente e de ponta a ponta de todas as ações do agente.
Configuração de substituição imediata em estágios específicos (pré-processamento, orquestração, geração de respostas de KB, pós-processamento) O prompt do sistema no harness (--system-prompt) abrange o comportamento geral do agente. Stage-specific as substituições rápidas (pré-processamento, geração de respostas de KB, pós-processamento) não são replicadas diretamente. Para alcançar um comportamento equivalente, é necessário combinar o prompt do sistema com a execução de comandos e scripts autogerenciados.
Built-in AMAZON.UserInput ferramenta para resolicitação automática do usuário e elicitação de parâmetros durante a orquestração Ferramentas de função em linha no arnês. O agente chama a ferramenta, o harness faz uma pausa e retorna tool_use ao código do cliente, que gerencia a interação do usuário e envia o resultado de volta. Equivalente ao retorno do controle. Requer definição explícita da ferramenta em vez de elicitação automática.
Built-in AMAZON.CodeInterpreter grupo de ação para execução de código em área restrita AgentCore intérprete de código
Configuração de sessão e memória no agente (TTL inativo, tipos de memória, memória entre sessões) AgentCore memória para curto e longo prazo (com diferentes estratégias de memória)
Diretrizes de proteção e política do agente anexadas declarativamente ao agente e aplicadas durante a orquestração Configuração de guardrail em Bedrock, com aplicação de políticas no gateway AgentCore
Multi-agent funções de colaboração e roteamento (por exemplo, agentes supervisores e funções de orquestração) Limitado. O padrão do supervisor é possível expondo agentes como ferramentas MCP (agente como ferramenta). Atualmente, o modo de roteamento multiagente não é simples. A colaboração completa de vários agentes exige um código de estrutura personalizado.
Orquestrador personalizado Suportado por meio AgentCore de tempo de execução (implante código de orquestração personalizado diretamente). Não disponível por meio de arnês.
Retorno do controle (o agente faz uma pausa para entrada externa) Ferramentas de função em linha no arnês. O agente faz uma pausa e retorna tool_use ao cliente.

Procedimento de migração

Pré-requisitos para migrar para o harness AgentCore

  • Node.js 20+ e AgentCore CLI, ou Python 3.10+ com boto3

  • AWS credenciais em uma região onde o AgentCore arnês está disponível. Para obter mais informações, consulte AWS Regiões suportadas para AgentCore.

  • Função de execução do IAM com as permissões necessárias

  • (Opcional) O kit de ferramentas de agentes para a AWS no GitHub site fornece habilidades especializadas para orientar seus agentes de IA durante a migração.

Migre com o kit de ferramentas do agente para AWS (recomendado)

O kit de ferramentas do agente para a AWS no GitHub site inclui uma amazon-bedrock habilidade que orienta seu agente de IA (ou assistente de codificação) durante a migração de ponta a ponta. Ele inspeciona seu agente Bedrock existente, verifica a elegibilidade da migração e mapeia cada componente para seu AgentCore equivalente de equipamento. A habilidade então leva a AgentCore CLI a montar e implantar o arnês. Ele nunca modifica seu agente de origem.

Para usar a habilidade:

  1. Instale o kit de ferramentas do agente para a AWS. Para obter instruções sobre como instalar o kit de ferramentas do agente e ativar a habilidade, consulte o kit de ferramentas do agente para AWS README no site. GitHub

  2. Ative a amazon-bedrock habilidade para seu agente.

  3. (Opcional) Para um acesso simplificado à AWS, configure o servidor AWS MCP. A habilidade também funciona com a AWS CLI e o boto3.

  4. Instale a versão mais recente da AgentCore CLI. A habilidade usa a AgentCore CLI para montar e implantar o arnês.

  5. Pergunte ao seu agente “Ajude-me a migrar meu agente Bedrock para AgentCore aproveitar”. Forneça o ID, o nome ou o ARN do agente, junto com a AWS região e o perfil quando a habilidade solicitar.

  6. Confirme a conta, a região e o agente de origem em cada ponto de verificação. A habilidade apresenta um inventário de componentes, uma avaliação de elegibilidade e um plano de migração por escrito. Ele faz uma pausa para sua aprovação antes da implantação.

Você também pode usar a habilidade para responder a perguntas de migração sem realizar uma migração. Se seu agente usa um recurso sem um caminho de aproveitamento validado, a habilidade é interrompida e sugere alternativas.

Migre manualmente

Se você preferir migrar sem a habilidade, ou se seu agente não estiver qualificado para o caminho orientado por habilidades, siga estas etapas para criar a vantagem com a CLI. AgentCore Use a versão mais recente da AgentCore CLI.

Etapa 1: criar e configurar

agentcore create --name my-research-agent

Se você tiver um agente Bedrock existente que deseja replicar, revise sua configuração (modelo, grupos de ação, KBs, substituições de prompts) e mapeie cada um para o parâmetro de chicote correspondente:

  • model — --model-id

  • action groups— Ferramentas de gateway

  • KBs— Gateway ou ferramenta de recuperação

  • prompt — --system-prompt

Adicione ferramentas:

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 grupos de ação existentes por meio do 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

Etapa 2: Configurar o modelo e o prompt do 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

Etapa 3: implantar e invocar

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

Substitua o modelo em qualquer invocação sem reimplantar:

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

Habilitada por padrão. Para definir o escopo da memória para usuários individuais, passe--actor-id:

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

Cada ator recebe uma memória isolada. Long-term estratégias abrangem o conhecimento extraído por ID de ator.

Perguntas frequentes

Impacto

Meus agentes existentes deixarão de trabalhar?

Não. Os agentes existentes continuam funcionando normalmente. Todas as APIs (UpdateAgent,, GetAgent, ListAgents,, DeleteAgent PrepareAgent InvokeAgent, APIs de grupos de ação, APIs de base de conhecimento, APIs de aliases etc.) permanecem disponíveis para todos os clientes. Somente CreateAgent e InvokeInlineAgent são restritos para contas sem uso prévio.

Como posso saber se minha conta foi afetada?

Se sua conta teve atividade de Bedrock Agents nos últimos 12 meses, você está na lista de permissões e não foi afetado. Isso se aplica por conta. Se você tiver várias AWS contas, somente aquelas com uso anterior dos Bedrock Agents serão permitidas. Contas sem uso prévio receberão um AccessDeniedException (HTTP 403) ao ligar para CreateAgent ou InvokeInlineAgent.

Que erro vou ver se minha conta não estiver na lista de permissões?

Código de erro: AccessDeniedException (HTTP 403)

Mensagem: “Bedrock Agents está no modo de manutenção. A criação de novos agentes não está disponível para contas sem o uso prévio do serviço. Para saber mais, consulte o modo de manutenção do Amazon Bedrock Agents Classic.”

Eu preciso agir?

Não imediatamente. Suas cargas de trabalho existentes não são afetadas. No entanto, recomendamos avaliar o desenvolvimento AgentCore de novos agentes e futuras migrações, pois nenhum novo recurso será adicionado ao Bedrock Agents Classic.

Posso solicitar uma exceção aos Bedrock Agents em uma nova conta após 30 de julho?

Não. Não há processo de exceção. AWS determina automaticamente a lista de permissões com base no fato de sua conta ter tido atividade da Bedrock Agents nos últimos 12 meses. Se você precisar de recursos de agente em uma nova conta, use o Amazon Bedrock AgentCore, que oferece funcionalidade equivalente e expandida.

E quanto à mudança de nome para “Bedrock Agents Classic”?

Essa é apenas uma atualização de nomenclatura. Não é necessária nenhuma ação de sua parte. Os namespaces de API existentes (bedrock-agent), clientes SDK, tipos de CloudFormation recursos e prefixos de ação do IAM permanecem inalterados.

Meus modelos CloudFormation, CDK ou Terraform ainda funcionarão?

Sim. Os modelos IaC existentes que criam ou gerenciam agentes Bedrock continuarão funcionando para contas listadas como permitidas. Se você estiver provisionando novos ambientes em contas sem o uso prévio dos agentes Bedrock, use os AgentCore recursos do Amazon Bedrock em seus modelos.

As novas versões do modelo estarão disponíveis no Bedrock Agents Classic?

Não. O catálogo de modelos disponível no Bedrock Agents Classic está congelado na data de vigência do modo de manutenção (30 de julho de 2026). Novos modelos lançados após essa data estarão disponíveis em AgentCore. O próprio Amazon Bedrock (inferência de modelos, bases de conhecimento, guardrails) continua recebendo novos modelos. Essa restrição se aplica somente à camada de orquestração do Bedrock Agents Classic.

Os preços do Bedrock Agents Classic mudarão?

Não há cobrança pelo próprio Bedrock Agents Classic. Você continua pagando somente pela inferência do modelo subjacente e por quaisquer recursos associados (bases de conhecimento, invocações do Lambda etc.), como antes.

Migração

Qual é o caminho de migração recomendado?

AgentCore é a plataforma recomendada. Dois caminhos estão disponíveis:

  • AgentCore harness — Uma experiência baseada em configuração semelhante à Bedrock Agents Classic. Declare seu modelo, ferramentas e instruções; AgentCore lida com computação, memória, identidade e observabilidade. Esse é o análogo mais próximo da experiência gerenciada pela Bedrock Agents.

  • Code-defined agentes ativados AgentCore — Para cargas de trabalho que exigem orquestração avançada, colaboração de vários agentes ou lógica personalizada. Implemente qualquer estrutura (Strands LangChain, OpenAI Agents SDK, Claude Agent SDK ou personalizada) na AgentCore infraestrutura gerenciada.

Existe uma ferramenta de migração automatizada?

Sim. Uma habilidade de agente para orientá-lo na migração do Bedrock Agents Classic diretamente para o AgentCore harness está disponível no kit de ferramentas de agentes da AWS no site. GitHub A habilidade também está disponível por meio do servidor AWS MCP. Para obter instruções sobre como instalar e usar a habilidade, consulte o kit de ferramentas do agente para AWS README no GitHub site. Comece com a mensagem “Ajude-me a migrar meu Bedrock Agent para o AgentCore harness”.

Quanto tempo demora a migração?

Para agentes simples (modelo, grupos de ação e base de conhecimento), a importação da CLI ou a configuração do aproveitamento levam horas. O principal esforço envolve a revisão do código gerado ou a reimplantação de grupos de ação por trás do gateway. AgentCore Agentes complexos com orquestradores personalizados ou colaboração de vários agentes exigirão um trabalho de código mais significativo.

Existe um prazo para migrar?

Não há prazo de migração. O Bedrock Agents Classic permanece disponível para clientes existentes em modo de manutenção, sem data de fim de vida útil planejada. No entanto, como nenhum novo recurso está planejado, recomendamos migrar para ele AgentCore para se beneficiar da inovação contínua.

E quanto às minhas bases de conhecimento Bedrock?

As bases de conhecimento continuam funcionando e não são afetadas pelo modo de manutenção. Ao migrar para AgentCore, conecte-os por meio do AgentCore gateway. O recurso subjacente da Base de Conhecimento permanece inalterado.

E quanto aos meus guardrails Bedrock?

As grades de proteção configuradas no modelo Bedrock ainda se aplicam quando o modelo é invocado. AgentCore Agent-level a fiscalização do guardrail está disponível por meio de políticas de AgentCore gateway.

Ainda posso usar os mesmos modelos?

Sim AgentCore suporta o catálogo completo de modelos Bedrock, além de fornecedores adicionais (OpenAI, Gemini e qualquer OpenAI-compatible endpoint). Você pode alternar entre fornecedores de modelos no meio da sessão sem reimplantar.

E quanto à colaboração de vários agentes?

Você pode criar padrões de vários agentes em AgentCore tempo de execução usando qualquer estrutura compatível. O equipamento gerenciado suporta um padrão de agente como ferramenta para casos de uso mais simples de vários agentes.

E quanto aos agentes em linha?

As contas com InvokeInlineAgent uso nos últimos 12 meses podem continuar usando agentes em linha. Para novos desenvolvimentos, o equipamento AgentCore gerenciado fornece recursos equivalentes de agentes efêmeros com recursos adicionais (memória, sessões com estado, conectividade de ferramentas por meio de gateway). A orientação de migração para agentes em linha está disponível em breve.

Em quais regiões está AgentCore disponível?

AgentCore está disponível nessas regiões. Se suas cargas de trabalho do Bedrock Agents Classic são executadas em uma região que ainda não AgentCore está disponível, você pode continuar usando o Bedrock Agents Classic nessas regiões enquanto migra o novo desenvolvimento para uma AgentCore região com suporte.

Preços e suporte

Quanto AgentCore custa?

AgentCore usa preços baseados no consumo em todas as suas capacidades (tempo de execução, memória, gateway). Não há cobrança separada de orquestração de equipamentos. AgentCoreO equipamento da Bedrock Agents Classic é mais eficiente em termos de tokens do que os prompts internos do Bedrock Agents Classic, portanto, os clientes podem ver custos de inferência de modelos comparáveis ou menores. Consulte os AgentCore preços para obter detalhes.

Recursos adicionais do