As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Rastreie o processo de step-by-step raciocínio do agente usando trace
Cada resposta de um agente do Amazon Bedrock é acompanhada por um *rastreamento* que detalha as etapas que estão sendo orquestradas pelo agente. O rastreamento ajuda você a acompanhar o processo de raciocínio do agente que o leva à resposta que ele dá naquele momento da conversa.
Use o rastreamento para rastrear o caminho do agente desde a entrada do usuário até a resposta que ele retorna. O rastreamento fornece informações sobre as entradas dos grupos de ação que o agente invoca e as bases de conhecimento que ele consulta para responder ao usuário. Além disso, o rastreamento fornece informações sobre os resultados que os grupos de ação e as bases de conhecimento exibem. Você pode ver o raciocínio que o agente usa para determinar a ação que ele executa ou a consulta que ele faz a uma base de conhecimento. Se uma etapa do rastreamento falhar, o rastreamento retornará o motivo da falha. Use as informações detalhadas no rastreamento para solucionar problemas com o agente. Você pode identificar etapas nas quais o agente tem problemas ou nas quais ele produz um comportamento inesperado. Assim, você pode usar essas informações para considerar maneiras de melhorar o comportamento do agente.
## Estrutura do rastreamento
Se você habilitar o rastreamento, na resposta 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` no fluxo será acompanhado por um campo `trace` associado a um 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). O objeto `tracePart` contém informações sobre o agente e as sessões, bem como o processo de raciocínio do agente e os resultados da chamada de funções de API.
```
{
"agentId": "string",
"agentName": "string",
"collaboratorName": "string",
"agentAliasId": "string",
"sessionId": "string",
"agentVersion": "string",
"trace": { ...},
"callerChain": [{
"agentAliasArn": "{{agent alias arn}}"
}]
}
```
A lista a seguir descreve os campos do 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`: o identificador exclusivo da sessão do agente.
+ `agentName`: o nome do agente.
+ `collaboratorName`: se a colaboração multiagente estiver habilitada, o nome do agente colaborador.
+ `agentVersion`: a versão do agente.
+ `agentAliasId`: o identificador exclusivo do alias do agente.
+ `sessionId`: o identificador exclusivo da sessão com o agente.
+ `trace`: contém o processo de raciocínio do agente e os resultados da chamada de ações de API. Veja a seguir mais informações.
+ `callerChain`: lista de chamadores entre o agente que publicou o rastreamento em questão e o usuário final.
+ Se for um único agente, esse campo conterá o alias Arn do mesmo agente que publicou o rastreamento.
+ Se a colaboração multiagente estiver habilitada, esse campo conterá o alias Arn de todos os agentes que encaminharam o prompt do usuário final ao agente atual.
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) há um campo `trace` associado a um 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). O rastreamento é mostrado como um objeto JSON no console e na API. Cada **etapa** no console ou [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) na API pode ser um dos seguintes rastreamentos:
+ [PreProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingTrace.html)— Rastreia a entrada e a saída da etapa de pré-processamento, na qual o agente contextualiza e categoriza a entrada do usuário e determina se ela é válida.
+ [OrchestrationTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationTrace.html)— Rastreia a entrada e a saída da etapa de orquestração, na qual o agente interpreta a entrada, invoca grupos de ação e consulta as bases de conhecimento. Em seguida, o agente exibe a saída para continuar a orquestração ou responder ao usuário.
+ [PostProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingTrace.html)— Rastreia a entrada e a saída da etapa de pós-processamento, na qual o agente manipula a saída final da orquestração e determina como retornar a resposta ao usuário.
+ [CustomOrchestrationTrace](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent-runtime_CustomOrchestrationTrace.html)— Detalhes sobre a etapa de orquestração personalizada na qual o agente determina a ordem na qual as ações são executadas.
+ [RoutingClassifierTrace](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_agent-runtime_RoutingClassifierTrace.html)— Rastreia a entrada e a saída do classificador de roteamento
+ [FailureTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FailureTrace.html)— Rastreia o motivo pelo qual uma etapa falhou.
+ [GuardrailTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_GuardrailTrace.html)— Rastreia as ações do Guardrail.
Todos os rastreamentos (exceto `FailureTrace`) contêm um 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). O 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) contém configurações definidas no modelo de prompt da etapa com o prompt fornecido para o agente nessa etapa. Para obter mais informações sobre como modificar os modelos de prompt, consulte [Melhorar a precisão dos agentes usando modelos de prompts avançados no Amazon Bedrock](advanced-prompts.md). A estrutura do objeto `ModelInvocationInput` é descrita assim:
```
{
"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"
}
```
A lista a seguir descreve os campos do 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`: o identificador exclusivo do rastreamento.
+ `text`: o texto do prompt fornecido ao agente nesta etapa.
+ `type`: a etapa atual no processo do agente.
+ `foundationModel`: o modelo de base do agente colaborador na colaboração multiagente. Esse campo só será preenchido se `type` for `ROUTING_CLASSIFIER`. Se o modelo padrão usado para rotear o prompt for substituído, esse campo mostrará o modelo do agente supervisor usado para rotear o prompt.
+ `inferenceConfiguration`: parâmetros de inferência que influenciam a geração de resposta. Para obter mais informações, consulte [Geração de resposta de influência com parâmetros de inferência](inference-parameters.md).
+ `promptCreationMode`: se o modelo de prompt de base padrão do agente foi substituído para essa etapa. Para obter mais informações, consulte [Melhorar a precisão dos agentes usando modelos de prompts avançados no Amazon Bedrock](advanced-prompts.md).
+ `parserMode`: se o analisador de respostas padrão do agente foi substituído nessa etapa. Para obter mais informações, consulte [Melhorar a precisão dos agentes usando modelos de prompts avançados no Amazon Bedrock](advanced-prompts.md).
+ `overrideLambda`: o nome do recurso da Amazon (ARN) da função do Lambda analisadora usada para analisar a resposta, caso o analisador padrão tenha sido substituído. Para obter mais informações, consulte [Melhorar a precisão dos agentes usando modelos de prompts avançados no Amazon Bedrock](advanced-prompts.md).
Para obter mais informações sobre cada tipo de rastreamento, consulte as seguintes seções:
### PreProcessingTrace
```
{
"modelInvocationInput": { // see above for details }
"modelInvocationOutput": {
"metadata": {
"usage": {
"inputToken":: int,
"outputToken":: int
},
"rawResponse": {
"content": "string"
}
"parsedResponse": {
"isValid": boolean,
"rationale": "string"
},
"traceId": "string"
}
}
```
O [PreProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PreProcessingTrace.html)consiste em um [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 e um [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) contém os campos a seguir.
+ `metadata`: contém as informações a seguir sobre a saída do modelo de base.
+ `usage`: contém as informações a seguir sobre o uso do modelo de base.
+ `inputTokens`: contém as informações sobre os tokens de entrada do uso do modelo de base.
+ `outputTokens`: contém as informações sobre os tokens de saída do uso do modelo de base.
+ `rawResponse`: contém a saída bruta do modelo de base.
+ `content`: o conteúdo de saída bruto do modelo de base.
+ `parsedResponse`: contém os detalhes a seguir sobre o prompt do usuário analisado.
+ `isValid`: especifica se o prompt do usuário é válido.
+ `rationale`: especifica o raciocínio do agente para as próximas etapas a serem tomadas.
+ `traceId`: o identificador exclusivo do rastreamento.
### OrchestrationTrace
O [OrchestrationTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_OrchestrationTrace.html)consiste no [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, [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 e qualquer combinação dos objetos [Razão [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_Rationale.html)e [Observação](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.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) contém os campos a seguir. Para obter mais informações sobre [objetos](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rationale.html) de [InvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvocationInput.html)Razão e [Observação](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html), selecione nas guias a seguir.
```
{
"modelInvocationInput": { // see above for details },
"modelInvocationOutput": {
"metadata": {
"usage": {
"inputToken":: int,
"outputToken":: int
},
"rawResponse": {
"content": "string"
},
"rationale": { ... },
"invocationInput": { ... },
"observation": { ... }
}
```
Se `type` for `AGENT_COLLABORATOR` e se o roteamento tiver sido habilitado para o 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) conterá a seguinte estrutura:
```
routingClassifierModelInvocationOutput: {
traceId: "string",
rawResponse: "string",
routerClassifierParsedResponse: {...}
metadata: {
inputTokens: "..."
outputTokens: "..."
}
}
```
------
#### [ Rationale ]
O objeto [Rationale](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rationale.html) contém o raciocínio do agente de acordo com a entrada do usuário. Esta é a estrutura:
```
{
"traceId": "string",
"text": "string"
}
```
A lista a seguir descreve os campos do objeto [Rationale](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Rationale.html):
+ `traceId`: o identificador exclusivo da etapa de rastreamento.
+ `text`: o processo de raciocínio do agente, com base no prompt de entrada.
------
#### [ InvocationInput ]
O objeto [InvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvocationInput.html) contém informações que serão inseridas no grupo de ações a ser invocado ou na base de conhecimento a ser consultada. Esta é a estrutura:
```
{
"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"
}
}
```
A lista a seguir descreve os campos do objeto [InvocationInput](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvocationInput.html).
+ `traceId`: o identificador exclusivo do rastreamento.
+ `invocationType`: especifica se o agente está invocando um agente colaborador, um grupo de ação ou uma base de conhecimento ou se está encerrando a sessão.
+ `agentCollaborationInvocationInput`: contém a entrada de invocação para os agentes colaboradores. Aparece se `type` for `AGENT_COLLABORATOR` e se o roteamento estiver habilitado para o agente supervisor. Para obter mais informações, consulte [Usar a colaboração multiagente com Agentes do Amazon Bedrock](agents-multi-agent-collaboration.md).
+ A estrutura `agentCollaborationInvocationInput ` é a seguinte:
```
{
"agentCollaboratorName": "string",
"agentCollaboratorAliasArn": "string",
"input": {
"text": "string"
}
}
```
Estas são as descrições dos campos:
+ `agentCollaboratorName`: o nome do agente colaborador associado ao agente supervisor.
+ `agentCollaboratorAliasArn`: o ARN do alias do agente colaborador.
+ `input`: a string de entrada para o agente colaborador.
+ `actionGroupInvocationInput`: aparecerá se `type` for `ACTION_GROUP`. Para obter mais informações, consulte [Definir ações no grupo de ação](action-define.md). Pode ser uma das seguintes estruturas:
+ Se o grupo de ação for definido por um esquema de API, a estrutura será a seguinte:
```
{
"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"
}
```
Estas são as descrições dos campos:
+ `actionGroupName`: o nome do grupo de ação que o agente prevê deve ser invocado.
+ `apiPath`: o caminho para a operação de API a ser chamada, de acordo com o esquema da API.
+ `verb`: o método da API que está sendo usado, de acordo com o esquema da API.
+ `parameters`: contém uma lista de objetos. Cada objeto contém o nome, o tipo e o valor de um parâmetro na operação de API, conforme definido no esquema de API.
+ `requestBody`: contém o corpo da solicitação e as propriedades, conforme definido no esquema de API.
+ `executionType`: se o cumprimento da ação é passado para uma função do Lambda (`LAMBDA`) ou o controle é retornado por meio da resposta `InvokeAgent` (`RETURN_CONTROL`). Para obter mais informações, consulte [Processar o atendimento da ação](action-handle.md).
+ `invocationId`: o identificador exclusivo da invocação. Só será devolvido se o `executionType` for `RETURN_CONTROL`.
+ Se o grupo de ação for definido pelos detalhes da função, a estrutura será a seguinte:
```
{
"actionGroupName": "string",
"function": "string",
"parameters": [
{
"name": "string",
"type": "string",
"value": "string"
},
...
],
"executionType": "LAMBDA | RETURN_CONTROL",
"invocationId": "string"
}
```
Estas são as descrições dos campos:
+ `actionGroupName`: o nome do grupo de ação que o agente prevê deve ser invocado.
+ `function`: o nome da função que o agente prevê que deve ser chamada.
+ `parameters`: os parâmetros da função.
+ `executionType`: se o cumprimento da ação é passado para uma função do Lambda (`LAMBDA`) ou o controle é retornado por meio da resposta `InvokeAgent` (`RETURN_CONTROL`). Para obter mais informações, consulte [Processar o atendimento da ação](action-handle.md).
+ `invocationId`: o identificador exclusivo da invocação. Só será devolvido se o `executionType` for `RETURN_CONTROL`.
+ `knowledgeBaseLookupInput`: aparecerá se `type` for `KNOWLEDGE_BASE`. Para obter mais informações, consulte [Recuperar dados e gerar respostas de IA com as Bases de Conhecimento do Amazon Bedrock](knowledge-base.md). Contém as seguintes informações sobre a base de conhecimento e a consulta de pesquisa da base de conhecimento:
+ `knowledgeBaseId`: o identificador exclusivo da base de conhecimento que o agente consultará.
+ `text`: a consulta a ser feita na base de conhecimento.
------
#### [ Observation ]
O objeto [Observation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html) contém o resultado ou a saída de um agente colaborador, de um grupo de ação ou de uma base de conhecimento ou contém a resposta ao usuário. Esta é a estrutura:
```
{
"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"
}
}
```
A seguinte lista descreve os campos do objeto [Observation](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_Observation.html):
+ `traceId`: o identificador exclusivo do rastreamento.
+ `type`: especifica se a observação do agente é exibida com base no resultado de um agente colaborador, um grupo de ação ou uma base de conhecimento e se o agente está reenviando um prompt ao usuário, solicitando mais informações ou encerrando a conversa.
+ `agentCollaboratorInvocationOutput`: contém a resposta do agente colaborador ou a resposta final. Aparece se `type` for `AGENT_COLLABORATOR` e se o roteamento estiver habilitado para o agente supervisor. Para obter mais informações, consulte [Usar a colaboração multiagente com Agentes do Amazon Bedrock](agents-multi-agent-collaboration.md). Cada resposta contém os seguintes campos:
+ `agentCollaboratorName`: o nome do agente colaborador que está enviando a resposta.
+ `agentCollaboratorAliasArn`: o ARN do alias do agente colaborador que envia a resposta.
+ `output`: contém a resposta enviada pelo agente colaborador.
+ `actionGroupInvocationOutput`: contém a string formatada em JSON retornada pela operação de API invocada pelo grupo de ação. Aparecerá se `type` for `ACTION_GROUP`. Para obter mais informações, consulte [Definir esquemas OpenAPI para os grupos de ação do agente do Amazon Bedrock](agents-api-schema.md).
+ `knowledgeBaseLookupOutput`: contém texto recuperado da base de conhecimento que é relevante para responder ao prompt com o local da fonte de dados no Amazon S3. Aparecerá se `type` for `KNOWLEDGE_BASE`. Para obter mais informações, consulte [Recuperar dados e gerar respostas de IA com as Bases de Conhecimento do Amazon Bedrock](knowledge-base.md). Cada objeto na lista de `retrievedReferences` contém os seguintes campos:
+ `content`: contém `text` da base de conhecimento que é retornado da consulta à base de conhecimento.
+ `location`: contém o URI do Amazon S3 da fonte de dados na qual o texto retornado foi encontrado.
+ `repromptResponse`: aparecerá se `type` for `REPROMPT`. Contém o `text` que solicita mais um prompt com `source` do porquê o agente precisa enviar um novo prompt.
+ `finalResponse`: aparecerá se `type` for `ASK_USER` ou `FINISH`. Contém o `text` que solicita mais informações ao usuário ou é uma resposta ao usuário.
------
### PostProcessingTrace
```
{
"modelInvocationInput": { // see above for details }
"modelInvocationOutput": {
"rawResponse": {
"content": "string"
},
"metadata": {
"usage": {
"inputToken": int,
"outputToken": int
}
},
"parsedResponse": {
"text": "string"
},
"traceId": "string"
}
}
```
O [PostProcessingTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_PostProcessingTrace.html)consiste em um [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 e um [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. A [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) contém os seguintes campos:
+ `rawResponse`: contém a saída bruta do modelo de base.
+ `content`: o conteúdo de saída bruto do modelo de base.
+ `metadata`: contém as informações a seguir sobre a saída do modelo de base.
+ `usage`: contém as informações a seguir sobre o uso do modelo de base.
+ `inputTokens`: contém as informações sobre os tokens de entrada do uso do modelo de base.
+ `outputTokens`: contém as informações sobre os tokens de saída do uso do modelo de base.
+ `parsedResponse`: contém o `text` a ser retornado para o usuário depois de o texto ser processado pela função analisadora.
+ `traceId`: o identificador exclusivo do rastreamento.
### FailureTrace
```
{
"failureReason": "string",
"traceId": "string"
}
```
A lista a seguir descreve os campos do objeto [FailureTrace](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_FailureTrace.html).
+ `failureReason`: o motivo pelo qual a etapa falhou.
+ `traceId`: o identificador exclusivo do rastreamento.
### GuardrailTrace
```
{
"action": "GUARDRAIL_INTERVENED" | "NONE",
"inputAssessments": [GuardrailAssessment],
"outputAssessments": [GuardrailAssessment]
}
```
A lista a seguir descreve os campos do GuardrailAssessment objeto:
+ `action`: indica se as barreiras de proteção intervieram ou não nos dados de entrada. As opções são `GUARDRAIL_INTERVENED` ou `NONE`.
+ `inputAssessments`: os detalhes da avaliação da barreira de proteção na entrada do usuário.
+ `outputAssessments`: os detalhes da avaliação da barreira de proteção na resposta.
Para obter mais detalhes sobre o objeto `GuardrailAssessment` e testar uma barreira de proteção, consulte [Testar uma barreira de proteção](guardrails-test.md).
GuardrailAssessment exemplo:
```
{
"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"
}]
}
}
```