View a markdown version of this page

Modalità di manutenzione Amazon Bedrock Agents Classic - Amazon Bedrock
Piano di migrazioneComparazione delle funzionalitàProcedura di migrazioneDomande frequentiRisorse aggiuntive

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Modalità di manutenzione Amazon Bedrock Agents Classic

Amazon Bedrock Agents (lanciato a novembre 2023) è ora Amazon Bedrock Agents Classic e non sarà più aperto a nuovi clienti a partire dal 30 luglio 2026. Per funzionalità simili a Amazon Bedrock Agents Classic, esplora Amazon AgentCore Bedrock. Amazon Bedrock continua a essere disponibile, ma il servizio Agents Classic sarà in modalità di manutenzione.

Questa guida fornisce informazioni sulle opzioni di migrazione in modalità manutenzione per i clienti di Amazon Bedrock Agents Classic.

Nota

Amazon Bedrock continua a essere completamente supportato. Solo il servizio Amazon Bedrock Agents Classic non è più aperto ai nuovi clienti a partire dal 30 luglio 2026. I tuoi modelli Amazon Bedrock, Knowledge Base e Guardrails esistenti non sono interessati.

Piano di migrazione

Ti consigliamo di migrare i carichi di lavoro Amazon Bedrock Agents Classic su Amazon Bedrock. AgentCore AgentCore è la piattaforma per creare, connettere e ottimizzare gli agenti AI. Il managed harness in AgentCore fornisce un punto di partenza basato sulla configurazione in cui gli sviluppatori possono dichiarare il modello, gli strumenti e le istruzioni dell'agente. AgentCore gestisce l'ambiente, l'elaborazione, la memoria, l'identità e l'osservabilità.

Il cablaggio dell'agente gestito (consigliato) AgentCore

Il managed harness in AgentCore fornisce un punto di partenza basato sulla configurazione in cui i builder possono dichiarare il modello, gli strumenti e le istruzioni dell'agente. AgentCore gestisce l'elaborazione, l'ambiente, la memoria, l'identità e l'osservabilità. L'imbracatura supporta:

  • Loop di orchestrazione gestito con connettività degli strumenti integrata

  • Gruppi di azioni esposti come strumenti MCP tramite AgentCore gateway (API REST, funzioni Lambda o code-level @tools)

  • Gateway-fronted integrazione della knowledge base

  • Strumenti funzionali in linea per il ritorno del controllo e gli schemi human-in-the-loop

  • Interprete di codice per l'esecuzione di codice in modalità sandbox

  • Short-term e memoria a lungo termine con strategie configurabili

  • Applicazione del guardrail tramite gateway AgentCore

  • Tracciamento persistente e completo di tutte le azioni degli agenti

  • Configurazione dei prompt di sistema per il comportamento generale dell'agente

Code-defined agenti attivi AgentCore

Per i carichi di lavoro che richiedono funzionalità che vanno oltre il modello dichiarativo dell'harness, i clienti possono implementare agenti definiti dal codice direttamente su. AgentCore Questo percorso supporta:

  • Sostituzioni tempestive in fasi di orchestrazione specifiche

  • Multi-agent modelli di collaborazione e supervisore

  • Logica di orchestrazione personalizzata

  • Endpoint più ampi OpenAI-compatible

  • Qualsiasi framework (Strands LangChain, OpenAI Agents SDK, Claude Agent SDK o personalizzato)

Code-defined gli agenti continuano a beneficiare AgentCore dell'infrastruttura gestita di questa piattaforma, offrendo allo stesso tempo agli sviluppatori il pieno controllo sul ciclo degli agenti.

Utilizzate l'harness a meno che non abbiate un motivo specifico per possedere personalmente il loop (ad esempio, una codebase di agenti esistente da migrare o un'orchestrazione avanzata che l'harness non è ancora in grado di esprimere). I clienti possono anche utilizzare la AgentCore CLI per importare le configurazioni esistenti di Bedrock Agents Classic come punto di partenza per entrambi i percorsi.

Comparazione delle funzionalità

