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

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.

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

Lorsque vous créez un agent Amazon Bedrock pour la première fois, vous disposez d'un brouillon de travail (DRAFT) et d'un alias de test (TSTALIASID) qui pointe vers le brouillon de travail. Lorsque vous apportez des modifications à votre agent, les modifications s'appliquent au brouillon de travail. Vous répétez votre brouillon jusqu'à ce que vous soyez satisfait du comportement de votre agent. Vous pouvez ensuite configurer votre agent pour le déploiement et l'intégration dans votre application en créant des alias de votre agent.

Pour déployer votre agent, vous devez créer un alias. Lors de la création de l'alias, Amazon Bedrock crée automatiquement une version de votre agent. L’alias pointe vers cette nouvelle version. Vous pouvez également pointer l'alias vers une version précédemment créée de votre agent. Ensuite, vous configurez votre application pour qu'APIelle appelle cet alias.

Une version est un instantané qui préserve la ressource telle qu'elle existe au moment de sa création. Vous pouvez continuer à modifier le brouillon et à créer de nouveaux alias (et, par conséquent, des versions) de votre agent si nécessaire. Dans Amazon Bedrock, vous créez une nouvelle version de l’agent en créant un alias qui pointe vers la nouvelle version par défaut. Amazon Bedrock crée des versions par ordre numérique, en commençant par 1.

Les versions sont immuables car elles agissent comme un instantané de votre agent au moment où vous l'avez créé. Pour mettre à jour un agent en production, vous devez créer une nouvelle version et configurer votre application pour qu'elle appelle l'alias qui pointe vers cette version.

Avec les alias, vous pouvez passer efficacement d'une version à l'autre de votre agent sans que l'application n'ait à suivre la version. Par exemple, vous pouvez modifier un alias pour qu'il pointe vers une version précédente de votre agent si certaines modifications doivent être annulées rapidement.

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 IAMrôle 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.
    routingConfiguration 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 API demande ne soit traité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

  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é.