Execute exemplos de API solicitações do Amazon Bedrock com o AWS Command Line Interface

Esta seção orienta você a experimentar algumas operações comuns no Amazon Bedrock para testar se suas permissões e autenticação estão configuradas corretamente. Antes de executar os exemplos a seguir, verifique se você atendeu aos seguintes pré-requisitos:

Pré-requisitos

• Você tem Conta da AWS e tem permissões para acessar uma função com as permissões necessárias para o Amazon Bedrock. Caso contrário, siga as etapas emEu já tenho um Conta da AWS.

• Você solicitou acesso ao Amazon Titan Text G1 - Express modelo. Caso contrário, siga as etapas emSolicite acesso a um modelo da Amazon Bedrock Foundation.

• Você recebeu as chaves de acesso IAM do seu usuário e configurou um perfil com elas. Caso contrário, siga as etapas aplicáveis ao seu caso de uso emObtenha credenciais para conceder acesso programático a um usuário.

Teste se suas permissões e chaves de acesso estão configuradas corretamente para o Amazon Bedrock, usando a função Amazon Bedrock que você criou. Esses exemplos pressupõem que você tenha configurado um perfil padrão com suas chaves de acesso. Observe o seguinte:

• No mínimo, você deve configurar um perfil contendo uma ID de chave de AWS acesso e uma chave de acesso AWS secreta.

• Se você estiver usando credenciais temporárias, também deverá incluir um token de AWS sessão.

Liste os modelos básicos que o Amazon Bedrock tem a oferecer

O exemplo a seguir executa a ListFoundationModelsoperação usando um endpoint Amazon Bedrock. ListFoundationModelslista os modelos de fundação (FMs) que estão disponíveis no Amazon Bedrock em sua região. Em um terminal, execute o seguinte comando:

aws bedrock list-foundation-models --region us-east-1

Se o comando for bem-sucedido, a resposta retornará uma lista de modelos básicos que estão disponíveis no Amazon Bedrock.

Envie uma solicitação de texto para um modelo e gere uma resposta de texto com InvokeModel

O exemplo a seguir executa a InvokeModeloperação usando um endpoint de tempo de execução do Amazon Bedrock. InvokeModelpermite que você envie uma solicitação para gerar uma resposta do modelo. Em um terminal, execute o seguinte comando:

aws bedrock-runtime invoke-model \
--model-id amazon.titan-text-express-v1 \
--body '{"inputText": "Describe the purpose of a \"hello world\" program in one line.", "textGenerationConfig" : {"maxTokenCount": 512, "temperature": 0.5, "topP": 0.9}}' \
--cli-binary-format raw-in-base64-out \
--outfile invoke-model-output-text.txt

Se o comando for bem-sucedido, a resposta gerada pelo modelo será gravada no invoke-model-output-text.txt arquivo. A resposta em texto é retornada no outputText campo, junto com as informações que a acompanham.

Envie uma solicitação de texto para um modelo e gere uma resposta de texto com o Converse

O exemplo a seguir executa a operação Converse usando um endpoint de tempo de execução do Amazon Bedrock. Conversepermite que você envie uma solicitação para gerar uma resposta do modelo. Recomendamos usar a Converse operação InvokeModel quando houver suporte, pois ela unifica a solicitação de inferência nos modelos do Amazon Bedrock e simplifica o gerenciamento de conversas em vários turnos. Em um terminal, execute o seguinte comando:

aws bedrock-runtime converse \
--model-id amazon.titan-text-express-v1 \
--messages '[{"role": "user", "content": [{"text": "Describe the purpose of a \"hello world\" program in one line."}]}]' \
--inference-config '{"maxTokens": 512, "temperature": 0.5, "topP": 0.9}'

Se o comando for bem-sucedido, a resposta gerada pelo modelo será retornada no text campo, junto com as informações que o acompanham.