View a markdown version of this page

Amazon Bedrock Agents: modalità di manutenzione classica - Amazon Bedrock
Piano di migrazioneConfronto 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à.

Amazon Bedrock Agents: modalità di manutenzione classica

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 Bedrock. AgentCore Amazon Bedrock continua a essere disponibile, ma il servizio Agents Classic sarà in modalità manutenzione.

Questa guida fornisce informazioni sulle opzioni di migrazione in modalità di 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 modelli Amazon Bedrock, le Knowledge Base e i Guardrail esistenti non sono interessati.

Piano di migrazione

Ti consigliamo di migrare i tuoi carichi di lavoro Amazon Bedrock Agents Classic su Amazon Bedrock. AgentCore AgentCore è la piattaforma per creare, connettere e ottimizzare gli agenti di intelligenza artificiale. L'harness in gestito 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à.

L'agente gestito Harness in AgentCore (consigliato)

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

  • Ciclo 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 base di conoscenza

  • Strumenti funzionali in linea per il ritorno del controllo e i modelli «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 immediata del 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 automatiche in fasi di orchestrazione specifiche

  • Multi-agent modelli di collaborazione e supervisione

  • 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 dell'infrastruttura gestita AgentCore dell'azienda, 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 base di codice 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.

Confronto delle funzionalità

Bedrock Agents Classic AgentCore Equivalente
Ciclo di orchestrazione gestito Supportato immediatamente con imbracatura AgentCore
Gruppi di azioni definiti tramite OpenAPI/schema di funzioni + esecutore Lambda opzionale, richiamati 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 Knowledge Base di Bedrock 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 pre-elaborazione, l'orchestrazione, le chiamate ai gruppi di azione, le query KB e le osservazioni end-to-end AgentCore fornisce una traccia persistente e completa di tutte le azioni degli agenti.
Configurazione rapida e sostituibile in fasi specifiche (pre-elaborazione, orchestrazione, generazione di risposte KB, post-elaborazione) Il prompt di sistema su harness (--system-prompt) descrive il comportamento generale dell'agente. Stage-specific le sostituzioni dei prompt (preelaborazione, generazione di risposte in 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 riattivazione automatica degli utenti e l'elicitazione dei parametri durante l'orchestrazione Strumenti funzionali in linea integrati. L'agente chiama lo strumento, Harness fa una pausa e restituisce tool_use al codice client, che gestisce l'interazione dell'utente e restituisce il risultato. Equivalente al ritorno del controllo. 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 tra sessioni) 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 multiagente completa richiede un codice di framework personalizzato.
Orchestrator personalizzato Supportato tramite AgentCore runtime (implementa direttamente il codice di orchestrazione personalizzato). Non disponibile tramite harness.
Ritorno del controllo (l'agente si ferma per l'input esterno) Strumenti funzionali in linea integrati 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 in cui è disponibile Harness. AgentCore Per ulteriori informazioni, consulta AWS Regioni supportate per. AgentCore

  • Ruolo di esecuzione IAM con le autorizzazioni richieste

  • (Facoltativo) Il toolkit per agenti per AWS sul GitHub sito Web fornisce competenze specialistiche per guidare gli agenti AI durante la migrazione.

Esegui la migrazione con il toolkit per agenti per AWS (consigliato)

Il toolkit per agenti per AWS sul GitHub sito Web include un'amazon-bedrockabilità che guida il tuo agente AI (o assistente di codifica) attraverso la migrazione end-to-end. Ispeziona il tuo agente Bedrock esistente, verifica l'idoneità alla migrazione e associa ogni componente al suo equivalente di cablaggio. AgentCore L'abilità spinge quindi la AgentCore CLI all'impalcatura e all'implementazione del cablaggio. Non modifica mai il tuo agente sorgente.

Per usare l'abilità:

  1. Installa il toolkit per agenti per AWS. Per istruzioni sull'installazione del toolkit per agenti e sull'attivazione della skill, consulta il toolkit per agenti per AWS README sul sito Web. GitHub

  2. Abilita l'amazon-bedrockabilità per il tuo agente.

  3. (Facoltativo) Per un accesso semplificato ad AWS, configura il server AWS MCP. L'abilità funziona anche con la AWS CLI e boto3.

  4. Installa l'ultima versione della CLI. AgentCore L'abilità utilizza la AgentCore CLI per impalcare e implementare il cablaggio.

  5. Chiedi al tuo agente di dire «Aiutami a migrare il mio Bedrock Agent verso Harness». AgentCore Fornisci l'ID, il nome o l'ARN dell'agente, insieme alla AWS regione e al profilo quando richiesto dall'abilità.

  6. Conferma l'account, la regione e l'agente di origine ad ogni checkpoint. La competenza presenta un inventario dei componenti, una valutazione dell'idoneità e un piano di migrazione scritto. Si interrompe per la tua approvazione prima della distribuzione.

