View a markdown version of this page

Mode de maintenance classique d'Amazon Bedrock Agents - Amazon Bedrock
Plan de migrationComparaison des capacitésProcédure de migrationQuestions fréquentes (FAQ)Ressources supplémentaires

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Mode de maintenance classique d'Amazon Bedrock Agents

Amazon Bedrock Agents (lancé en novembre 2023) est désormais Amazon Bedrock Agents Classic et ne sera plus ouvert aux nouveaux clients à compter du 30 juillet 2026. Pour des fonctionnalités similaires à celles d'Amazon Bedrock Agents Classic, explorez Amazon AgentCore Bedrock. Amazon Bedrock est toujours disponible, mais le service Agents Classic sera en mode maintenance.

Ce guide fournit des informations sur les options de migration du mode de maintenance pour les clients d'Amazon Bedrock Agents Classic.

Note

Amazon Bedrock continue d'être entièrement pris en charge. Seul le service Amazon Bedrock Agents Classic n'est plus ouvert aux nouveaux clients depuis le 30 juillet 2026. Vos modèles, bases de connaissances et garde-corps Amazon Bedrock existants ne sont pas concernés.

Plan de migration

Nous vous recommandons de migrer vos charges de travail Amazon Bedrock Agents Classic vers Amazon Bedrock. AgentCore AgentCore est la plateforme qui permet de créer, de connecter et d'optimiser les agents d'IA. Le harnais géré AgentCore fournit un point de départ basé sur la configuration où les développeurs peuvent déclarer le modèle, les outils et les instructions de l'agent. AgentCore gère l'environnement, le calcul, la mémoire, l'identité et l'observabilité.

Le harnais des agents gérés AgentCore (recommandé)

Le harnais géré AgentCore fournit un point de départ basé sur la configuration où les constructeurs peuvent déclarer le modèle, les outils et les instructions de l'agent. AgentCore gère le calcul, l'environnement, la mémoire, l'identité et l'observabilité. Le harnais supporte :

  • Boucle d'orchestration gérée avec connectivité intégrée aux outils

  • Groupes d'actions exposés en tant qu'outils MCP via une AgentCore passerelle (API REST, fonctions Lambda ou code-level @tools)

  • Gateway-fronted intégration de la base de connaissances

  • Outils fonctionnels en ligne pour le retour du contrôle et les modèles homme-in-the-loop

  • Interprète de code pour l'exécution de code en mode sandbox

  • Short-term et mémoire à long terme avec des stratégies configurables

  • Mise en œuvre des garde-corps via une passerelle AgentCore

  • Suivi permanent de bout en bout de toutes les actions des agents

  • Configuration rapide du système pour le comportement général des agents

Code-defined agents sur AgentCore

Pour les charges de travail qui nécessitent des fonctionnalités allant au-delà du modèle déclaratif du harnais, les clients peuvent déployer des agents définis par code directement sur. AgentCore Ce chemin prend en charge :

  • Dérogations rapides à des étapes d'orchestration spécifiques

  • Multi-agent modèles de collaboration et de supervision

  • Logique d'orchestration personnalisée

  • Points de OpenAI-compatible terminaison plus larges

  • N'importe quel framework ( LangChainStrands, SDK OpenAI Agents, SDK Claude Agent ou personnalisé)

Code-defined les agents continuent de bénéficier AgentCore de l'infrastructure gérée de S tout en donnant aux développeurs un contrôle total sur la boucle des agents.

Utilisez le harnais sauf si vous avez une raison précise de posséder vous-même la boucle (par exemple, une base de code d'agent existante à migrer ou une orchestration avancée que le harnais n'exprime pas encore). Les clients peuvent également utiliser la AgentCore CLI pour importer des configurations Bedrock Agents Classic existantes comme point de départ pour l'un ou l'autre des chemins.

Comparaison des capacités