Bedrock Agents Classic AgentCore Equivalente
Ciclo di orchestrazione gestito Supportato pronto all'uso con cablaggio AgentCore
Gruppi di azioni definiti tramite OpenAPI/function schema + executor Lambda opzionale, chiamato dall'agente gestito Strumenti esposti tramite AgentCore gateway come strumenti MCP che racchiudono API REST e funzioni Lambda o @tools a livello di codice.
Associazione delle Bedrock Knowledge Bases direttamente nella configurazione dell'agente per RAG Gateway-fronted integrazione della knowledge base in. AgentCore Base di conoscenza accessibile tramite uno strumento di recupero a livello di codice.
Interfaccia utente e API di Trace che mostrano la preelaborazione, l'orchestrazione, le chiamate ai gruppi di azione, le query KB e le osservazioni dall'inizio alla fine AgentCore fornisce il tracciamento persistente e completo di tutte le azioni degli agenti.
Prompt override la configurazione in fasi specifiche (preelaborazione, orchestrazione, generazione della risposta KB, post-elaborazione) System Prompt on harness (--system-prompt) descrive il comportamento generale dell'agente. Stage-specific Le sostituzioni dei prompt (pre-elaborazione, generazione di risposte KB, post-elaborazione) non vengono replicate direttamente. Per ottenere un comportamento equivalente è necessario combinare il prompt di sistema con l'esecuzione dei comandi e gli script autogestiti.
Built-in AMAZON.UserInput strumento per la ririchiesta automatica degli utenti e l'elicitazione dei parametri durante l'orchestrazione Strumenti funzionali in linea in dotazione. L'agente chiama lo strumento, harness mette in pausa e restituisce tool_use al codice client, che gestisce l'interazione dell'utente e restituisce il risultato. Equivalente a return-of-control. Richiede una definizione esplicita dello strumento anziché l'elicitazione automatica.
Built-in AMAZON.CodeInterpreter gruppo di azioni per l'esecuzione di codice in modalità sandbox AgentCore interprete di codice
Configurazione della sessione e della memoria sull'agente (TTL inattivo, tipi di memoria, memoria intersessione) AgentCore memoria a breve e lungo termine (con diverse strategie di memoria)
Guardrail e policy degli agenti allegati in modo dichiarativo all'agente e applicati durante l'orchestrazione Configurazione Guardrail in Bedrock, con applicazione delle policy sul gateway AgentCore
Multi-agent ruoli di collaborazione e routing (ad esempio, agenti supervisori e ruoli di orchestrazione) Limitato. Il modello di supervisore è possibile esponendo gli agenti come strumenti MCP (agent-as-tool). La modalità di routing multiagente non è semplice oggi. La collaborazione completa tra più agenti richiede un codice framework personalizzato.
Orchestrator personalizzato Supportato tramite AgentCore runtime (distribuisci direttamente il codice di orchestrazione personalizzato). Non disponibile tramite cablaggio.
Ripristino del controllo (l'agente si interrompe per l'input esterno) Strumenti funzionali in linea nell'imbracatura. L'agente fa una pausa, restituisce tool_use al client.

Procedura di migrazione

Prerequisiti per la migrazione a harness AgentCore

  • Node.js 20+ e AgentCore CLI o Python 3.10+ con boto3

  • AWS credenziali in una regione di anteprima (us-east-1, us-west-2, eu-central-1, ap-southeast-2)

  • Ruolo di esecuzione IAM con autorizzazioni richieste

Fase 1: Creare e configurare

agentcore create --name my-research-agent

Se disponi di un Bedrock Agent esistente che desideri replicare, rivedi la sua configurazione (modello, gruppi di azioni, KB, sostituzioni dei prompt) e mappali ciascuno al parametro di harness corrispondente:

  • model — --model-id

  • action groups— Strumenti Gateway

  • KBs— Gateway o strumento di recupero

  • prompt — --system-prompt

Aggiungi strumenti:

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

Per connettere i gruppi di azione esistenti tramite 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

Fase 2: Configurazione del modello e del prompt di 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

Fase 3: Implementazione e richiamo

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

Sostituisci il modello su qualsiasi chiamata senza ridistribuirlo:

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

Memoria

Abilitata come impostazione predefinita. Per assegnare la memoria ai singoli utenti, passa: --actor-id

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

Ogni attore riceve una memoria isolata. Long-term le strategie riguardano la conoscenza estratta in base all'ID dell'attore.

