Tester et résoudre les problèmes liés au comportement des agents - 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.

Tester et résoudre les problèmes liés au comportement des agents

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 de plus amples informations, veuillez consulter Déployez et intégrez un agent Amazon Bedrock dans votre application.

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 leAPI, le brouillon est la DRAFT version. Vous envoyez des informations à votre agent en utilisant InvokeAgentavec l'alias de testTSTALIASID, ou un autre alias pointant vers une version statique.

Pour aider à résoudre le problème de comportement de votre agent, Amazon Bedrock Agents 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 le processus de step-by-step raisonnement de l'agent à l'aide de Trace.

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 suivantes :

Console
Pour tester 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. 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 Using ODT ou Using PT. Pour créer un modèle de débit provisionné, sélectionnez Modifier. Pour de plus amples informations, veuillez consulter Augmentez la capacité d'invocation des modèles grâce au débit provisionné dans 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 le processus de step-by-step raisonnement de l'agent à l'aide de Trace.

    • 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 la fonction API ou 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 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 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 le regrouper avec les modifications préliminaires en envoyant un 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 Build-time. 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. À titre de bonne pratique, nous vous recommandons d'envoyer un GetAgentdemandez (voir le lien pour les formats de demande et de réponse et les détails des champs) avec un point de terminaison créé par Agents for Amazon Bedrock et vérifiez à quel preparedAt moment votre agent vérifie que vous testez votre agent avec les dernières configurations.

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

Note

Le AWS CLI ne prend pas en charge 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)
    inputText L'invite de l'utilisateur à envoyer à l'agent

  • Les champs suivants sont facultatifs :

    Champ Description abrégée
    enableTrace Spécifiez TRUE pour afficher la trace.
    endSession Spécifiez TRUE de mettre fin à la session avec l'agent après cette demande.
    sessionState Inclut le contexte qui influence le comportement de l'agent ou le comportement des bases de connaissances associées à l'agent. Pour de plus amples informations, veuillez consulter Contexte de session de l'agent 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 :