Agents e AgentCore: agents de IA em produção
- ⬜🔧 Tool use: dando ferramentas ao modelo (function calling)(AWS Bedrock — GenAI em Produção)
- ⬜📚 Knowledge Bases: RAG gerenciado de ponta a ponta(AWS Bedrock — GenAI em Produção)
Recomendamos completar os pré-requisitos antes de seguir, mas nada te impede de continuar.
Se você vai colocar um agent de IA em produção na AWS em meados de 2026, a primeira coisa a saber não é técnica — é de calendário. O Bedrock Agents que você viu em tutoriais desde 2023 foi renomeado para Amazon Bedrock Agents Classic e colocado em maintenance mode. A partir de 30 de julho de 2026 ele para de aceitar novos clientes. O caminho atual, para o qual a própria AWS te empurra, é o Amazon Bedrock AgentCore. Este módulo ensina o AgentCore como o presente e o Classic como o legado que você só toca se já herdou.
Agents Classic fecha para novos clientes em 30/jul/2026
O Bedrock Agents original (nov/2023) virou 'Amazon Bedrock Agents Classic' e entrou em maintenance mode. A partir de 30/jul/2026 ele NÃO aceita novos clientes: contas COM atividade de Agents nos últimos 12 meses ficam allowlisted e seguem funcionando normalmente; contas SEM uso prévio recebem AccessDeniedException (HTTP 403) ao chamar CreateAgent ou InvokeInlineAgent. O catálogo de modelos do Classic está congelado e não recebe novas features. Importante: Knowledge Bases, Guardrails e os modelos do Bedrock NÃO são afetados — só a camada de orquestração de agents.
# Conta SEM atividade de Agents nos ultimos 12 meses, apos 30/jul/2026:
$ aws bedrock-agent create-agent \
--agent-name meu-agent \
--foundation-model anthropic.claude-3-5-sonnet-20240620-v1:0
An error occurred (AccessDeniedException) when calling the CreateAgent
operation: Amazon Bedrock Agents (Classic) is in maintenance mode and
closed to new customers. Use Amazon Bedrock AgentCore instead.
# Conta allowlisted (usou Agents nos ultimos 12 meses): o mesmo comando
# continua funcionando normalmente. So nao ha modelos/features novos.Agents Classic: o legado que ainda roda
Antes de enterrar o Classic, vale entender o que ele fazia — porque muito do vocabulário sobrevive no AgentCore. No modelo Classic, um agent é um FM + instruções em linguagem natural + orquestração gerenciada pela AWS. Você não escreve o loop; o Bedrock roda um ciclo estilo ReAct (raciocina, escolhe uma ferramenta, observa o resultado, repete) até resolver a tarefa.
- Action groups: as ferramentas do agent, definidas por OpenAPI schema OU function schema, executadas por uma Lambda ou via return-of-control (o agent devolve o controle para o seu código executar a ação).
- Orchestration loop: ciclo gerenciado estilo ReAct — o agent decide quando chamar cada action group até concluir a tarefa.
- Memory: sessão (dentro de uma conversa) e cross-session (persistente entre conversas).
- Trace: passo a passo do raciocínio do agent, para debugar por que ele escolheu cada ação.
- Built-ins: AMAZON.UserInput (pedir esclarecimento ao usuário) e AMAZON.CodeInterpreter (executar código gerado).
- Multi-agent collaboration: um agent supervisor que roteia sub-tarefas para agents especializados.
O que NÃO muda
O maintenance mode atinge só a camada de orquestração de agents do Classic. Knowledge Bases (RAG gerenciado), Guardrails (segurança/moderação) e todos os foundation models do Bedrock continuam recebendo modelos e features normalmente. Se seu app usa Converse + Knowledge Bases sem Agents, nada muda para você.
Amazon Bedrock AgentCore: o caminho atual
O AgentCore não é 'Agents v2' com as mesmas amarras. É uma plataforma para construir, deployar e operar agents em produção com QUALQUER framework, modelo ou protocolo. Em vez de um agent monolítico gerenciado, você recebe serviços composáveis: pega só o que precisa (por exemplo, só o Runtime, ou só o Gateway) e ignora o resto. A cobrança é consumption-based, sem upfront.
# O AgentCore Runtime hospeda um agent de QUALQUER framework.
# Exemplo minimo com o Strands Agents SDK (open-source da AWS):
from strands import Agent
from bedrock_agentcore.runtime import BedrockAgentCoreApp
app = BedrockAgentCoreApp()
agent = Agent(model="anthropic.claude-3-5-sonnet-20240620-v1:0")
@app.entrypoint
def handler(payload):
# payload["prompt"] chega da invocacao. O Runtime cuida de
# compute, sessao isolada, memory e observability para voce.
return agent(payload["prompt"])
if __name__ == "__main__":
app.run() # empacota e roda o agent no AgentCore Runtime| Dimensão | Agents Classic | AgentCore |
|---|---|---|
| Modelo de construção | FM + instruções + action groups gerenciados | Qualquer framework/modelo/protocolo sobre infra gerenciada |
| Catálogo de modelos | Congelado (sem modelos novos) | Aberto — qualquer modelo, dentro ou fora do Bedrock |
| Features novas | Nenhuma (maintenance mode) | Em evolução ativa |
| Orquestração | Loop ReAct gerenciado e fechado | Managed harness OU seu próprio loop (code-defined) |
| Novos clientes | Bloqueado a partir de 30/jul/2026 (allowlist) | Aberto — GA desde 13/out/2025 |
| Recomendação AWS | Legado — migrar | Caminho atual para produção |
Os sete componentes do AgentCore
O AgentCore é a soma de sete serviços. Você pode adotar um agent inteiro por ele ou plugar um único componente num agent que já existe. Vale decorar o que cada um resolve:
- Executar
- Conectar
- Lembrar & observar
| Componente | O que resolve | Detalhe |
|---|---|---|
| Runtime | Executa o agent com sessão longa e isolada | Serverless; janela de execução até 8h; isolamento completo de sessão; suporte a A2A |
| Gateway | Transforma REST APIs e Lambda em MCP tools | Endpoint único; IAM + OAuth; conecta a MCP servers existentes; expõe KBs e aplica Guardrails |
| Memory | Memória curta e longa gerenciada | Estratégias configuráveis; isolamento por actor-id (memória por usuário) |
| Identity | Agir em nome do usuário | OAuth nativo; vault de refresh tokens; autorização identity-aware |
| Observability | Enxergar o que o agent faz | Dashboards no CloudWatch + OpenTelemetry → Datadog, Dynatrace, LangSmith, Langfuse, Arize Phoenix |
| Code Interpreter | Roda código gerado com segurança | Sandbox isolado e gerenciado |
| Browser | Agent navega a web headless | Preenche forms, clica, parseia conteúdo dinâmico; live view para intervenção humana |
- → cada passo do laço é uma inferência
- → ferramentas chegam por protocolo, não por código de cola
- → contexto que sobrevive entre sessões
- → autoridade de quem pediu
- Fora da AWS
- IA e machine learning
- Gestão e governança
Repare que o Runtime é só a caixa onde o laço roda. O que transforma um script em agent operável são as caixas em volta: memória isolada por ator, ferramentas expostas por protocolo, identidade delegada e trajetória observável.
- O laço roda no Runtime. Sessão longa e isolada, sem você operar container. É o que resolve o teto de execução de uma função serverless.
- Ferramentas por protocolo. O Gateway transforma API REST e função existente em ferramenta consumível pelo agent — sem escrever integração para cada uma.
- Memória e identidade. Memória isolada por ator é o que permite lembrar entre sessões sem misturar usuários. Identidade delegada é o que impede o agent de virar caminho de escalonamento de privilégio.
- Capacidades extras e observação. Sandbox de código e navegador headless quando a tarefa pede. E observabilidade de trajetória, que é o único jeito de depurar um laço que decide sozinho.
- A permissão que vale é a de quem chamou. Identity delega a identidade do usuário para o Gateway, e é isso que faz o agent alcançar exatamente o que aquele usuário alcançaria. Dar ao Runtime uma role ampla resolve o desenvolvimento e cria o caminho de escalonamento: qualquer instrução que o modelo aceite passa a valer com a permissão do serviço, não com a de quem pediu.
Frameworks e protocolos suportados
A grande virada do AgentCore é não te obrigar a um framework. Você traz o seu; ele opera a infra. Os suportados hoje incluem:
- Strands Agents SDK — open-source da própria AWS, usado internamente em Amazon Q Developer e AWS Glue.
- LangGraph, CrewAI e LlamaIndex.
- OpenAI Agents SDK, Google ADK e Microsoft Autogen.
- Claude Agent SDK.
- Ou seu próprio agent custom — o AgentCore não te prende a um framework.
MCP e A2A: os protocolos que evitam lock-in
O AgentCore fala dois protocolos abertos. MCP (Model Context Protocol) padroniza como o agent descobre e chama ferramentas — é o que o Gateway usa para expor suas APIs. A2A (Agent2Agent) padroniza a comunicação entre agents diferentes, possivelmente de fornecedores diferentes. Falar protocolo aberto é o que permite trocar de framework ou plugar agents de terceiros sem reescrever tudo.
Dois caminhos para construir
Ao adotar o AgentCore você escolhe quanto controle quer sobre a orquestração. Há dois caminhos, e eles não são exclusivos — dá para começar no harness e migrar para código depois.
O que muda no Amazon Bedrock Agents (Classic) a partir de 30 de julho de 2026?
Qual é a função do AgentCore Gateway?
Você precisa que cada usuário tenha sua própria memória de longo prazo, sem vazar contexto entre usuários. Qual componente do AgentCore resolve isso?
O time pergunta se as Knowledge Bases e os Guardrails vão parar com o maintenance mode do Classic. Qual é a resposta correta?
Custo: o que o AgentCore cobra além dos tokens
Um erro comum ao migrar é orçar só os tokens do modelo. O AgentCore é consumption-based e cobra por cima dos tokens — pelos serviços que você usa.
Custo: além dos tokens do modelo
O AgentCore cobra à parte: Runtime (por vCPU-hora + GB-hora, contando só CPU ativa — o tempo esperando o LLM ou uma tool não é cobrado), Memory, Gateway e Web Search (na ordem de US$7 por 1.000 queries). Os drivers dominantes tendem a ser a duração do Runtime e a long-term Memory. Para números exatos, consulte a página de pricing do AgentCore — os valores mudam por região e ao longo do tempo.
Próximo passo
Agents em produção precisam de trilhos de segurança: filtrar conteúdo tóxico, bloquear PII, impedir que o modelo fuja do escopo. Nada disso entra em maintenance mode — é o próximo módulo: Guardrails: segurança e responsible AI.
Perguntas frequentes
❓ Bedrock Agents ainda é o caminho recomendado?
❓ Agent gerenciado ou laço escrito por mim?
❓ Como depurar um agente que decide errado?
Terminou de ler?
Marcar como concluído registra o XP, mantém sua sequência e coloca 4 cartas deste módulo na fila de revisão espaçada.
Próximos passos sugeridos
Temas deste módulo
Discussão
Carregando comentários…