Importante

È in fase di sviluppo un'abilità da agente per guidarvi nella migrazione di Bedrock Agents Classic direttamente a AgentCore harness. Nel frattempo, l'approccio consigliato è la mappatura manuale descritta sopra.

Domande frequenti

Impatto

I miei agenti esistenti smetteranno di lavorare?

No. Gli agenti esistenti continuano a funzionare normalmente. Tutte le API (UpdateAgent,, GetAgent, ListAgents, DeleteAgent, PrepareAgent InvokeAgent, API per gruppi di azioni, API di knowledge base, API alias, ecc.) rimangono disponibili per tutti i clienti. Solo CreateAgent e InvokeInlineAgent sono limitate agli account senza utilizzo precedente.

Come faccio a sapere se il mio account è interessato?

Se il tuo account ha registrato attività da Bedrock Agents negli ultimi 12 mesi, sei nella lista dei soci autorizzati e non ne risentono. Questo vale per ogni account. Se disponi di più AWS account, sono consentiti solo quelli con un precedente utilizzo di Bedrock Agents. Gli account che non sono stati utilizzati in precedenza riceveranno un messaggio AccessDeniedException (HTTP 403) quando chiamano o. CreateAgent InvokeInlineAgent

Che errore vedrò se il mio account non è nella lista consentita?

Codice di errore: AccessDeniedException (HTTP 403)

Messaggio: «Bedrock Agents è in modalità manutenzione. La creazione di nuovi agenti non è disponibile per gli account senza un precedente utilizzo del servizio. Per ulteriori informazioni, consulta la modalità di manutenzione di Amazon Bedrock Agents Classic».

Devo agire?

Non immediatamente. I tuoi carichi di lavoro esistenti non sono influenzati. Tuttavia, consigliamo di valutare lo sviluppo AgentCore di nuovi agenti e le future migrazioni, poiché non verranno aggiunte nuove funzionalità a Bedrock Agents Classic.

Posso richiedere un'eccezione a Bedrock Agents in un nuovo account dopo il 30 luglio?

No. Non esiste un processo di eccezione. AWS determina automaticamente l'elenco delle autorizzazioni in base al fatto che il tuo account abbia avuto attività con Bedrock Agents negli ultimi 12 mesi. Se hai bisogno di funzionalità di agente in un nuovo account, usa Amazon Bedrock AgentCore, che offre funzionalità equivalenti ed estese.

Che ne dici del cambio di nome in «Bedrock Agents Classic»?

Si tratta solo di un aggiornamento del nome. Non è richiesta nessuna azione da parte tua. I namespace delle API esistenti (bedrock-agent), i client SDK, i tipi di CloudFormation risorse e i prefissi di azione IAM rimangono invariati.

I miei modelli, CDK o Terraform funzioneranno ancora? CloudFormation

Sì. I modelli IaC esistenti che creano o gestiscono Bedrock Agents continueranno a funzionare per gli account consentiti. Se stai effettuando il provisioning di nuovi ambienti in account senza l'utilizzo precedente di Bedrock Agents, utilizza invece AgentCore le risorse di Amazon Bedrock nei tuoi modelli.

Le nuove versioni del modello saranno disponibili in Bedrock Agents Classic?

No. Il catalogo dei modelli disponibile in Bedrock Agents Classic è bloccato a partire dalla data di entrata in vigore della modalità di manutenzione (30 luglio 2026). I nuovi modelli rilasciati dopo tale data saranno disponibili tramite. AgentCore La stessa Amazon Bedrock (inferenza dei modelli, Knowledge Bases, Guardrails) continua a ricevere nuovi modelli. Questa restrizione si applica solo al livello di orchestrazione di Bedrock Agents Classic.

I prezzi di Bedrock Agents Classic cambieranno?

Bedrock Agents Classic stesso è gratuito. Continui a pagare solo per l'inferenza del modello sottostante e tutte le risorse associate (Knowledge Base, invocazioni Lambda, ecc.) come in precedenza.

Migrazione

Qual è il percorso di migrazione consigliato?

