Conceitos básicos da API da
Antes de começar a usar as APIs, siga esses procedimentos se você for iniciante na AWS ou se precisar instalar a AWS CLI ou um AWS SDK. Se nenhuma dessas opções se aplicar a você, vá para Obter credenciais para conceder acesso programático.
Se você ainda não tem uma conta da AWS, siga as etapas a seguir para criar uma. Como alternativa, você pode começar a criar gratuitamente com o Amazon Nova em nova.amazon.com/dev
Para se cadastrar em uma conta da AWS
-
Abra https://portal.aws.amazon.com/billing/signup
. -
Siga as instruções online.
Parte do procedimento de inscrição envolve receber uma chamada telefônica ou uma mensagem de texto e inserir um código de verificação pelo teclado do telefone.
Quando você cria uma conta da AWS, um usuário-raiz da conta da AWS é criado. O usuário-raiz tem acesso a todos os serviços e recursos da AWS na conta. Como prática recomendada de segurança, atribua o acesso administrativo a um usuário e use somente o usuário-raiz para executar tarefas que exigem acesso de usuário-raiz.
A AWS envia um e-mail de confirmação depois que o processo de inscrição é concluído. A qualquer momento, é possível exibir as atividades da conta atual e gerenciar sua conta acessando https://aws.amazon.com/
Proteja seu usuário raiz da conta da AWS
-
Faça login no Console de gerenciamento da AWS
como o proprietário da conta ao escolher a opção Usuário-raiz e inserir o endereço de e-mail da conta da AWS. Na próxima página, insira a senha. Para obter ajuda ao fazer login usando o usuário-raiz, consulte Fazer login como usuário-raiz no Guia do usuário de Início de Sessão da AWS.
-
Habilite a autenticação multifator (MFA) para o usuário-raiz.
Para obter instruções, consulte Habilitar um dispositivo MFA virtual para o usuário-raiz da sua conta da AWS no Guia do usuário do IAM.
Para instalar a AWS CLI, siga as etapas em Instalar ou atualizar a versão mais recente da AWS CLI.
Para instalar um AWS SDK, selecione a guia que corresponde à linguagem de programação que você deseja usar em Ferramentas para criar na AWS
Os kits de desenvolvimento de software (SDKs) da AWS estão disponíveis para muitas linguagens de programação populares. Cada SDK fornece uma API, exemplos de código e documentação que permitem que os desenvolvedores criem facilmente aplicações em seu idioma de preferência. Os SDKs executam automaticamente tarefas úteis para você, como:
-
Assinar de forma criptográfica as solicitações de serviço
-
Repetir solicitações
-
Lidar com respostas de erro
Obter credenciais para conceder acesso programático
Os usuários precisam de acesso programático se quiserem interagir com a AWS fora do Console de Gerenciamento da AWS. A forma de conceder acesso programático depende do tipo de usuário que está acessando a AWS.
Para conceder acesso programático aos usuários, selecione uma das seguintes opções:
| Qual entidade principal precisa de acesso programático? | Para | Por |
|---|---|---|
| Usuários do IAM | Limite a duração de credenciais de longo prazo para assinar solicitações programáticas para a AWS, os SDKs da AWS ou as APIs da AWS. | Siga as instruções da interface que deseja utilizar.
|
| Perfis do IAM | Use credenciais temporárias para assinar solicitações programáticas para a AWS CLI, SDKs da AWS ou APIs da AWS. | Siga as instruções em Usar credenciais temporárias com recursos da AWS no Guia do usuário do IAM. |
| Usuários gerenciados no Centro de Identidade do IAM | Use credenciais temporárias para assinar solicitações programáticas para a AWS CLI, SDKs da AWS ou APIs da AWS. | Siga as instruções da interface que deseja utilizar.
|
Anexar permissões do Amazon Bedrock a um usuário ou perfil
Depois de configurar as credenciais para acesso programático, você precisa configurar permissões para que um usuário ou um perfil do IAM tenha acesso às ações relacionadas ao Amazon Bedrock. Para configurar essas permissões, faça o seguinte:
-
Na página inicial do Console de Gerenciamento da AWS, selecione o serviço do IAM ou navegue até o console do IAM em https://console.aws.amazon.com/iam/
. -
Selecione Usuários ou Perfis e, em seguida, selecione seu usuário ou perfil.
-
Na guia Permissões, escolha Adicionar permissões e depois Adicionar política gerenciada pela AWS. Escolha a política AmazonBedrockFullAccess gerenciada pela AWS.
-
Para permitir que o usuário ou o perfil assine modelos, escolha Criar política em linha e especifique as seguintes permissões no editor JSON:
{ "Version": "2012-10-17", "Statement": [ { "Sid": "MarketplaceBedrock", "Effect": "Allow", "Action": [ "aws-marketplace:ViewSubscriptions", "aws-marketplace:Unsubscribe", "aws-marketplace:Subscribe" ], "Resource": "*" } ] }
Gerar uma resposta para um prompt de texto usando um modelo do Amazon Nova
Depois de cumprir todos os pré-requisitos, você pode testar realizando solicitações de invocação de modelo para modelos do Amazon Nova com uma solicitação Converse.
Para instalar a AWS CLI, siga as etapas em Instalar ou atualizar a versão mais recente da AWS CLI. Verifique se você configurou suas credenciais para usar o Boto3 seguindo as etapas em Obter credenciais para conceder acesso programático.
Para gerar uma resposta para um prompt de texto no Nova 2 Lite usando a AWS CLI, execute o seguinte comando em um terminal:
aws bedrock-runtime converse \ --model-id us.amazon.nova-2-lite-v1:0 \ --messages '[{"role":"user","content":[{"text":"Write a short poem"}]}]' \ --additional-model-request-fields '{"reasoningConfig":{"type":"enabled","maxReasoningEffort":"low"}}'
