Aspetti salienti della struttura - Amazon Nova

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

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

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