AgentCore è la piattaforma consigliata. Sono disponibili due percorsi:

  • AgentCore harness: un'esperienza basata sulla configurazione simile a Bedrock Agents Classic. Dichiara il tuo modello, gli strumenti e le istruzioni; AgentCore gestisce il calcolo, la memoria, l'identità e l'osservabilità. Questa è l'analogia più simile all'esperienza gestita da Bedrock Agents.

  • Code-defined agent on AgentCore: per carichi di lavoro che richiedono orchestrazione avanzata, collaborazione tra più agenti o logica personalizzata. Implementa qualsiasi framework (Strands, LangChain OpenAI Agents SDK, Claude Agent SDK o personalizzato) sulla nostra infrastruttura gestita. AgentCore

Esiste uno strumento di migrazione automatizzato?

È in fase di sviluppo un'abilità da parte degli agenti per guidarvi nella migrazione di Bedrock Agents Classic direttamente su AgentCore harness. Nel frattempo, utilizzate la mappatura manuale nella precedente sezione Procedura di migrazione.

Quanto dura la migrazione?

Per gli agenti semplici (modello, gruppi di azione e knowledge base), l'importazione della CLI o la configurazione del cablaggio richiedono ore. Lo sforzo principale consiste nella revisione del codice generato o nella ridistribuzione dei gruppi di azione dietro il gateway. AgentCore Gli agenti complessi con orchestratori personalizzati o la collaborazione tra più agenti richiederanno un lavoro di codice più significativo.

C'è una scadenza per la migrazione?

Non esiste una scadenza per la migrazione. Bedrock Agents Classic rimane disponibile per i clienti esistenti in modalità di manutenzione senza una data di fine del ciclo di vita pianificata. Tuttavia, poiché non sono previste nuove funzionalità, consigliamo di migrare AgentCore a per beneficiare dell'innovazione continua.

Che mi dici delle mie Bedrock Knowledge Base?

Le Knowledge Base continuano a funzionare e non sono influenzate dalla modalità di manutenzione. Quando esegui la migrazione a AgentCore, connettili tramite AgentCore gateway. La risorsa sottostante della Knowledge Base è rimasta invariata.

E i miei Bedrock Guardrails?

I guardrail configurati sul modello Bedrock si applicano ancora quando il modello viene richiamato tramite. AgentCore Agent-level L'applicazione del guardrail è disponibile tramite le policy del gateway. AgentCore

Posso usare ancora gli stessi modelli?

Sì. AgentCore supporta l'intero catalogo di modelli Bedrock oltre a provider aggiuntivi (OpenAI, Gemini e OpenAI-compatible qualsiasi endpoint). È possibile passare da un fornitore di modelli all'altro a metà sessione senza ridistribuirlo.

Che dire della collaborazione tra più agenti?

È possibile creare modelli multiagente in AgentCore fase di esecuzione utilizzando qualsiasi framework supportato. L'harness gestito supporta un modello agent-as-tool per casi d'uso multiagente più semplici.

Che dire degli agenti in linea?

Gli account InvokeInlineAgent utilizzati negli ultimi 12 mesi possono continuare a utilizzare agenti in linea. Per i nuovi sviluppi, l'harness AgentCore gestito offre funzionalità temporanee equivalenti agli agenti con funzionalità aggiuntive (memoria, sessioni con stato, connettività degli strumenti tramite gateway). Le linee guida sulla migrazione per gli agenti in linea sono disponibili a breve.

In quali regioni è disponibile? AgentCore

AgentCore è disponibile in queste regioni. Se i carichi di lavoro di Bedrock Agents Classic vengono eseguiti in una regione in cui non AgentCore è ancora disponibile, puoi continuare a utilizzare Bedrock Agents Classic in quelle regioni durante la migrazione del nuovo sviluppo verso AgentCore una regione supportata.

Prezzi e supporto

Quanto AgentCore costa?

AgentCore utilizza prezzi basati sul consumo in tutte le sue funzionalità (runtime, memoria, gateway). Non è previsto alcun costo separato per l'orchestrazione del cablaggio. AgentCoreè più efficiente dal punto di vista dei token rispetto ai prompt interni di Bedrock Agents Classic, quindi i clienti possono riscontrare costi di inferenza del modello comparabili o inferiori. Consulta i prezzi per i dettagli. AgentCore

Risorse aggiuntive