Création et configuration manuelles de l'agent - 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.

Création et configuration manuelles de l'agent

Pour créer un agent avec Amazon Bedrock, vous devez configurer les composants suivants :

  • La configuration de l'agent, qui définit l'objectif de l'agent et indique le modèle de base (FM) qu'il utilise pour générer des invites et des réponses.

  • Au moins l'un des éléments suivants :

    • Groupes d'actions qui définissent les actions pour lesquelles l'agent est conçu.

    • Une base de connaissances de sources de données pour augmenter les capacités génératives de l'agent en permettant la recherche et l'interrogation.

Vous pouvez créer au minimum un agent qui n'a qu'un nom. Pour préparer un agent afin de pouvoir le tester ou le déployer, vous devez configurer au minimum les composants suivants :

Configuration Description
Rôle de ressource de l'agent Le rôle ARN de service autorisé à effectuer des API opérations sur l'agent
Modèle de fondation (FM) Un FM que l'agent peut invoquer pour effectuer l'orchestration
Instructions Langage naturel décrivant ce que l'agent doit faire et comment il doit interagir avec les utilisateurs

Vous devez également configurer au moins un groupe d'actions ou une base de connaissances pour l'agent. Si vous préparez un agent sans groupes d'action ni bases de connaissances, il renverra des réponses basées uniquement sur le FM, les instructions et les modèles d'invite de base.

Pour savoir comment créer un agent, sélectionnez l'onglet correspondant à la méthode de votre choix et suivez les étapes suivantes :

Console
Pour créer un agent

  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.

  3. Dans la section Agents, choisissez Create Agent.

  4. (Facultatif) Modifiez le nom généré automatiquement pour l'agent et fournissez une description facultative pour celui-ci.

  5. Sélectionnez Create (Créer). Votre agent est créé et vous serez redirigé vers le générateur d'agents pour votre nouvel agent, où vous pourrez configurer votre agent.

  6. Vous pouvez suivre la procédure suivante pour configurer votre agent ou revenir ultérieurement au générateur d'agents.

