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. Sélectionnez l'onglet correspondant à la méthode de votre choix et 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 (voir le lien pour les formats de demande et de réponse et les détails des champs) à l'aide d'un point de terminaison créé par Agents for Amazon Bedrock.

    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 Identifiant garantissant que la API demande ne sera traitée qu'une seule fois.
    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 (voir le lien pour les formats de demande et de réponse et les détails des champs) avec un point de terminaison Agents for Amazon Bedrock Runtime. Dans le agentAliasId champ, spécifiez l'ID de l'alias pointant vers la version de l'agent que vous souhaitez utiliser.