Höhepunkte der Antwortstruktur - Amazon Nova

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Höhepunkte der Antwortstruktur

Im Folgenden werden die wichtigsten Elemente der Antwortstruktur dargestellt, die von den InvokeModel Funktionen ohne Streaming Converse zurückgegeben werden. Einzelheiten zur vollständigen Antwortstruktur sowie zu den Anfrage- und Antwortstrukturen für die Streaming-Funktionen finden Sie in der API-Dokumentation.

{
    "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
    }
}

Im Folgenden sind die wichtigsten Antwortelemente aufgeführt:

  • output— (Erforderlich) Enthält die Antwortnachricht des Modells.

    • message— (Erforderlich) Die Antwortnachricht des Assistenten.

      • content— (Erforderlich) Ein Array aus einem oder mehreren Inhaltsblöcken, die Folgendes beinhalten können:

        • reasoningContent— (Optional) Wird zurückgegeben, wenn Argumentation aktiviert war. Enthält den Argumentationstext, der immer [REDACTED] in der Antwort enthalten sein wird.

        • toolUse— (Optional) Wird zurückgegeben, wenn ein Tool aufgerufen wurde. Enthält die Verwendungs-ID, den Namen und die Eingabeargumente des Tools.

        • text— (Optional) Wird zurückgegeben, wenn das Modell mit Textinhalt geantwortet hat.

        • image— (Nur optional) Wird zurückgegeben, wenn das Modell ein Bild generiert hat. Das Format für Bilder, die von generiert wurden, ist immer PNG.

  • stopReason— (Erforderlich) Ein Aufzählungswert, der angibt, warum das Modell keine Ausgabe mehr generiert hat. Zu den unterstützten Werten gehören:

    • end_turn— Das logische Ende der Runde wurde erreicht.

    • max_tokens— Die Ausgabe hat das vom Benutzer festgelegte maxTokens Limit oder das vom Modell selbst festgelegte maximale Ausgabetoken-Limit erreicht.

    • content_filtered— Die Ausgabe des Modells verstieß gegen die Richtlinie AWS für verantwortungsvolle KI.

    • malformed_model_output— Das Modell hat eine ungültige Ausgabe erzeugt.

    • malformed_tool_use— Das Modell hat eine ungültige toolUse Ausgabe erzeugt.

    • service_unavailable— Einer der integrierten Tool-Services konnte nicht erreicht werden.

    • invalid_query— Die Abfrage, die das Modell an das integrierte Web Grounding-Tool gesendet hat, war ungültig.

    • max_tool_invocations— Zeigt an, dass ein integriertes Tool aufgerufen wurde, aber auch nach mehreren Versuchen kein gültiges Ergebnis geliefert hat.

  • usage— (Erforderlich) Informationen zur Token-Nutzung, einschließlich Eingabe-Tokens, Ausgabetokens und Gesamtzahl der Tokens.

  • metrics— (Erforderlich) Leistungskennzahlen, einschließlich der gesamten Inferenzlatenz in Millisekunden.