Déployez et intégrez un agent Amazon Bedrock dans votre application

Pour déployer votre agent

1. Créez un alias et une version de votre agent. Choisissez l'onglet correspondant à votre méthode préférée, puis suivez les étapes suivantes :

   Console

   Pour créer un alias (et éventuellement une nouvelle version)

   1. Connectez-vous à l' AWS Management Console aide d'un rôle IAM avec les autorisations Amazon Bedrock et ouvrez la console Amazon Bedrock à l'adresse. https://console.aws.amazon.com/bedrock/

   2. Sélectionnez Agents dans le volet de navigation de gauche. Choisissez ensuite un agent dans la section Agents.

   3. Dans la section Alias, choisissez Create.

   4. Entrez un nom d'alias unique et fournissez une description facultative.

   5. Sous Associer une version, choisissez l'une des options suivantes :

      • Pour créer une nouvelle version, choisissez Créer une nouvelle version et associez-la à cet alias.

      • Pour utiliser une version existante, choisissez Utiliser une version existante pour associer cet alias. Dans le menu déroulant, choisissez la version à laquelle vous souhaitez associer l'alias.

   6. Sous Sélectionner le débit, sélectionnez l'une des options suivantes :

      • Pour permettre à votre agent d'exécuter l'inférence de modèles aux taux définis pour votre compte, sélectionnez On-Demand (ODT). Pour de plus amples informations, veuillez consulter Quotas pour Amazon Bedrock.

      • Pour permettre à votre agent d'exécuter l'inférence de modèles à un rythme accru à l'aide d'un débit provisionné que vous avez précédemment acheté pour le modèle, sélectionnez Débit provisionné (PT), puis sélectionnez un modèle provisionné. Pour de plus amples informations, veuillez consulter Augmentez la capacité d'invocation des modèles grâce au débit provisionné dans Amazon Bedrock.

   7. Sélectionnez Créer un alias.

   API

   Pour créer un alias pour un agent, envoyez une CreateAgentAliasdemande avec un point de terminaison Agents for Amazon Bedrock Build-time.

   Les champs suivants sont obligatoires :

   Champ	Cas d’utilisation
   agentId	Pour spécifier l'ID de l'agent pour lequel créer un alias.
   agentName	Pour spécifier le nom de l'alias.

   Les champs suivants sont facultatifs :

   Champ	Cas d’utilisation
   description	Pour fournir une description de l'alias.
   Configuration du routage	Pour spécifier une version à laquelle associer l'alias (laissez ce champ vide pour créer une nouvelle version) et un débit provisionné à associer à l'alias.
   clientToken	Pour garantir que la demande d'API ne soit terminée qu'une seule fois. Pour plus d'informations, consultez la section Garantir l'idempuissance.
   balises	Pour associer des balises à l'alias.

   Voir des exemples de code

   anchoranchor
   • Console
   • API

   Pour créer un alias (et éventuellement une nouvelle version)

   1. Connectez-vous à l' AWS Management Console aide d'un rôle IAM avec les autorisations Amazon Bedrock et ouvrez la console Amazon Bedrock à l'adresse. https://console.aws.amazon.com/bedrock/

   2. Sélectionnez Agents dans le volet de navigation de gauche. Choisissez ensuite un agent dans la section Agents.

   3. Dans la section Alias, choisissez Create.

   4. Entrez un nom d'alias unique et fournissez une description facultative.

   5. Sous Associer une version, choisissez l'une des options suivantes :

      • Pour créer une nouvelle version, choisissez Créer une nouvelle version et associez-la à cet alias.

      • Pour utiliser une version existante, choisissez Utiliser une version existante pour associer cet alias. Dans le menu déroulant, choisissez la version à laquelle vous souhaitez associer l'alias.

   6. Sous Sélectionner le débit, sélectionnez l'une des options suivantes :

      • Pour permettre à votre agent d'exécuter l'inférence de modèles aux taux définis pour votre compte, sélectionnez On-Demand (ODT). Pour de plus amples informations, veuillez consulter Quotas pour Amazon Bedrock.

      • Pour permettre à votre agent d'exécuter l'inférence de modèles à un rythme accru à l'aide d'un débit provisionné que vous avez précédemment acheté pour le modèle, sélectionnez Débit provisionné (PT), puis sélectionnez un modèle provisionné. Pour de plus amples informations, veuillez consulter Augmentez la capacité d'invocation des modèles grâce au débit provisionné dans Amazon Bedrock.

   7. Sélectionnez Créer un alias.

2. Déployez votre agent en configurant votre application pour créer un InvokeAgentdemande auprès d'un point de terminaison Agents for Amazon Bedrock. Dans le agentAliasId champ, spécifiez l'ID de l'alias pointant vers la version de l'agent que vous souhaitez utiliser.

   Le flux de InvokeAgent réponse contient plusieurs événements avec des segments pour chaque partie de la réponse dans l'ordre. Vous pouvez éventuellement activer le streaming en réglant le paramètre streamFinalResponse sur true dans les configurations de streaming.

   • Si votre agent est configuré avec un garde-corps, vous pouvez également spécifier le applyGuardrailInterval dans leStreamingConfigurations, afin de contrôler la fréquence à laquelle un ApplyGuardrail appel est passé sur les caractères de réponse sortants (par exemple, tous les 50 caractères)

   • Le streaming des réponses n'est actuellement pris en charge qu'avec l'invite d'orchestration.

   • Les citations ne sont actuellement pas prises en charge par le streaming.

   • Assurez-vous que le rôle d'exécution de l'agent inclut l'bedrock:InvokeModelWithResponseStreamautorisation pour le modèle d'agent configuré.