Utilisation de Converse « Hello, World! »

Le text champ correspond à une chaîne spécifiant l'invite. Le text champ est interprété parallèlement aux autres champs qui y sont spécifiés ContentBlock.

(Facultatif) Pour certains modèles, vous pouvez ajouter des points de contrôle du cache à l'aide de cachePoint champs pour utiliser la mise en cache rapide. La mise en cache rapide est une fonctionnalité qui vous permet de commencer à mettre en cache le contexte des conversations afin de réaliser des économies de coûts et de latence. Pour de plus amples informations, veuillez consulter Mise en cache rapide pour une inférence de modèle plus rapide.

L'image suivante montre un objet Message avec un content tableau contenant uniquement du texte ContentBlock:

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

L'image suivante montre un objet Message avec un content tableau contenant un texte ContentBlocket un cachePoint champ facultatif. Le contenu du texte ContentBlockest ainsi ajouté au cache.

{
    "role": "user | assistant",
    "content": [
        {
            "text": "string"
        },
        {
            "cachePoint": {
                "type": "default"
            }
        }
    ]
}

Le image champ correspond à un ImageBlock. Passez les octets bruts, codés en base64, pour une image dans le bytes champ. Si vous utilisez un AWS SDK, vous n'avez pas besoin de coder les octets en base64.

Si vous excluez le text champ, le modèle décrit l'image.

(Facultatif) Pour certains modèles, vous pouvez ajouter des points de contrôle du cache à l'aide de cachePoint champs pour utiliser la mise en cache rapide. La mise en cache rapide est une fonctionnalité qui vous permet de commencer à mettre en cache le contexte des conversations afin de réaliser des économies de coûts et de latence. Pour de plus amples informations, veuillez consulter Mise en cache rapide pour une inférence de modèle plus rapide.

L'image suivante montre un objet Message avec un content tableau contenant uniquement une image ContentBlock:

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

L'image suivante montre un objet Message avec un content tableau contenant une image ContentBlocket un cachePoint champ facultatif. Le contenu de l'image est ainsi ajouté au cache.

{
    "role": "user",
    "content": [
        {
            "image": {
                "format": "png | jpeg | gif | webp",
                "source": {
                    "bytes": "image in bytes"
                }
            }
        },
        {
            "cachePoint": {
                "type": "default"
            }
        }
    ]
}

Le document champ correspond à un DocumentBlock. Si vous incluez unDocumentBlock, vérifiez que votre demande est conforme aux restrictions suivantes :

(Facultatif) Pour certains modèles, vous pouvez ajouter des points de contrôle du cache à l'aide de cachePoint champs pour utiliser la mise en cache rapide. La mise en cache rapide est une fonctionnalité qui vous permet de commencer à mettre en cache le contexte des conversations afin de réaliser des économies de coûts et de latence. Pour de plus amples informations, veuillez consulter Mise en cache rapide pour une inférence de modèle plus rapide.

L'image suivante montre un objet Message avec un content tableau contenant uniquement un document ContentBlocket le texte d'accompagnement obligatoire ContentBlock.

{
    "role": "user",
    "content": [
        {
            "text": "string"
        },
        {
            "document": {
                "format": "pdf | csv | doc | docx | xls | xlsx | html | txt | md",
                "name": "string",
                "source": {
                    "bytes": "document in bytes"
                }
            }
        }
    ]
}

L'image suivante montre un objet Message avec un content tableau contenant un document ContentBlocket le texte d'accompagnement requis ContentBlock, ainsi qu'un CachePoint qui ajoute le contenu du document et du texte au cache.

{
    "role": "user",
    "content": [
        {
            "text": "string"
        },
        {
            "document": {
                "format": "pdf | csv | doc | docx | xls | xlsx | html | txt | md",
                "name": "string",
                "source": {
                    "bytes": "document in bytes"
                }
            }
        },
        {
            "cachePoint": {
                "type": "default"
            }
        }
    ]
}

Le video champ correspond à un VideoBlockobjet. Passez les octets bruts dans le bytes champ, codés en base64. Si vous utilisez le AWS SDK, vous n'avez pas besoin de coder les octets en base64.

Si vous n'incluez pas le text champ, le modèle décrira la vidéo.

L'image suivante montre un objet Message avec un content tableau contenant uniquement une vidéo ContentBlock.

{
    "role": "user",
    "content": [
        {
            "video": {
                "format": "mov | mkv | mp4 | webm | flv | mpeg | mpg | wmv | three_gp",
                "source": {
                    "bytes": "video in bytes"
                }
            }
        }
    ]
}

Notez que pour les fichiers dotés d'une .3gp extension, le format doit être spécifié sous la formethree_gp.

Vous pouvez également transmettre une vidéo via un URI Amazon S3 au lieu de transmettre les octets directement dans le corps de la demande. Ce qui suit montre un Message objet avec un tableau de contenu contenant uniquement une vidéo ContentBlock dont la source vidéo est transmise via un URI Amazon S3.

{
    "role": "user",
    "content": [
        {
            "video": {
                "format": "mov | mkv | mp4 | webm | flv | mpeg | mpg | wmv | three_gp",
                "source": {
                    "s3Location": {
                        "uri": "${S3Uri}",
                        "bucketOwner": "${AccountId}"
                    }
                }
            }
        }
    ]
}

Le s3Location paramètre n'est pris en charge que dans la région de l'est des États-Unis (Virginie du Nord).

Le guardContent champ correspond à un GuardrailConverseContentBlockobjet. Vous pouvez utiliser ce champ pour cibler une entrée à évaluer par le garde-corps défini dans le guardrailConfig champ. Si vous ne spécifiez pas ce champ, le garde-corps évalue tous les messages contenus dans le corps de la demande. Vous pouvez transmettre les types de contenu suivants dans un GuardBlock :

Pour plus d'informations sur l'utilisation des glissières de sécurité, consultez. Bloquez les contenus dangereux dans les modèles utilisant Amazon Bedrock Guardrails

Le reasoningContent champ correspond à un ReasoningContentBlock. Ce bloc contient du contenu concernant le raisonnement qui a été appliqué par le modèle pour générer la réponse dans l'accompagnementContentBlock.

Ce qui suit montre un Message objet avec un content tableau contenant uniquement un ReasoningContentBlock et un texte d'accompagnementContentBlock.

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

ReasoningContentBlockIl contient le raisonnement utilisé pour générer le contenu d'accompagnement reasoningText sur le terrain, en plus de tout contenu du raisonnement crypté par le fournisseur du modèle pour des raisons de confiance et de sécurité redactedContent sur le terrain.

Dans le reasoningText champ, les text champs décrivent le raisonnement. Le signature champ est un hachage de tous les messages de la conversation et constitue une protection contre toute modification du raisonnement utilisé par le modèle. Vous devez inclure la signature et tous les messages précédents dans les Converse demandes suivantes. Si l'un des messages est modifié, la réponse génère une erreur.

Contient des informations sur un outil destiné au modèle à utiliser. Pour de plus amples informations, veuillez consulter Utiliser un outil pour compléter une réponse du modèle Amazon Bedrock.

Contient des informations sur le résultat obtenu par le modèle à l'aide d'un outil. Pour de plus amples informations, veuillez consulter Utiliser un outil pour compléter une réponse du modèle Amazon Bedrock.