Puoi anche utilizzare l'abilità per rispondere alle domande sulla migrazione senza eseguire una migrazione. Se il tuo agente utilizza una funzionalità senza un percorso di cablaggio convalidato, la skill si interrompe e suggerisce delle alternative.

Esegui la migrazione manualmente

Se preferisci eseguire la migrazione senza competenze o se il tuo agente non è idoneo per il percorso basato sulle competenze, segui questi passaggi per creare il cablaggio con la CLI. AgentCore Usa l'ultima versione della AgentCore CLI.

Fase 1: Creare e configurare

agentcore create --name my-research-agent

Se disponi di un Bedrock Agent esistente da replicare, esaminane la configurazione (modello, gruppi di azioni, KB, sostituzioni dei prompt) e associa ciascuno al parametro di cablaggio 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 azioni 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: distribuzione 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 a 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 ambito delle strategie, conoscenza estratta in base all'ID dell'attore.

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 di action group, API della knowledge base, API alias, ecc.) rimangono disponibili per tutti i clienti. Esclusivamente CreateAgent e InvokeInlineAgent sono limitate agli account che non sono stati utilizzati in precedenza.

Come faccio a sapere se il mio account è interessato?

Se il tuo account ha registrato un'attività di Bedrock Agents negli ultimi 12 mesi, sei autorizzato e non sei interessato. Questo vale per ogni account. Se disponi di più AWS account, sono consentiti solo quelli con un precedente utilizzo di Bedrock Agents. Gli account senza utilizzo precedente riceveranno un messaggio AccessDeniedException (HTTP 403) quando si chiama o. CreateAgent InvokeInlineAgent

Quale errore vedrò se il mio account non è nella lista degli utenti autorizzati?

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 Amazon Bedrock Agents Classic».

Devo agire?

Non immediatamente. I carichi di lavoro esistenti non sono influenzati. Tuttavia, consigliamo di valutare lo sviluppo AgentCore di nuovi agenti e le migrazioni future, 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 la lista consentita in base all'eventuale attività di Bedrock Agents sul tuo account negli ultimi 12 mesi. Se hai bisogno delle funzionalità degli agenti in un nuovo account, utilizza Amazon Bedrock AgentCore, che offre funzionalità equivalenti ed estese.

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

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

I miei modelli, CDK o Terraform funzioneranno ancora? CloudFormation

Sì. I modelli IaC esistenti che creano o gestiscono gli agenti Bedrock continueranno a funzionare per gli account consentiti. Se esegui il provisioning di nuovi ambienti in account senza l'utilizzo precedente di Bedrock Agents, utilizza invece le risorse di Amazon Bedrock AgentCore 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 Base, 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. Continuate a pagare solo per l'inferenza del modello sottostante e per 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à. Questo è l'analogo più vicino all'esperienza gestita da Bedrock Agents.

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

Esiste uno strumento di migrazione automatizzato?

Sì. Nel toolkit per agenti per AWS sul sito Web è disponibile una guida per la migrazione diretta di Bedrock Agents Classic a AgentCore Harness. GitHub La competenza è disponibile anche tramite il server MCP. AWS Per istruzioni sull'installazione e l'utilizzo della skill, consulta il toolkit dell'agente per AWS README sul sito Web. GitHub Inizia con il prompt «Aiutami a migrare il mio Bedrock Agent su Harness». AgentCore

Quanto dura la migrazione?

Per gli agenti semplici (modello + gruppi di azione + knowledge base), l'importazione della CLI o la configurazione del cablaggio richiedono ore. Lo sforzo principale prevede la revisione del codice generato o la 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 vita pianificata. Tuttavia, poiché non sono previste nuove funzionalità, consigliamo di eseguire la migrazione a per AgentCore beneficiare dell'innovazione continua.

Che mi dite delle mie Bedrock Knowledge Base?

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

E i miei Bedrock Guardrails?

I guardrail configurati sul modello Bedrock sono ancora validi quando il modello viene richiamato tramite. AgentCore Agent-level L'applicazione dei guardrail è disponibile tramite le politiche del gateway. AgentCore

Posso continuare a usare gli stessi modelli?

Sì AgentCore supporta il catalogo completo dei modelli Bedrock più provider aggiuntivi (OpenAI, Gemini e qualsiasi OpenAI-compatible endpoint). È possibile passare da un fornitore di modelli all'altro a metà sessione senza dover ridistribuire.

Che dire della collaborazione tra più agenti?

È possibile creare pattern 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 con un InvokeInlineAgent utilizzo negli ultimi 12 mesi possono continuare a utilizzare gli agenti in linea. Per i nuovi sviluppi, l'harness AgentCore gestito offre funzionalità equivalenti agli agenti temporanei con funzionalità aggiuntive (memoria, sessioni stateful, connettività degli strumenti tramite gateway). Sono disponibili linee guida sulla migrazione per gli agenti in linea.

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 mentre esegui la migrazione del nuovo sviluppo AgentCore in una regione supportata.

Prezzi e supporto

Quanto AgentCore costa?

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

Risorse aggiuntive