Pour configurer votre agent

  1. Si vous n'êtes pas encore dans le générateur d'agents, procédez comme suit :

    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. Choisissez Modifier dans Agent Builder.

  2. Dans la section Détails de l'agent, vous pouvez configurer les configurations suivantes :

    1. Modifiez le nom ou la description de l'agent.

    2. Pour le rôle de ressource Agent, sélectionnez l'une des options suivantes :

      • Création et utilisation d'un nouveau rôle de service : laissez Amazon Bedrock créer le rôle de service et configurer les autorisations requises en votre nom.

      • Utiliser un rôle de service existant : utilisez un rôle personnalisé que vous avez configuré précédemment.

    3. Pour le modèle Select, sélectionnez un FM que votre agent appellera pendant l'orchestration.

    4. Dans Instructions pour l'agent, entrez des informations pour indiquer à l'agent ce qu'il doit faire et comment il doit interagir avec les utilisateurs. Les instructions remplacent l'espace réservé $instructions$ dans le modèle d'invite d'orchestration. Voici un exemple d'instructions :

      You are an office assistant in an insurance agency. You are friendly and polite. You help with managing insurance claims and coordinating pending paperwork.

    5. Si vous développez les paramètres supplémentaires, vous pouvez modifier les configurations suivantes :

      • Interprète de code — (Facultatif) Choisissez d'autoriser l'agent à gérer les tâches impliquant l'écriture, l'exécution, le test et le dépannage du code. Pour plus de détails, consultez Générez, exécutez et testez du code avec interprétation du code.

      • Entrée utilisateur — (Facultatif) Choisissez d'autoriser ou non l'agent à demander plus d'informations à l'utilisateur s'il ne dispose pas de suffisamment d'informations. Pour plus de détails, consultez Configurer l'agent pour demander des informations à l'utilisateur.

      • KMSsélection de la clé — (Facultatif) Par défaut, AWS chiffre les ressources de l'agent à l'aide d'une clé AWS gérée. Pour chiffrer votre agent avec votre propre clé gérée par le client, dans la section de sélection des KMS clés, sélectionnez Personnaliser les paramètres de chiffrement (avancés). Pour créer une nouvelle clé, sélectionnez Créer une AWS KMS clé, puis actualisez cette fenêtre. Pour utiliser une clé existante, sélectionnez une touche pour Choisir une AWS KMS clé.

      • Expiration de session inactive : par défaut, si un utilisateur n'a pas répondu pendant 30 minutes lors d'une session avec un agent Amazon Bedrock, l'agent ne conserve plus l'historique des conversations. L’historique d’une conversation est utilisé à la fois pour reprendre une interaction et pour compléter les réponses en fonction du contexte de cette conversation. Pour modifier cette durée par défaut, entrez un nombre dans le champ Délai d'expiration de la session et choisissez une unité de temps.

    6. Pour la section IAMdes autorisations, pour le rôle de ressource de l'agent, choisissez un rôle de service. Pour permettre à Amazon Bedrock de créer le rôle de service en votre nom, choisissez Create et utilisez un nouveau rôle de service. Pour utiliser un rôle personnalisé que vous avez créé précédemment, choisissez Utiliser un rôle de service existant.

      Note

      Le rôle de service qu'Amazon Bedrock crée pour vous n'inclut pas les autorisations pour les fonctionnalités en version préliminaire. Pour utiliser ces fonctionnalités, associez les autorisations appropriées au rôle de service.

    7. (Facultatif) Par défaut, AWS chiffre les ressources de l'agent avec un Clé gérée par AWS. Pour chiffrer votre agent avec votre propre clé gérée par le client, dans la section de sélection des KMS clés, sélectionnez Personnaliser les paramètres de chiffrement (avancés). Pour créer une nouvelle clé, sélectionnez Créer une AWS KMS clé, puis actualisez cette fenêtre. Pour utiliser une clé existante, sélectionnez une touche pour Choisir une AWS KMS clé.

    8. (Facultatif) Pour associer des balises à cet agent, dans la section Tags — facultatif, choisissez Ajouter une nouvelle balise et fournissez une paire clé-valeur.

    9. Lorsque vous avez terminé de configurer la configuration de l'agent, sélectionnez Suivant.

  3. Dans la section Groupes d'actions, vous pouvez choisir Ajouter pour ajouter des groupes d'actions à votre agent. Pour plus d'informations sur la configuration des groupes d'actions, consultezUtilisez des groupes d'actions pour définir les actions que votre agent doit effectuer. Pour savoir comment ajouter des groupes d'action à votre agent, consultezAjoutez un groupe d'action à votre agent dans Amazon Bedrock.

  4. Dans la section Bases de connaissances, vous pouvez choisir Ajouter pour associer des groupes de connaissances à votre agent. Pour plus d'informations sur la configuration des bases de connaissances, consultezRécupérez des données et générez des réponses basées sur l'IA avec des bases de connaissances. Pour savoir comment associer des bases de connaissances à votre agent, consultezAugmentez la génération de réponses pour votre agent grâce à une base de connaissances.

  5. Dans la section Détails des garde-corps, vous pouvez choisir Modifier pour associer un garde-corps à votre agent afin de bloquer et de filtrer les contenus dangereux. Sélectionnez le garde-corps que vous souhaitez utiliser dans le menu déroulant situé sous Sélectionner le garde-corps, puis choisissez la version à utiliser sous Version du garde-corps. Vous pouvez sélectionner Afficher pour voir les paramètres de votre garde-corps. Pour de plus amples informations, veuillez consulter Bloquez les contenus dangereux dans les modèles utilisant Amazon Bedrock Guardrails.

  6. Dans la section Invites avancées, vous pouvez choisir Modifier pour personnaliser les invites envoyées au FM par votre agent à chaque étape de l'orchestration. Pour plus d'informations sur les modèles d'invite que vous pouvez utiliser pour la personnalisation, consultezAméliorez la précision des agents à l'aide de modèles d'invite avancés dans Amazon Bedrock. Pour savoir comment configurer les instructions avancées, consultez.

  7. Lorsque vous avez terminé de configurer votre agent, sélectionnez l'une des options suivantes :

    • Pour rester dans le générateur d'agents, choisissez Enregistrer. Vous pouvez ensuite préparer l'agent afin de le tester avec vos configurations mises à jour dans la fenêtre de test. Pour savoir comment tester votre agent, consultezTester et résoudre les problèmes liés au comportement des agents.

    • Pour revenir à la page Détails de l'agent, choisissez Enregistrer et quittez.

API

Pour créer un agent, envoyez un CreateAgentdemande (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 Build-time.

Voir des exemples de code

Pour préparer votre agent et le tester ou le déployer, afin de pouvoir le tester ou le déployer, vous devez inclure au minimum les champs suivants (si vous préférez, vous pouvez ignorer ces configurations et les configurer ultérieurement en envoyant un UpdateAgentdemande) :

Champ Cas d’utilisation
agentResourceRoleArn Pour spécifier un ARN des rôles de service autorisés à appeler API des opérations sur l'agent
foundationModel Pour spécifier un modèle de base (FM) avec lequel l'agent doit orchestrer
instruction Fournir des instructions pour indiquer à l'agent ce qu'il doit faire. Utilisé dans l'espace réservé $instructions$ du modèle d'invite d'orchestration.

Les champs suivants sont facultatifs :

Champ Cas d’utilisation
description Décrit ce que fait l'agent
idleSessionTTLInSeconds Durée après laquelle l'agent met fin à la session et supprime toutes les informations stockées.
customerEncryptionKeyArn ARNd'une KMS clé pour chiffrer les ressources de l'agent
balises Pour associer des tags à votre agent.
promptOverrideConfiguration Pour personnaliser les instructions envoyées au FM à chaque étape de l'orchestration.
guardrailConfiguration Pour ajouter un garde-corps à l'agent. Spécifiez l'ID ou ARN le garde-corps et la version à utiliser.
clientToken Identifiant permettant de garantir que la API demande ne sera traitée qu'une seule fois.

La réponse renvoie un CreateAgentobjet contenant des informations sur l'agent que vous venez de créer. Si votre agent ne parvient pas à être créé, CreateAgentl'objet de la réponse renvoie une liste failureReasons et une liste recommendedActions de problèmes à résoudre.