Bedrock Agents Classique AgentCore Équivalent
Boucle d'orchestration gérée Prête à l'emploi avec harnais AgentCore
Groupes d'actions définis via OpenAPI/schéma de fonction + exécuteur Lambda optionnel, appelé depuis l'agent géré Outils exposés via la AgentCore passerelle sous forme d'outils MCP encapsulant des API REST et des fonctions Lambda ou code-level @tools.
Association des bases de connaissances Bedrock directement sur la configuration de l'agent pour RAG Gateway-fronted intégration de la base de connaissances dans AgentCore. Base de connaissances accessible via un outil de récupération au niveau du code.
Interface utilisateur et API Trace qui présentent le prétraitement, l'orchestration, les appels de groupes d'action, les requêtes KB et les observations de bout en bout AgentCore fournit un suivi permanent de bout en bout de toutes les actions des agents.
Configuration de remplacement rapide à des étapes spécifiques (prétraitement, orchestration, génération de réponses KB, post-traitement) L'invite système sur le harnais (--system-prompt) couvre le comportement global de l'agent. Stage-specific les remplacements rapides (prétraitement, génération de réponses KB, post-traitement) ne sont pas directement répliqués. Pour obtenir un comportement équivalent, il faut combiner l'invite du système avec l'exécution de commandes et des scripts autogérés.
Built-in AMAZON.UserInput outil de redemande automatique à l'utilisateur et de sélection de paramètres pendant l'orchestration Outils fonctionnels intégrés dans le harnais. L'agent appelle l'outil, le harnais fait une pause et renvoie tool_use au code client, qui gère l'interaction de l'utilisateur et renvoie le résultat. Équivaut à un retour de contrôle. Nécessite une définition explicite de l'outil plutôt qu'une élicitation automatique.
Built-in AMAZON.CodeInterpreter groupe d'actions pour l'exécution de code en mode sandbox AgentCore interpréteur de code
Configuration de la session et de la mémoire sur l'agent (TTL inactif, types de mémoire, mémoire intersessions) AgentCore mémoire à court et à long terme (avec différentes stratégies de mémoire)
Garde-corps et politique d'agent attachés de manière déclarative à l'agent et appliqués lors de l'orchestration Configuration du garde-corps dans Bedrock, avec application de politiques sur la passerelle AgentCore
Multi-agent rôles de collaboration et routage (par exemple, agents de supervision et rôles d'orchestration) Limité. Le modèle de superviseur est possible en exposant les agents en tant qu'outils MCP (agent-as-tool). Le mode de routage multi-agent n'est pas simple aujourd'hui. La collaboration multi-agents complète nécessite un code framework personnalisé.
Orchestrateur personnalisé Pris en charge via le AgentCore runtime (déployez directement le code d'orchestration personnalisé). Non disponible avec harnais.
Retour du contrôle (l'agent fait une pause pour une entrée externe) Outils fonctionnels intégrés dans le harnais. L'agent fait une pause et renvoie tool_use au client.

Procédure de migration

Prérequis pour migrer vers AgentCore le harnais

  • Node.js 20+ et AgentCore CLI, ou Python 3.10+ avec boto3

  • AWS informations d'identification dans une région où le AgentCore harnais est disponible. Pour plus d'informations, consultez la section AWS Régions prises en charge pour AgentCore.

  • Rôle d'exécution IAM avec les autorisations requises

  • (Facultatif) La boîte à outils pour AWS disponible sur le GitHub site Web fournit des compétences spécialisées pour guider vos agents IA tout au long de la migration.

Migrez à l'aide de la boîte à outils des agents pour AWS (recommandé)

La boîte à outils des agents pour AWS sur le GitHub site Web inclut une amazon-bedrock compétence qui guide votre agent IA (ou votre assistant de codage) tout au long de la migration de bout en bout. Il inspecte votre agent Bedrock existant, vérifie l'éligibilité à la migration et associe chaque composant à son équivalent de AgentCore harnais. La compétence amène ensuite la AgentCore CLI à échafauder et à déployer le harnais. Il ne modifie jamais votre agent source.

Pour utiliser cette compétence :

  1. Installez la boîte à outils de l'agent pour AWS. Pour obtenir des instructions sur l'installation de la boîte à outils de l'agent et l'activation de cette compétence, consultez la boîte à outils de l'agent pour AWS README sur le GitHub site Web.

  2. Activez amazon-bedrock cette compétence pour votre agent.

  3. (Facultatif) Pour rationaliser l'accès à AWS, configurez le serveur AWS MCP. La compétence fonctionne également avec la AWS CLI et boto3.

  4. Installez la dernière version de la AgentCore CLI. La compétence utilise la AgentCore CLI pour échafauder et déployer le harnais.

  5. Demandez à votre agent « Aidez-moi à migrer mon agent Bedrock vers un AgentCore harnais ». Fournissez l'ID, le nom ou l'ARN de l'agent, ainsi que la AWS région et le profil lorsque la compétence le demande.

  6. Confirmez le compte, la région et l'agent source à chaque point de contrôle. La compétence présente un inventaire des composants, une évaluation de l'éligibilité et un plan de migration écrit. Il fait une pause pour obtenir votre approbation avant le déploiement.

Vous pouvez également utiliser cette compétence pour répondre à des questions sur la migration sans effectuer de migration. Si votre agent utilise une fonctionnalité pour laquelle aucun chemin de harnais n'a été validé, la compétence s'arrête et propose des alternatives.

Migrer manuellement

Si vous préférez migrer sans compétences, ou si votre agent n'est pas éligible au parcours axé sur les compétences, procédez comme suit pour créer le harnais à l'aide de la CLI. AgentCore Utilisez la dernière version de l' AgentCore interface de ligne de commande.

Étape 1 : Création et configuration

agentcore create --name my-research-agent

Si vous possédez déjà un agent Bedrock que vous souhaitez répliquer, passez en revue sa configuration (modèle, groupes d'actions, KB, remplacements rapides) et associez chacun au paramètre de harnais correspondant :

  • model — --model-id

  • action groups— Outils de passerelle

  • KBs— Passerelle ou outil de récupération

  • prompt — --system-prompt

Ajoutez des outils :

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

Pour connecter des groupes d'action existants via la passerelle :

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

Étape 2 : configurer le modèle et l'invite du système

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

Étape 3 : Déployer et invoquer

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

Remplacez le modèle sur n'importe quelle invocation sans redéployer :

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

Activée par défaut. Pour étendre la mémoire à des utilisateurs individuels, transmettez --actor-id :

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

Chaque acteur a une mémoire isolée. Long-term les stratégies portent sur les connaissances extraites par identifiant d'acteur.

Questions fréquentes (FAQ)

Impact

Mes agents actuels cesseront-ils de travailler ?

Non. Les agents existants continuent de fonctionner normalement. Toutes les API (UpdateAgent, GetAgent, ListAgents,, DeleteAgent, PrepareAgent, InvokeAgent, API de groupes d'actions, API de base de connaissances, API d'alias, etc.) restent disponibles pour tous les clients. Uniquement CreateAgent et InvokeInlineAgent sont réservés aux comptes sans utilisation préalable.

Comment savoir si mon compte est concerné ?

Si des agents Bedrock ont été actifs sur votre compte au cours des 12 derniers mois, cela signifie que vous êtes autorisé et que vous n'êtes pas concerné. Cela s'applique par compte. Si vous possédez plusieurs AWS comptes, seuls ceux qui ont déjà utilisé Bedrock Agents sont autorisés. Les comptes sans utilisation préalable recevront un message AccessDeniedException (HTTP 403) lorsqu'ils appellent CreateAgent ou InvokeInlineAgent.

Quelle erreur vais-je voir si mon compte n'est pas autorisé ?

Code d'erreur : AccessDeniedException (HTTP 403)

Message : « Bedrock Agents est en mode maintenance. La création de nouveaux agents n'est pas disponible pour les comptes sans utilisation préalable du service. Pour en savoir plus, consultez le mode de maintenance classique d'Amazon Bedrock Agents. »

Dois-je prendre des mesures ?

Pas tout de suite. Vos charges de travail existantes ne sont pas affectées. Cependant, nous vous recommandons de procéder à AgentCore une évaluation pour le développement de nouveaux agents et les migrations futures, car aucune nouvelle fonctionnalité ne sera ajoutée à Bedrock Agents Classic.

Puis-je demander une exception à Bedrock Agents pour un nouveau compte après le 30 juillet ?

Non. Il n'existe aucun processus d'exception. AWS détermine automatiquement la liste autorisée en fonction de l'activité de Bedrock Agents sur votre compte au cours des 12 derniers mois. Si vous avez besoin des fonctionnalités d'agent dans un nouveau compte, utilisez Amazon Bedrock AgentCore, qui propose des fonctionnalités équivalentes et étendues.

Qu'en est-il du changement de nom en « Bedrock Agents Classic » ?

Il s'agit uniquement d'une mise à jour de dénomination. Aucune action de votre part n'est nécessaire. Les espaces de noms d'API (bedrock-agent), les clients SDK, les types de CloudFormation ressources et les préfixes d'action IAM existants restent inchangés.

Mes modèles CloudFormation, CDK ou Terraform fonctionneront-ils toujours ?

Oui. Les modèles IaC existants qui créent ou gèrent des agents Bedrock continueront de fonctionner pour les comptes autorisés. Si vous configurez de nouveaux environnements dans des comptes qui n'ont jamais utilisé Bedrock Agents, utilisez plutôt les AgentCore ressources Amazon Bedrock dans vos modèles.

De nouvelles versions de modèles seront-elles disponibles dans Bedrock Agents Classic ?

Non. Le catalogue de modèles disponible dans Bedrock Agents Classic est gelé à la date d'entrée en vigueur du mode de maintenance (30 juillet 2026). Les nouveaux modèles sortis après cette date seront disponibles via AgentCore. Amazon Bedrock lui-même (inférence de modèles, bases de connaissances, garde-corps) continue de recevoir de nouveaux modèles. Cette restriction s'applique uniquement à la couche d'orchestration Bedrock Agents Classic.

Le prix de Bedrock Agents Classic va-t-il changer ?

Bedrock Agents Classic lui-même est gratuit. Vous continuez à payer uniquement pour l'inférence du modèle sous-jacent et toutes les ressources associées (bases de connaissances, invocations Lambda, etc.) comme auparavant.

Migration

Quel est le chemin de migration recommandé ?

AgentCore est la plateforme recommandée. Deux voies sont disponibles :

  • AgentCore harness — Une expérience basée sur la configuration similaire à Bedrock Agents Classic. Déclarez votre modèle, vos outils et vos instructions ; AgentCore gère le calcul, la mémoire, l'identité et l'observabilité. Il s'agit de l'analogue le plus proche de l'expérience gérée par Bedrock Agents.

  • Code-defined agents activés AgentCore  : pour les charges de travail nécessitant une orchestration avancée, une collaboration multi-agents ou une logique personnalisée. Déployez n'importe quel framework ( LangChainStrands, SDK OpenAI Agents, SDK Claude Agent ou personnalisé) sur AgentCore votre infrastructure gérée.

Existe-t-il un outil de migration automatique ?

Oui. Une compétence d'agent qui vous guidera dans la migration de Bedrock Agents Classic directement vers AgentCore Harness est disponible dans la boîte à outils des agents pour AWS sur le GitHub site Web. La compétence est également disponible via le serveur AWS MCP. Pour obtenir des instructions sur l'installation et l'utilisation de cette compétence, consultez la boîte à outils de l'agent pour AWS README sur le GitHub site Web. Commencez par le message « Aidez-moi à migrer mon Bedrock Agent vers AgentCore Harness ».

Combien de temps dure la migration ?

Pour les agents simples (modèle + groupes d'action + base de connaissances), l'importation de la CLI ou la configuration du harnais prennent des heures. L'effort principal consiste à revoir le code généré ou à redéployer des groupes d'action derrière la AgentCore passerelle. Les agents complexes dotés d'orchestrateurs personnalisés ou d'une collaboration multi-agents nécessiteront un travail de code plus important.

Y a-t-il une date limite pour effectuer la migration ?

Il n'y a pas de date limite de migration. Bedrock Agents Classic reste disponible pour les clients existants en mode maintenance sans date de fin de vie prévue. Cependant, étant donné qu'aucune nouvelle fonctionnalité n'est prévue, nous vous recommandons de migrer vers AgentCore pour bénéficier de l'innovation continue.

Qu'en est-il de mes bases de connaissances Bedrock ?

Les bases de connaissances continuent de fonctionner et ne sont pas affectées par le mode maintenance. Lors de la migration vers AgentCore, connectez-les via une AgentCore passerelle. La ressource de base de connaissances sous-jacente est inchangée.

Qu'en est-il de mes garde-corps Bedrock ?

Les garde-corps configurés sur le modèle Bedrock s'appliquent toujours lorsque le modèle est invoqué via. AgentCore Agent-level l'application des garde-fous est disponible via les politiques de AgentCore passerelle.

Puis-je toujours utiliser les mêmes modèles ?

Oui. AgentCore prend en charge le catalogue complet de modèles Bedrock ainsi que des fournisseurs supplémentaires (OpenAI, Gemini et n'importe quel OpenAI-compatible point de terminaison). Vous pouvez passer d'un fournisseur de modèles à un autre en cours de session sans avoir à effectuer de redéploiement.

Qu'en est-il de la collaboration multi-agents ?

Vous pouvez créer des modèles multi-agents lors de l' AgentCore exécution à l'aide de n'importe quel framework pris en charge. Le harnais géré prend en charge un modèle agent-outil pour des cas d'utilisation multi-agents plus simples.

Qu'en est-il des agents en ligne ?

Les comptes utilisés InvokeInlineAgent au cours des 12 derniers mois peuvent continuer à utiliser des agents en ligne. Pour les nouveaux développements, le harnais AgentCore géré fournit des fonctionnalités d'agent éphémère équivalentes avec des fonctionnalités supplémentaires (mémoire, sessions avec état, connectivité des outils via une passerelle). Des instructions de migration pour les agents en ligne sont à venir.

Dans quelles régions est-il AgentCore disponible ?

AgentCore est disponible dans ces régions. Si vos charges de travail Bedrock Agents Classic sont exécutées dans une région qui n' AgentCore est pas encore disponible, vous pouvez continuer à utiliser Bedrock Agents Classic dans ces régions tout en migrant les nouveaux développements vers une région prise AgentCore en charge.

Tarification et assistance

Combien ça AgentCore coûte ?

AgentCore applique une tarification basée sur la consommation pour l'ensemble de ses fonctionnalités (temps d'exécution, mémoire, passerelle). Il n'y a pas de frais d'orchestration du harnais distincts. AgentCoredu harnais est plus efficace en termes de jetons que les instructions internes de Bedrock Agents Classic, de sorte que les clients peuvent bénéficier de coûts d'inférence de modèles comparables ou inférieurs. Consultez les AgentCore tarifs pour plus de détails.

Ressources supplémentaires