Testez un agent Amazon Bedrock - 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.

Testez un agent Amazon Bedrock

Une fois que vous aurez créé un agent, vous disposerez d'un brouillon de travail. La version préliminaire est une version de l’agent que vous pouvez utiliser pour créer l’agent de manière itérative. Chaque fois que vous apportez des modifications à votre agent, le brouillon est mis à jour. Lorsque vous êtes satisfait des configurations de votre agent, vous pouvez créer une version, qui est un instantané de votre agent, et un alias, qui pointe vers la version. Vous pouvez ensuite déployer votre agent sur vos applications en appelant l'alias. Pour plus d’informations, consultez Déployer un agent Amazon Bedrock.

La liste suivante décrit la manière dont vous testez votre agent :

  • Dans la console Amazon Bedrock, vous ouvrez la fenêtre de test sur le côté et vous envoyez des informations auxquelles votre agent doit répondre. Vous pouvez sélectionner le brouillon de travail ou une version que vous avez créée.

  • Dans l'API, le brouillon de travail est la DRAFT version. Vous envoyez une entrée à votre agent InvokeAgenten utilisant l'alias de test ou un autre alias pointant vers une version statique. TSTALIASID

Pour aider à résoudre le problème de comportement de votre agent, Agents for Amazon Bedrock permet de consulter le suivi lors d'une session avec votre agent. La trace montre le processus de step-by-step raisonnement de l'agent. Pour plus d'informations sur le traçage, consultezSuivez les événements dans Amazon Bedrock.

Vous trouverez ci-dessous les étapes à suivre pour tester votre agent. Sélectionnez l'onglet correspondant à la méthode de votre choix et suivez les étapes.

Console
Pour tester un agent

  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 Agents, sélectionnez le lien de l'agent que vous souhaitez tester dans la liste des agents.

  4. La fenêtre de test apparaît dans un volet sur la droite.

    Note

    Si la fenêtre de test est fermée, vous pouvez la rouvrir en sélectionnant Test en haut de la page de détails de l'agent ou sur n'importe quelle page de celle-ci.

  5. Après avoir créé un agent, vous devez le regrouper avec le brouillon de modifications en le préparant de l'une des manières suivantes :

    • Dans la fenêtre Test, sélectionnez Préparer.

    • Dans la page de brouillon de travail, sélectionnez Préparer en haut de la page.

    Note

    Chaque fois que vous mettez à jour le brouillon de travail, vous devez préparer l'agent à l'intégrer à vos dernières modifications. En tant que bonne pratique, nous vous recommandons de toujours vérifier l'heure de dernière préparation de votre agent dans la section Présentation de l'agent de la page de brouillon afin de vérifier que vous testez votre agent avec les dernières configurations.

  6. Pour choisir un alias et la version associée à tester, utilisez le menu déroulant en haut de la fenêtre de test. Par défaut, la combinaison TestAlias: Brouillon de travail est sélectionnée.

  7. (Facultatif) Pour sélectionner le débit provisionné pour votre alias, le texte situé sous l'alias de test que vous avez sélectionné indiquera Utiliser ODT ou Utiliser PT. Pour créer un modèle de débit provisionné, sélectionnez Modifier. Pour plus d’informations, consultez Débit provisionné pour Amazon Bedrock.

  8. Pour tester l'agent, entrez un message et choisissez Exécuter. Pendant que vous attendez que la réponse soit générée ou après sa génération, les options suivantes s'offrent à vous :

    • Pour afficher les détails de chaque étape du processus d'orchestration de l'agent, y compris l'invite, les configurations d'inférence, le processus de raisonnement de l'agent pour chaque étape, ainsi que l'utilisation de ses groupes d'actions et de ses bases de connaissances, sélectionnez Afficher la trace. Le suivi est mis à jour en temps réel afin que vous puissiez le consulter avant que la réponse ne soit renvoyée. Pour développer ou réduire le tracé d'une étape, sélectionnez une flèche à côté d'une étape. Pour plus d'informations sur la fenêtre Trace et les détails qui s'affichent, consultezSuivez les événements dans Amazon Bedrock.

    • Si l'agent invoque une base de connaissances, la réponse contient des notes de bas de page. Pour afficher le lien vers l'objet S3 contenant les informations citées pour une partie spécifique de la réponse, sélectionnez la note de bas de page correspondante.

    • Si vous configurez votre agent pour qu'il reprenne le contrôle plutôt que d'utiliser une fonction Lambda pour gérer le groupe d'actions, la réponse contient l'action prévue et ses paramètres. Fournissez un exemple de valeur de sortie de l'API ou de la fonction pour l'action, puis choisissez Soumettre pour générer une réponse de l'agent. Reportez-vous à l'image suivante pour un exemple :

      Demande de fenêtre de test pour fournir un exemple de sortie pour l'action.

    Vous pouvez effectuer les actions suivantes dans la fenêtre de test :

    • Pour démarrer une nouvelle conversation avec l'agent, sélectionnez l'icône d'actualisation.

    • Pour afficher la fenêtre Trace, sélectionnez l'icône d'extension. Pour fermer la fenêtre Trace, sélectionnez l'icône de réduction.

    • Pour fermer la fenêtre de test, sélectionnez l'icône représentant une flèche droite.

