Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Realice un seguimiento del proceso de step-by-step razonamiento del agente mediante trace
Cada respuesta de un agente de Amazon Bedrock va acompañada de un *seguimiento* que le permite detallar los pasos que está orquestando el agente. El seguimiento le ayuda a seguir el proceso de razonamiento del agente que lo lleva a la respuesta que da en ese momento de la conversación.
Utilice el seguimiento para rastrear la ruta del agente desde la entrada del usuario hasta la respuesta que devuelve. El seguimiento proporciona información sobre las entradas de los grupos de acciones que invoca el agente y las bases de conocimientos que consulta para responder al usuario. Además, el seguimiento proporciona información sobre los resultados que devuelven los grupos de acción y las bases de conocimientos. Puede ver el razonamiento que utiliza el agente para determinar la acción que lleva a cabo o la consulta que realiza a una base de conocimientos. Si se produce un error en un paso del seguimiento, el seguimiento devuelve el motivo del error. Utilice la información detallada del seguimiento para solucionar los problemas del agente. Puede identificar los pasos en los que el agente tiene problemas o en los que genera un comportamiento inesperado. A continuación, puede utilizar esta información para considerar formas de mejorar el comportamiento del agente.
## Estructura del seguimiento
Si habilita el seguimiento, en la respuesta de [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html), cada `chunk` de la transmisión irá acompañado de un campo `trace` que se asigna a un objeto [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html). El objeto `tracePart` contiene información sobre el agente y las sesiones, junto con el proceso de razonamiento del agente y los resultados de la llamada a las funciones de la API.
```
{
"agentId": "string",
"agentName": "string",
"collaboratorName": "string",
"agentAliasId": "string",
"sessionId": "string",
"agentVersion": "string",
"trace": { ...},
"callerChain": [{
"agentAliasArn": "{{agent alias arn}}"
}]
}
```
En la siguiente lista se describen los campos del objeto [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html):
+ `agentId`: el identificador único del agente.
+ `agentName`: el nombre del agente.
+ `collaboratorName`: si la colaboración entre múltiples agentes está habilitada, el nombre del agente colaborador.
+ `agentVersion`: la versión del agente.
+ `agentAliasId`: el identificador único del alias del agente.
+ `sessionId`: el identificador único de la sesión con el agente.
+ `trace`: contiene el proceso de razonamiento del agente y los resultados de la llamada a las acciones de la API. Para obtener más información, consulte las secciones siguientes.
+ `callerChain`: lista de intermediarios entre el agente que publicó este rastro y el usuario final.
+ Si solo hay un agente, este campo contendrá el ARN del alias del mismo agente que publicó el rastro.
+ Si la colaboración entre múltiples agentes está habilitada, este campo contendrá el ARN del alias de todos los agentes que reenviaron la solicitud del usuario final al agente actual.
Dentro de [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_TracePart.html) hay un campo `trace` que se asigna a un objeto [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Trace.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Trace.html). El seguimiento se muestra como un objeto JSON tanto en la consola como en la API. Cada **paso** de la consola o [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Trace.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Trace.html) de la API puede ser uno de los siguientes seguimientos:
+ [PreProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingTrace.html)— Realiza un seguimiento de las entradas y salidas del paso previo al procesamiento, en el que el agente contextualiza y categoriza las entradas del usuario y determina si son válidas.
+ [OrchestrationTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationTrace.html)— Rastrea la entrada y la salida del paso de orquestación, en el que el agente interpreta la entrada, invoca grupos de acción y consulta las bases de conocimiento. A continuación, el agente devuelve la salida para continuar con la orquestación o para responder al usuario.
+ [PostProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingTrace.html)— Realiza un seguimiento de las entradas y salidas del paso de posprocesamiento, en el que el agente gestiona el resultado final de la orquestación y determina cómo devolver la respuesta al usuario.
+ [CustomOrchestrationTrace](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent-runtime_CustomOrchestrationTrace.html)— Detalles sobre el paso de orquestación personalizado en el que el agente determina el orden en que se ejecutan las acciones.
+ [RoutingClassifierTrace](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent-runtime_RoutingClassifierTrace.html)— Rastrea la entrada y la salida del clasificador de enrutamiento
+ [FailureTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FailureTrace.html)— Rastrea el motivo por el que falló un paso.
+ [GuardrailTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GuardrailTrace.html)— Rastrea las acciones de la barandilla.
Cada uno de los seguimientos (excepto `FailureTrace`) contiene un objeto [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html). El objeto [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html) contiene las configuraciones establecidas en la plantilla de peticiones del paso, junto con la petición que se proporciona al agente en este paso. Para obtener más información acerca de cómo modificar las plantillas de peticiones, consulte [Mejora de la precisión del agente con plantillas de peticiones avanzadas en Amazon Bedrock](advanced-prompts.md). La estructura del objeto `ModelInvocationInput` es la siguiente:
```
{
"traceId": "string",
"text": "string",
"type": "PRE_PROCESSING | ORCHESTRATION | ROUTING_CLASSIFIER | KNOWLEDGE_BASE_RESPONSE_GENERATION | POST_PROCESSING",
"foundationModel":string",
"inferenceConfiguration": {
"maximumLength": number,
"stopSequences": ["string"],
"temperature": float,
"topK": float,
"topP": float
},
"promptCreationMode": "DEFAULT | OVERRIDDEN",
"parserMode": "DEFAULT | OVERRIDDEN",
"overrideLambda": "string"
}
```
En la siguiente lista se describen los campos del objeto [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html):
+ `traceId`: el identificador único del seguimiento.
+ `text`: el texto de la petición proporcionada al agente en este paso.
+ `type`: el paso actual del proceso del agente.
+ `foundationModel`: el modelo fundacional del agente colaborador en la colaboración entre múltiples agentes. Este campo se rellena solo si `type` es `ROUTING_CLASSIFIER`. Si se invalida el modelo predeterminado utilizado para la petición de enrutamiento, este campo muestra el modelo del agente supervisor que se usa para enrutar la petición.
+ `inferenceConfiguration`: parámetros de inferencia que influyen en la generación de respuestas. Para obtener más información, consulte [Influencia sobre la generación de respuestas con parámetros de inferencia](inference-parameters.md).
+ `promptCreationMode`: si la plantilla de petición base predeterminada del agente se ha anulado para este paso o no. Para obtener más información, consulte [Mejora de la precisión del agente con plantillas de peticiones avanzadas en Amazon Bedrock](advanced-prompts.md).
+ `parserMode`: si el analizador de respuestas predeterminado del agente se ha anulado para este paso o no. Para obtener más información, consulte [Mejora de la precisión del agente con plantillas de peticiones avanzadas en Amazon Bedrock](advanced-prompts.md).
+ `overrideLambda`: el Nombre de recurso de Amazon (ARN) de la función de Lambda del analizador utilizada para analizar la respuesta, si se ha anulado el analizador predeterminado. Para obtener más información, consulte [Mejora de la precisión del agente con plantillas de peticiones avanzadas en Amazon Bedrock](advanced-prompts.md).
Para obtener más información acerca de cada tipo de seguimiento, consulte las secciones siguientes:
### PreProcessingTrace
```
{
"modelInvocationInput": { // see above for details }
"modelInvocationOutput": {
"metadata": {
"usage": {
"inputToken":: int,
"outputToken":: int
},
"rawResponse": {
"content": "string"
}
"parsedResponse": {
"isValid": boolean,
"rationale": "string"
},
"traceId": "string"
}
}
```
[PreProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingTrace.html)Consiste en un [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html)objeto y un [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingModelInvocationOutput.html)objeto. [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingModelInvocationOutput.html) contiene los siguientes campos.
+ `metadata`: contiene la siguiente información acerca del resultado del modelo fundacional.
+ `usage`: contiene la siguiente información acerca del uso del modelo fundacional.
+ `inputTokens`: contiene la información sobre los tokens de entrada del uso del modelo fundacional.
+ `outputTokens`: contiene la información sobre los tokens de salida del uso del modelo fundacional.
+ `rawResponse`: contiene la salida sin procesar del modelo fundacional.
+ `content`: es el contenido de salida sin procesar del modelo fundacional.
+ `parsedResponse`: contiene los siguientes detalles sobre la petición del usuario analizada.
+ `isValid`: especifica si la petición del usuario es válida.
+ `rationale`: especifica el razonamiento del agente sobre los siguientes pasos que tomar.
+ `traceId`: el identificador único del seguimiento.
### OrchestrationTrace
[OrchestrationTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationTrace.html)Se compone del [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html)objeto, el [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html)objeto y cualquier combinación de los objetos [Rationale](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rationale.html) y [Observation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html). [InvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvocationInput.html) [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html) contiene los siguientes campos. Para obtener más información sobre los objetos [Rationale](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rationale.html) y [Observation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html), seleccione una de las siguientes pestañas. [InvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvocationInput.html)
```
{
"modelInvocationInput": { // see above for details },
"modelInvocationOutput": {
"metadata": {
"usage": {
"inputToken":: int,
"outputToken":: int
},
"rawResponse": {
"content": "string"
},
"rationale": { ... },
"invocationInput": { ... },
"observation": { ... }
}
```
Si `type` es `AGENT_COLLABORATOR` y el enrutamiento estaba habilitado para el agente supervisor, [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationModelInvocationOutput.html) contendrá la siguiente estructura:
```
routingClassifierModelInvocationOutput: {
traceId: "string",
rawResponse: "string",
routerClassifierParsedResponse: {...}
metadata: {
inputTokens: "..."
outputTokens: "..."
}
}
```
------
#### [ Rationale ]
El objeto [Rationale](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rationale.html) contiene el razonamiento del agente según la información proporcionada por el usuario. La estructura es la siguiente:
```
{
"traceId": "string",
"text": "string"
}
```
En la siguiente lista se describen los campos del objeto [Rationale](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rationale.html):
+ `traceId`: el identificador único del paso de seguimiento.
+ `text`: es el proceso de razonamiento del agente, basado en la petición de entrada.
------
#### [ InvocationInput ]
El objeto [InvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvocationInput.html) contiene información que se introducirá en el grupo de acción o en la base de conocimientos que se va a invocar o consultar. La estructura es la siguiente:
```
{
"traceId": "string",
"invocationType": "AGENT_COLLABORATOR" | "ACTION_GROUP | KNOWLEDGE_BASE | FINISH",
"agentCollaboratorInvocationInput": {
// see below for details
},
"actionGroupInvocationInput": {
// see below for details
},
"knowledgeBaseLookupInput": {
"knowledgeBaseId": "string",
"text": "string"
}
}
```
En la siguiente lista se describen los campos del objeto [InvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvocationInput.html):
+ `traceId`: el identificador único del seguimiento.
+ `invocationType`: especifica si el agente invoca un agente colaborador, un grupo de acciones o una base de conocimiento, o finaliza la sesión.
+ `agentCollaborationInvocationInput`: contiene la entrada de invocación para los agentes colaboradores. Aparece si `type` es `AGENT_COLLABORATOR` y el enrutamiento si está activado para el agente supervisor. Para obtener más información, consulte [Uso de la colaboración entre múltiples agentes con Agentes para Amazon Bedrock](agents-multi-agent-collaboration.md).
+ La estructura de `agentCollaborationInvocationInput ` es la siguiente:
```
{
"agentCollaboratorName": "string",
"agentCollaboratorAliasArn": "string",
"input": {
"text": "string"
}
}
```
A continuación, se indican las descripciones de los campos:
+ `agentCollaboratorName`: el nombre del agente colaborador asociado al agente supervisor.
+ `agentCollaboratorAliasArn`: el ARN del alias del agente colaborador.
+ `input`: la cadena de entrada del agente colaborador.
+ `actionGroupInvocationInput`: aparece si el `type` es `ACTION_GROUP`. Para obtener más información, consulte [Definición de acciones en el grupo de acciones](action-define.md). Puede ser una de las siguientes estructuras:
+ Si el grupo de acciones se define mediante un esquema de API, la estructura es la siguiente:
```
{
"actionGroupName": "string",
"apiPath": "string",
"verb": "string",
"parameters": [
{
"name": "string",
"type": "string",
"value": "string"
},
...
],
"requestBody": {
"content": {
"{{}}": [
{
"name": "string",
"type": "string",
"value": "string"
}
]
}
},
"executionType": "LAMBDA | RETURN_CONTROL",
"invocationId": "string"
}
```
A continuación, se indican las descripciones de los campos:
+ `actionGroupName`: es el nombre del grupo de acciones que el agente predice que debería invocarse.
+ `apiPath`: es la ruta a la operación de la API a la que se va a llamar, de acuerdo con el esquema de API.
+ `verb`: es el método de API que se utiliza, de acuerdo con el esquema de API.
+ `parameters`: contiene una lista de objetos. Cada objeto contiene el nombre, el tipo y el valor de un parámetro de la operación de la API, tal y como se define en el esquema de API.
+ `requestBody`: contiene el cuerpo de la solicitud y sus propiedades, tal y como se definen en el esquema de API.
+ `executionType`: si el cumplimiento de la acción se transfiere a una función de Lambda (`LAMBDA`) o si el control se devuelve a través de la respuesta de `InvokeAgent` (`RETURN_CONTROL`). Para obtener más información, consulte [Gestión del cumplimiento de la acción](action-handle.md).
+ `invocationId`: es el identificador único de la invocación. Solo se devuelve si el `executionType` es `RETURN_CONTROL`.
+ Si el grupo de acciones se define por los detalles de la función, la estructura es la siguiente:
```
{
"actionGroupName": "string",
"function": "string",
"parameters": [
{
"name": "string",
"type": "string",
"value": "string"
},
...
],
"executionType": "LAMBDA | RETURN_CONTROL",
"invocationId": "string"
}
```
A continuación, se indican las descripciones de los campos:
+ `actionGroupName`: es el nombre del grupo de acciones que el agente predice que debería invocarse.
+ `function`: es el nombre de la función que el agente predice que se debería llamar.
+ `parameters`: son los parámetros de la función.
+ `executionType`: si el cumplimiento de la acción se transfiere a una función de Lambda (`LAMBDA`) o si el control se devuelve a través de la respuesta de `InvokeAgent` (`RETURN_CONTROL`). Para obtener más información, consulte [Gestión del cumplimiento de la acción](action-handle.md).
+ `invocationId`: es el identificador único de la invocación. Solo se devuelve si el `executionType` es `RETURN_CONTROL`.
+ `knowledgeBaseLookupInput`: aparece si el `type` es `KNOWLEDGE_BASE`. Para obtener más información, consulte [Recuperación de datos y generación de respuestas de IA con Bases de conocimiento de Amazon Bedrock](knowledge-base.md). Contiene la siguiente información sobre la base de conocimientos y la consulta de búsqueda de la base de conocimientos:
+ `knowledgeBaseId`: el identificador único de la base de conocimientos que el agente va a buscar.
+ `text`: la consulta que se debe realizar a la base de conocimientos.
------
#### [ Observation ]
El objeto [Observation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html) contiene el resultado o la salida de un agente colaborador, un grupo de acciones o una base de conocimiento, o la respuesta al usuario. La estructura es la siguiente:
```
{
"traceId": "string",
"type": "AGENT_COLLABORATOR |ACTION_GROUP | KNOWLEDGE_BASE | REPROMPT | ASK_USER | FINISH",
"agentCollaboratorInvocationOutput": {
"agentCollaboratorName": "string",
"agentCollaboratorAliasArn": "string",
"output": {
"text": "string"
},
"actionGroupInvocation": {
"text": "JSON-formatted string"
},
"knowledgeBaseLookupOutput": {
"retrievedReferences": [
{
"content": {
"text": "string"
},
"location": {
"type": "S3",
"s3Location": {
"uri": "string"
}
}
},
...
]
},
"repromptResponse": {
"source": "ACTION_GROUP | KNOWLEDGE_BASE | PARSER",
"text": "string"
},
"finalResponse": {
"text"
}
}
```
En la siguiente lista se describen los campos del objeto [Observation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html):
+ `traceId`: el identificador único del seguimiento.
+ `type`: especifica si la observación del agente se devuelve desde el resultado de un agente colaborado, un grupo de acciones o una base de conocimiento, o si el agente vuelve a preguntar al usuario, solicita más información o finaliza la conversación.
+ `agentCollaboratorInvocationOutput`: contiene la respuesta del agente colaborador o la respuesta final. Aparece si `type` es `AGENT_COLLABORATOR` y el enrutamiento si está activado para el agente supervisor. Para obtener más información, consulte [Uso de la colaboración entre múltiples agentes con Agentes para Amazon Bedrock](agents-multi-agent-collaboration.md). Cada respuesta contiene los siguientes campos:
+ `agentCollaboratorName`: el nombre del agente colaborador que envía la respuesta.
+ `agentCollaboratorAliasArn`: el ARN del alias del agente colaborador que envía la respuesta.
+ `output`: contiene la respuesta enviada por el agente colaborador.
+ `actionGroupInvocationOutput`: contiene la cadena con formato JSON devuelta por la operación de la API invocada por el grupo de acciones. Aparece si el `type` es `ACTION_GROUP`. Para obtener más información, consulte [Definición de los esquemas de OpenAPI para los grupos de acciones del agente en Amazon Bedrock](agents-api-schema.md).
+ `knowledgeBaseLookupOutput`: contiene el texto recuperado de la base de conocimientos que sea relevante para responder a la petición, junto con la ubicación en Amazon S3 del origen de datos. Aparece si el `type` es `KNOWLEDGE_BASE`. Para obtener más información, consulte [Recuperación de datos y generación de respuestas de IA con Bases de conocimiento de Amazon Bedrock](knowledge-base.md). Cada objeto de la lista de `retrievedReferences` contiene los siguientes campos:
+ `content`: contiene el `text` de la base de conocimientos que se devuelve de la consulta de la base de conocimientos.
+ `location`: contiene el URI de Amazon S3 del origen de datos en la que se ha encontrado el texto devuelto.
+ `repromptResponse`: aparece si el `type` es `REPROMPT`. Contiene el `text` que solicita una nueva petición junto con el `source` de por qué el agente necesita volver a solicitarlo.
+ `finalResponse`: aparece si el `type` es `ASK_USER` o `FINISH`. Contiene el `text` que solicita al usuario más información o es una respuesta al usuario.
------
### PostProcessingTrace
```
{
"modelInvocationInput": { // see above for details }
"modelInvocationOutput": {
"rawResponse": {
"content": "string"
},
"metadata": {
"usage": {
"inputToken": int,
"outputToken": int
}
},
"parsedResponse": {
"text": "string"
},
"traceId": "string"
}
}
```
Se [PostProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingTrace.html)compone de un [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_ModelInvocationInput.html)objeto y un [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingModelInvocationOutput.html)objeto. La [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingModelInvocationOutput.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingModelInvocationOutput.html) contiene los siguientes campos:
+ `rawResponse`: contiene la salida sin procesar del modelo fundacional.
+ `content`: es el contenido de salida sin procesar del modelo fundacional.
+ `metadata`: contiene la siguiente información acerca del resultado del modelo fundacional.
+ `usage`: contiene la siguiente información acerca del uso del modelo fundacional.
+ `inputTokens`: contiene la información sobre los tokens de entrada del uso del modelo fundacional.
+ `outputTokens`: contiene la información sobre los tokens de salida del uso del modelo fundacional.
+ `parsedResponse`: contiene el `text` que se devuelve al usuario tras ser procesado por la función del analizador.
+ `traceId`: el identificador único del seguimiento.
### FailureTrace
```
{
"failureReason": "string",
"traceId": "string"
}
```
En la siguiente lista se describen los campos del objeto [FailureTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FailureTrace.html):
+ `failureReason`: el motivo por el que el paso falló.
+ `traceId`: el identificador único del seguimiento.
### GuardrailTrace
```
{
"action": "GUARDRAIL_INTERVENED" | "NONE",
"inputAssessments": [GuardrailAssessment],
"outputAssessments": [GuardrailAssessment]
}
```
En la siguiente lista se describen los campos del GuardrailAssessment objeto:
+ `action`: indica si las barreras de protección han intervenido o no en los datos de entrada. Las opciones son `GUARDRAIL_INTERVENED` y `NONE`.
+ `inputAssessments`: son los detalles de la evaluación de la barrera de protección de la entrada del usuario.
+ `outputAssessments`: son los detalles de la evaluación de la barrera de protección en la respuesta.
Para obtener más información sobre el objeto `GuardrailAssessment` y sobre las pruebas de una barrera de protección, consulte [Prueba de la barrera de protección](guardrails-test.md).
GuardrailAssessment ejemplo:
```
{
"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"
}]
}
}
```