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.
Suivez les événements dans Amazon Bedrock
Chaque réponse d'un agent Amazon Bedrock est accompagnée d'une trace détaillant les étapes orchestrées par l'agent. Cette trace vous aide à suivre le processus de raisonnement de l’agent qui le conduit à la réponse qu’il donne à ce moment de la conversation.
Utilisez la trace pour suivre le parcours de l’agent depuis l’entrée utilisateur jusqu’à la réponse qu’il renvoie. La trace fournit des informations sur les entrées des groupes d'actions que l'agent invoque et sur les bases de connaissances qu'il interroge pour répondre à l'utilisateur. En outre, le suivi fournit des informations sur les résultats renvoyés par les groupes d'action et les bases de connaissances. Vous pouvez consulter le raisonnement utilisé par l’agent pour déterminer l’action qu’il entreprend ou la requête qu’il adresse à une base de connaissances. Si une étape de la trace échoue, la raison de cet échec est renvoyée. Utilisez les informations détaillées de la trace pour dépanner votre agent. Vous pouvez identifier les étapes au cours desquelles l'agent rencontre des problèmes ou celles au cours desquelles il produit un comportement inattendu. Vous pouvez ensuite utiliser ces informations pour réfléchir aux moyens d'améliorer le comportement de l'agent.
Afficher le tracé
Ce qui suit décrit comment afficher le traçage. Sélectionnez l'onglet correspondant à la méthode de votre choix et suivez les étapes.
Structure de la trace
La trace est affichée sous forme d'objet JSON à la fois dans la console et dans l'API. Chaque étape de la console ou Tracede l'API peut suivre l'une des étapes suivantes :
-
PreProcessingTrace— Trace l'entrée et la sortie de l'étape de prétraitement, au cours de laquelle l'agent contextualise et catégorise les entrées de l'utilisateur et détermine si elles sont valides.
-
OrchestrationTrace— Trace l'entrée et la sortie de l'étape d'orchestration, au cours de laquelle l'agent interprète les entrées, invoque des groupes d'action et interroge les bases de connaissances. L'agent renvoie ensuite la sortie pour poursuivre l'orchestration ou pour répondre à l'utilisateur.
-
PostProcessingTrace— Trace l'entrée et la sortie de l'étape de post-traitement, au cours de laquelle l'agent gère le résultat final de l'orchestration et détermine comment renvoyer la réponse à l'utilisateur.
-
FailureTrace— Détermine la raison pour laquelle une étape a échoué.
-
GuardrailTrace— Retrace les actions du garde-corps.
Chacune des traces (saufFailureTrace
) contient un ModelInvocationInputobjet. L'ModelInvocationInputobjet contient les configurations définies dans le modèle d'invite pour l'étape, ainsi que l'invite fournie à l'agent lors de cette étape. Pour plus d'informations sur la modification des modèles d'invite, consultezInstructions avancées dans Amazon Bedrock. La structure de l'ModelInvocationInput
objet est la suivante :
{ "traceId": "string", "text": "string", "type": "PRE_PROCESSING | ORCHESTRATION | KNOWLEDGE_BASE_RESPONSE_GENERATION | POST_PROCESSING", "inferenceConfiguration": { "maximumLength": number, "stopSequences": ["string"], "temperature": float, "topK": float, "topP": float }, "promptCreationMode": "DEFAULT | OVERRIDDEN", "parserMode": "DEFAULT | OVERRIDDEN", "overrideLambda": "string" }
La liste suivante décrit les champs de l'ModelInvocationInputobjet :
-
traceId
: identifiant unique de la trace. -
text
: texte de l’invite fournie à l’agent à cette étape. -
type
: étape actuelle du processus de l’agent. -
inferenceConfiguration
: paramètres d’inférence qui influencent la génération de réponses. Pour plus d’informations, consultez Paramètres d’inférence. -
promptCreationMode
— Si le modèle d'invite de base par défaut de l'agent a été remplacé pour cette étape. Pour plus d’informations, consultez Instructions avancées dans Amazon Bedrock. -
parserMode
— Si l'analyseur de réponse par défaut de l'agent a été remplacé pour cette étape. Pour plus d’informations, consultez Instructions avancées dans Amazon Bedrock. -
overrideLambda
— Le nom de ressource Amazon (ARN) de la fonction Lambda de l'analyseur utilisée pour analyser la réponse, si l'analyseur par défaut a été remplacé. Pour plus d’informations, consultez Instructions avancées dans Amazon Bedrock.
Pour plus d'informations sur chaque type de trace, consultez les sections suivantes :
{ "modelInvocationInput": { // see above for details } "modelInvocationOutput": { "parsedResponse": { "isValid": boolean, "rationale": "string" }, "traceId": "string" } }
PreProcessingTraceIl se compose d'un ModelInvocationInputobjet et d'un PreProcessingModelInvocationOutputobjet. PreProcessingModelInvocationOutput comporte les champs suivants.
-
parsedResponse
: contient les informations suivantes concernant l’invite utilisateur analysée.-
isValid
— Spécifie si l'invite de l'utilisateur est valide. -
rationale
: spécifie le raisonnement de l’agent pour les prochaines étapes à suivre.
-
-
traceId
: identifiant unique de la trace.
OrchestrationTraceIl comprend l'ModelInvocationInputobjet et toute combinaison des objets Justification et Observation. InvocationInput Pour plus d'informations sur chaque objet, sélectionnez l'un des onglets suivants :
{ "modelInvocationInput": { // see above for details }, "rationale": { ... }, "invocationInput": { ... }, "observation": { ... } }
{ "modelInvocationInput": { // see above for details } "modelInvocationOutput": { "parsedResponse": { "text": "string" }, "traceId": "string" } }
PostProcessingTraceIl se compose d'un ModelInvocationInputobjet et d'un PostProcessingModelInvocationOutputobjet. PostProcessingModelInvocationOutputIl contient les champs suivants :
-
parsedResponse
— Contient letext
code à renvoyer à l'utilisateur une fois le texte traité par la fonction d'analyse. -
traceId
: identifiant unique de la trace.
{ "failureReason": "string", "traceId": "string" }
La liste suivante décrit les champs de l'FailureTraceobjet :
-
failureReason
: raison pour laquelle l’étape a échoué. -
traceId
: identifiant unique de la trace.
{ "action": "GUARDRAIL_INTERVENED" | "NONE", "inputAssessments": [GuardrailAssessment], "outputAssessments": [GuardrailAssessment] }
La liste suivante décrit les champs de l' GuardrailAssessment objet :
-
action
— indique si des garde-corps sont intervenus ou non sur les données d'entrée. Les options sontGUARDRAIL_INTERVENED
ouNONE
. -
inputAssessments
— Les détails de l'évaluation de Guardrail sur la base des données saisies par l'utilisateur. -
outputAssessments
— Les détails de l'évaluation de Guardrail sur la réponse.
Pour plus de détails sur l'GuardrailAssessment
objet et le test d'un garde-corps, voir. Testez un garde-corps
GuardrailAssessment exemple :
{ "topicPolicy": { "topics": [{ "name": "string", "type": "string", "action": "string" }] }, "contentPolicy": { "filters": [{ "type": "string", "confidence": "string", "action": "string" }] }, "wordPolicy": { "customWords": [{ "match": "string", "action": "string" }], "managedWordLists": [{ "match": "string", "type": "string", "action": "string" }] }, "sensitiveInformationPolicy": { "piiEntities": [{ "type": "string", "match": "string", "action": "string" }], "regexes": [{ "name": "string", "regex": "string", "match": "string", "action": "string" }] } }