Vous pouvez activer ou désactiver les groupes d'actions et les bases de connaissances. Utilisez cette fonctionnalité pour résoudre les problèmes de votre agent en identifiant les groupes d'actions ou les bases de connaissances qui doivent être mis à jour en évaluant son comportement avec différents paramètres.

Pour activer un groupe d'action ou une base de connaissances

  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 Agents, sélectionnez le lien de l'agent que vous souhaitez tester dans la liste des agents.

  4. Sur la page des informations de l'agent, dans la section Projet de travail, sélectionnez le lien vers le brouillon de travail.

  5. Dans la section Groupes d'actions ou Bases de connaissances, passez le curseur sur l'état du groupe d'actions ou de la base de connaissances dont vous souhaitez modifier l'état.

  6. Un bouton de modification apparaît. Sélectionnez l'icône d'édition, puis choisissez dans le menu déroulant si le groupe d'actions ou la base de connaissances est activé ou désactivé.

  7. Si un groupe d'actions est désactivé, l'agent ne l'utilise pas. Si une base de connaissances est désactivée, l'agent ne l'utilise pas. Activez ou désactivez les groupes d'actions ou les bases de connaissances, puis utilisez la fenêtre de test pour dépanner votre agent.

  8. Choisissez Préparer pour appliquer les modifications que vous avez apportées à l'agent avant de le tester.

API

Avant de tester votre agent pour la première fois, vous devez l'intégrer aux brouillons de modifications en envoyant une PrepareAgentdemande (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 au moment de la création. Incluez-le agentId dans la demande. Les modifications s'appliquent à la DRAFT version vers laquelle pointe l'TSTALIASIDalias.

Voir des exemples de code

Note

Chaque fois que vous mettez à jour le brouillon de travail, vous devez préparer l'agent à l'intégrer à vos dernières modifications. En tant que bonne pratique, nous vous recommandons d'envoyer une GetAgentdemande (voir le lien pour les formats de demande et de réponse et les détails des champs) avec un point de terminaison prédéfini Agents for Amazon Bedrock et de vérifier à quel preparedAt moment votre agent vérifie que vous testez votre agent avec les dernières configurations.

Pour tester votre agent, envoyez une 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.

Note

Le AWS CLI ne supporte pas InvokeAgent.

Voir des exemples de code

Les champs suivants figurent dans la demande :

  • Indiquez au minimum les champs obligatoires suivants :

    Champ Description abrégée
    agentId ID de l'agent
    agentAliasId ID de l'alias. TSTALIASIDÀ utiliser pour invoquer la DRAFT version
    sessionId Identifiant alphanumérique de la session (2 à 100 caractères)
    Texte de saisie L'invite de l'utilisateur à envoyer à l'agent

  • Les champs suivants sont facultatifs :

    Champ Description abrégée
    Activer le suivi Spécifiez TRUE pour afficher la trace.
    Fin de session Spécifiez TRUE de mettre fin à la session avec l'agent après cette demande.
    État de la session Inclut le contexte qui influence le comportement de l'agent ou le comportement des bases de connaissances associées à l'agent. Pour plus d’informations, consultez Contexte de session de contrôle.

La réponse est renvoyée dans un flux d'événements. Chaque événement contient unchunk, qui contient une partie de la réponse dans le bytes champ, qui doit être décodée. Si l'agent a demandé une base de connaissances, celle-ci inclut chunk également. citations Les objets suivants peuvent également être renvoyés :

  • Si vous avez activé le traçage, un trace objet est également renvoyé. En cas d'erreur, un champ est renvoyé avec le message d'erreur. Pour plus d'informations sur la façon de lire la trace, consultezSuivez les événements dans Amazon Bedrock.