# Retornar resultados da ferramenta
<a name="tool-use-results"></a>

Depois que a ferramenta for invocada pela aplicação, a etapa final será fornecer o resultado da ferramenta ao modelo. Isso é feito retornando um resultado da ferramenta com o ID da chamada da ferramenta e o conteúdo da resposta. Esse conteúdo segue o esquema [ToolResultBlock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ToolResultBlock.html):

```
{
    "toolResult": {
        "toolUseId": tool['toolUseId'],
        "content": [{"json": {"song": song, "artist": artist}}],
        "status": "success"
    }
}
```

O conteúdo do `ToolResultBlock` deve ser um único JSON ou uma mistura de texto e imagens.

O campo status pode ser usado para indicar ao modelo o status da execução da ferramenta. Se a execução da ferramenta falhar, você pode indicar a falha e o Amazon Nova tentará modificar sua chamada de ferramenta original.

Consulte a documentação de [ToolResultContentBlock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ToolResultContentBlock.html) para obter mais detalhes sobre o esquema.

Confira abaixo um exemplo de como usar a API Converse para retornar os resultados da ferramenta:

```
messages.append({
    "role": "user",
    "content": [
        {
            "toolResult": {
                "toolUseId": tool['toolUseId'],
                "content": [{"json": {"song": song, "artist": artist}}],
                "status": "success"
            }
        }
    ]
})

inf_params = {"maxTokens": 1000, "temperature": 0}

# Send the tool result to the model.
response = client.converse(
    modelId="us.amazon.nova-lite-v1:0",
    messages=messages,
    toolConfig=tool_config,
    inferenceConfig=inf_params
)

print(response['output']['message'])
```

Para obter mais detalhes sobre como aproveitar as ferramentas, consulte a documentação [Amazon Bedrock Tool Use](https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use.html) ou acesse as [amostras de uso da ferramenta](https://github.com/aws-samples/amazon-nova-samples/blob/main/multimodal-understanding/repeatable-patterns/10-tool-calling-with-converse/10_tool_calling_with_converse.ipynb) no repositório de amostras do Amazon Nova.