Utilizzo dell’API Converse

Il campo text viene mappato a una stringa che specifica il prompt. Il text campo viene interpretato insieme ad altri campi specificati nello stesso ContentBlock.

Quanto segue mostra un oggetto Message con una content matrice contenente solo un testo ContentBlock:

{
    "role": "user",
    "content": [
        {
            "text": "string"
        }
    ]
}

Il image campo è mappato su un ImageBlock. Passa i byte non elaborati, con codifica base64, per un’immagine nel campo bytes. Se si utilizza un AWS SDK, non è necessario codificare i byte in base64.

Se si esclude il campo text, il modello descrive l’immagine.

Quanto segue mostra un esempio di oggetto Message con un content array contenente solo un'immagine: ContentBlock

{
    "role": "user",
    "content": [
        {
            "image": {
                "format": "png",
                "source": {
                    "bytes": "image in bytes"
                }
            }
        }
    ]
}

È anche possibile specificare un URI Amazon S3 anziché passare i byte direttamente nel corpo della richiesta. Di seguito viene mostrato un oggetto Message di esempio con un array di contenuti in cui è inclusa l’origine passata tramite un URI Amazon S3.

{
    "role": "user",
    "content": [
        {
            "image": {
                "format": "png",
                "source": {
                    "s3Location": {
                        "uri": "s3://amzn-s3-demo-bucket/myImage",
                        "bucketOwner": "111122223333"
                    }
                }
            }
        }
    ]
}

Il document campo è mappato su un DocumentBlock. Se si include un oggetto DocumentBlock, verificare che la richiesta sia conforme alle seguenti restrizioni:

Quando si utilizza un documento, è possibile abilitare il tag citations, che fornisce citazioni specifiche del documento nella risposta alla chiamata API. Consulta l'DocumentBlockAPI per maggiori dettagli.

Quanto segue mostra un oggetto Message di esempio con un content array contenente solo un documento ContentBlocke un testo ContentBlockdi accompagnamento obbligatorio.

{
    "role": "user",
    "content": [
        {
            "text": "string"
        },
        {
            "document": {
                "format": "pdf",
                "name": "MyDocument",
                "source": {
                    "bytes": "document in bytes"
                }
            }
        }
    ]
}

È anche possibile specificare un URI Amazon S3 anziché passare i byte direttamente nel corpo della richiesta. Di seguito viene mostrato un oggetto Message di esempio con un array di contenuti in cui è inclusa l’origine passata tramite un URI Amazon S3.

{
    "role": "user",
    "content": [
        {
            "text": "string"
        },
        {
            "document": {
                "format": "pdf",
                "name": "MyDocument",
                "source": {
                    "s3Location": {
                      "uri": "s3://amzn-s3-demo-bucket/myDocument",
                      "bucketOwner": "111122223333"
                    }
                }
            }
        }
    ]
}

Il video campo è mappato a un VideoBlockoggetto. Passa i byte non elaborati nel campo bytes con codifica base64. Se si utilizza l'AWSSDK, non è necessario codificare i byte in base64.

Se non si include il campo text, il modello descrive il video.

Quanto segue mostra un oggetto Message di esempio con un content array contenente solo un video. ContentBlock

{
    "role": "user",
    "content": [
        {
            "video": {
                "format": "mp4",
                "source": {
                    "bytes": "video in bytes"
                }
            }
        }
    ]
}

È anche possibile specificare un URI Amazon S3 anziché passare i byte direttamente nel corpo della richiesta. Di seguito viene mostrato un oggetto Message di esempio con un array di contenuti in cui è inclusa l’origine passata tramite un URI Amazon S3.

{
    "role": "user",
    "content": [
        {
            "video": {
                "format": "mp4",
                "source": {
                    "s3Location": {
                        "uri": "s3://amzn-s3-demo-bucket/myVideo",
                        "bucketOwner": "111122223333"
                    }
                }
            }
        }
    ]
}

È possibile aggiungere punti di controllo della cache come blocco in un messaggio insieme a un prompt associato tramite i campi cachePoint per utilizzare il caching dei prompt. Il caching dei prompt è una funzionalità che consente di iniziare a memorizzare nella cache il contesto delle conversazioni per ottenere risparmi in termini di costi e latenza. Per ulteriori informazioni, consulta Caching dei prompt per un’inferenza del modello più rapida.

Di seguito viene illustrato un oggetto Message di esempio con un content array contenente un documento ContentBlocke il testo di accompagnamento obbligatorio ContentBlock, nonché un CachePoint che aggiunge sia il contenuto del documento che quello del testo alla cache.

{
    "role": "user",
    "content": [
        {
            "text": "string"
        },
        {
            "document": {
                "format": "pdf",
                "name": "string",
                "source": {
                    "bytes": "document in bytes"
                }
            }
        },
        {
            "cachePoint": {
                "type": "default"
            }
        }
    ]
}

Il guardContent campo è mappato a un oggetto. GuardrailConverseContentBlock È possibile utilizzare questo campo per specificare un input che deve essere valutato dal guardrail definito nel campo guardrailConfig. Se non si specifica questo campo, il guardrail valuta tutti i messaggi nel corpo della richiesta. In un oggetto GuardBlock, si possono passare i seguenti tipi di contenuto:

Per ulteriori informazioni sull’utilizzo dei guardrail, consulta Rilevare e filtrare contenuti dannosi utilizzando Guardrail per Amazon Bedrock.

Il reasoningContent campo è mappato su un ReasoningContentBlock. Questo blocco include contenuti riguardanti il ragionamento che è stato eseguito dal modello per generare la risposta nell’oggetto ContentBlock associato.

Di seguito viene mostrato un oggetto Message con un array content contenente solo un oggetto ReasoningContentBlock e un oggetto ContentBlock testo associato.

{
    "role": "user",
    "content": [
        {
            "text": "string"
        },
        {
            "reasoningContent": {
                "reasoningText": {
                    "text": "string",
                    "signature": "string"
                }
                "redactedContent": "base64-encoded binary data object"
            }
        }
    ]
}

L’oggetto ReasoningContentBlock contiene il ragionamento utilizzato per generare il contenuto associato nel campo reasoningText, oltre a qualsiasi contenuto del ragionamento crittografato dal provider del modello per motivi di affidabilità e sicurezza nel campo redactedContent.

Nel campo reasoningText, i campi text descrivono il ragionamento. Il campo signature è un hash di tutti i messaggi della conversazione ed è una protezione contro la manomissione del ragionamento utilizzato dal modello. È necessario includere la firma e tutti i messaggi precedenti nelle richieste Converse successive. Se uno qualsiasi dei messaggi viene modificato, la risposta genera un errore.

Contiene informazioni su uno strumento che il modello può utilizzare. Per ulteriori informazioni, consulta Utilizzo di uno strumento per completare una risposta al modello Amazon Bedrock.

Contiene informazioni sul risultato ottenuto dal modello con l’utilizzo di uno strumento. Per ulteriori informazioni, consulta Utilizzo di uno strumento per completare una risposta al modello Amazon Bedrock.