

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Restituzione dei risultati dello strumento
<a name="tool-use-results"></a>

Una volta che lo strumento è stato invocato dall’applicazione, la fase finale prevede la fornitura del risultato dello strumento al modello. Questa operazione viene eseguita restituendo un risultato dello strumento con l’ID della chiamata dello strumento e il contenuto della risposta. Questo contenuto segue lo [ToolResultBlock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ToolResultBlock.html)schema:

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

Il contenuto del `ToolResultBlock` deve essere un singolo JSON o una combinazione di testo e immagini.

Il campo dello stato può essere utilizzato per indicare al modello lo stato dell’esecuzione dello strumento. Se l'esecuzione dello strumento non riesce, puoi indicare l'errore e Amazon Nova tenterà di modificare la chiamata allo strumento originale.

Per ulteriori dettagli sullo schema, consulta la [ToolResultContentBlock](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_ToolResultContentBlock.html)documentazione.

Di seguito è riportato un esempio di come utilizzare l’API Converse per restituire i risultati dello strumento:

```
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'])
```

Per ulteriori dettagli su come sfruttare gli strumenti, consulta la documentazione [Amazon Bedrock Tool Use](https://docs.aws.amazon.com/bedrock/latest/userguide/tool-use.html) o visita [gli esempi di utilizzo degli strumenti](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) nel repository degli esempi di Amazon Nova.