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à.

# Aspetti salienti della struttura
<a name="complete-request-schema-response"></a>

Di seguito vengono illustrati gli elementi chiave della struttura di risposta restituita dalle `InvokeModel` funzioni non streaming `Converse` e. Per i dettagli sulla struttura di risposta completa e sulle strutture di richiesta e risposta per le funzioni di streaming, consulta la documentazione dell'API.

```
{
    "ResponseMetadata": {
        "RequestId": {{string}},
        "HTTPStatusCode": {{int}},
        "HTTPHeaders": {
            "date": {{string}},
            "content-type": "application/json",
            "content-length": {{string}},
            "connection": "keep-alive",
            "x-amzn-requestid": {{string}}
        },
        "RetryAttempts": 0
    },
    "output": {
        "message": {
            "role": "assistant",
            "content": [
                { // Optional
                    "reasoningContent": {
                        "reasoningText": {
                            "text": {{string}}
                        }
                    }
                },
                { // Optional
                    "toolUse": {
                        "toolUseId": {{string}},
                        "name": {{string}},
                        "input": {{object}}
                    }
                },
                { // Optional
                    "text": {{string}}
                },
                { // Optional
                    "image": {
                        "format": "png",
                        "source": {
                            "bytes": {
                                "bytes": {{image}} // Binary array (Converse API) or Base64-encoded string (Invoke API)
                            }
                        }
                    }
                }
            ]
        }
    },
    "stopReason": {{string}}, // "end_turn" | "content_filtered" | "max_tokens" | "malformed_model_output" | "malformed_tool_use" | etc.
    "usage": {
        "inputTokens": {{int}},
        "outputTokens": {{int}},
        "totalTokens": {{int}}
    },
    "metrics": {
        "latencyMs": {{int}}
    }
}
```

I seguenti sono gli elementi chiave di risposta:
+ `output`— (Obbligatorio) Contiene il messaggio di risposta del modello.
  + `message`— (Obbligatorio) Il messaggio di risposta dell'assistente.
    + `content`— (Obbligatorio) Un array di uno o più blocchi di contenuto che possono includere:
      + `reasoningContent`— (Facoltativo) Restituito se il ragionamento era abilitato. Contiene il testo del ragionamento, che sarà sempre presente `[REDACTED]` nella risposta.
      + `toolUse`— (Facoltativo) Restituito se è stato chiamato uno strumento. Contiene l'ID di utilizzo dello strumento, il nome e gli argomenti di input.
      + `text`— (Facoltativo) Restituito se il modello ha risposto con contenuto testuale.
      + `image`— (Facoltativo, solo) Restituito se il modello ha generato un'immagine. Il formato sarà sempre PNG per le immagini generate da.
+ `stopReason`— (Obbligatorio) Un valore enum che indica il motivo per cui il modello ha smesso di generare output. I valori supportati includono:
  + `end_turn`— È stata raggiunta la fine logica del turno.
  + `max_tokens`— L'output ha raggiunto il `maxTokens` limite impostato dall'utente o il limite massimo del token di output del modello.
  + `content_filtered`— L'output del modello ha violato la politica di intelligenza artificiale AWS responsabile.
  + `malformed_model_output`— Il modello ha prodotto un output non valido.
  + `malformed_tool_use`— Il modello ha prodotto un output non valido`toolUse`.
  + `service_unavailable`— Uno dei servizi di strumenti integrati non è stato raggiunto.
  + `invalid_query`— La query che il modello ha inviato allo strumento Web Grounding integrato non era valida.
  + `max_tool_invocations`— Indica che uno strumento integrato è stato richiamato ma non ha prodotto un risultato valido, anche dopo più tentativi.
+ `usage`— (Obbligatorio) Informazioni sull'utilizzo dei token, inclusi i token di input, i token di output e i token totali.
+ `metrics`— (Obbligatorio) Metriche delle prestazioni, inclusa la latenza totale di inferenza in millisecondi.