View a markdown version of this page

Démarrez avec l'API - Amazon Nova
Obtention des informations d’identification pour accorder un accès programmatiqueAttribution des autorisations Amazon Bedrock à un utilisateur ou à un rôleGénérer une réponse à une invite de texte à l’aide d’un modèle Amazon Nova

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Démarrez avec l'API

Avant de commencer APIs, suivez ces procédures si vous utilisez la AWS CLI AWS ou un AWS SDK pour la première fois ou si vous devez les installer. Si aucune de ces conditions ne s'applique à vous, passez àObtention des informations d’identification pour accorder un accès programmatique.

Si vous n'avez pas de AWS compte, suivez les étapes ci-dessous pour en créer un. Vous pouvez également commencer à créer gratuitement avec Amazon Nova sur nova.amazon.com/dev.

Pour créer un AWS compte

  1. Ouvrez l'https://portal.aws.amazon.com/billing/inscription.

  2. Suivez les instructions en ligne.

    Dans le cadre de la procédure d’inscription, vous recevrez un appel téléphonique ou un SMS et vous saisirez un code de vérification en utilisant le clavier numérique du téléphone.

    Lorsque vous créez un AWS compte, un AWS utilisateur root est créé. L'utilisateur root a accès à tous les services et ressources AWS du compte. Pour des raisons de sécurité, attribuez un accès administratif à un utilisateur et utilisez uniquement l'utilisateur root pour effectuer les tâches nécessitant un accès utilisateur root.

AWS vous envoie un e-mail de confirmation une fois le processus d'inscription terminé. À tout moment, vous pouvez consulter l'activité actuelle de votre compte et gérer votre compte en accédant à https://aws.amazon.com/et en choisissant Mon compte.

Sécurisez votre AWS compte (utilisateur root)

  1. Connectez-vous en AWS Management Consoletant que propriétaire du compte en choisissant Utilisateur root et en saisissant l'adresse e-mail de votre AWS compte. Sur la page suivante, saisissez votre mot de passe.

    Pour obtenir de l'aide pour vous connecter en utilisant l'utilisateur root, consultez la section Connexion en tant qu'utilisateur root dans le Guide de l'utilisateur de AWS connexion.

  2. Activez l’authentification multifactorielle (MFA) pour votre utilisateur racine.

    Pour obtenir des instructions, consultez la section Activer un périphérique MFA virtuel pour l'utilisateur root de votre AWS compte (console) dans le guide de l'utilisateur IAM.

Pour installer la AWS CLI, suivez les étapes décrites dans la section Installer ou mettre à jour vers la dernière version de la AWS CLI.

Pour installer un AWS SDK, sélectionnez l'onglet correspondant au langage de programmation que vous souhaitez utiliser dans Tools to Build on AWS.

AWS des kits de développement logiciel (SDKs) sont disponibles pour de nombreux langages de programmation courants. Chaque SDK fournit une API, des exemples de code et de la documentation qui permettent aux développeurs de créer plus facilement des applications dans leur langue préférée. SDKs effectuer automatiquement des tâches utiles pour vous, telles que :

  • Signature cryptographique des requêtes de service

  • Nouvelle tentative de demandes

  • Gestion des réponses d’erreur

Obtention des informations d’identification pour accorder un accès programmatique

Les utilisateurs ont besoin d'un accès programmatique s'ils souhaitent interagir AWS en dehors de la console de AWS gestion. La manière d'accorder un accès programmatique dépend du type d'utilisateur qui y accède AWS.

Pour accorder aux utilisateurs un accès programmatique, choisissez l’une des options suivantes.

Quel principal a besoin d’un accès programmatique ? À En
Utilisateurs IAM Limitez la durée des informations d'identification à long terme pour signer les demandes programmatiques adressées à la AWS CLI AWS SDKs, ou AWS APIs. Suivez les instructions de l’interface que vous souhaitez utiliser.
Rôles IAM Utilisez des informations d'identification temporaires pour signer les demandes programmatiques adressées à la AWS CLI AWS SDKs, ou AWS APIs. Suivez les instructions de la section Utilisation d'informations d'identification temporaires avec AWS des ressources dans le Guide de l'utilisateur IAM.
Utilisateurs gérés dans IAM Identity Center Utilisez des informations d'identification temporaires pour signer les demandes programmatiques adressées à la AWS CLI AWS SDKs, ou AWS APIs. Suivez les instructions de l’interface que vous souhaitez utiliser.

Attribution des autorisations Amazon Bedrock à un utilisateur ou à un rôle

Après avoir configuré les informations d'identification pour l'accès par programmation, vous devez configurer les autorisations pour qu'un utilisateur ou un rôle IAM ait accès aux actions liées à Amazon Bedrock. Pour configurer ces autorisations, procédez comme suit :

  1. Sur la page d'accueil de la console de AWS gestion, sélectionnez le service IAM ou accédez à la console IAM à l'adresse. https://console.aws.amazon.com/iam/

  2. Sélectionnez Utilisateurs ou Rôles, puis votre utilisateur ou votre rôle.

  3. Dans l'onglet Autorisations, choisissez Ajouter des autorisations, puis sélectionnez Ajouter une politique AWS gérée. Choisissez la stratégie gérée par AmazonBedrockFullAccess AWS .

  4. Pour autoriser l’utilisateur ou le rôle à s’abonner à des modèles, choisissez Créer une politique en ligne, puis spécifiez les autorisations suivantes dans l’éditeur JSON :

    {
  "Version": "2012-10-17",	
  "Statement": [
    {
      "Sid": "MarketplaceBedrock",
      "Effect": "Allow",
      "Action": [
        "aws-marketplace:ViewSubscriptions",
        "aws-marketplace:Unsubscribe",
        "aws-marketplace:Subscribe"
      ],
      "Resource": "*"
    }
  ]
}

Générer une réponse à une invite de texte à l’aide d’un modèle Amazon Nova

Une fois que vous avez rempli toutes les conditions requises, vous pouvez tester l'envoi de demandes d'invocation de modèles aux modèles Amazon Nova à l'aide d'une demande Converse.

Pour installer la AWS CLI, suivez les étapes décrites dans la section Installer ou mettre à jour vers la dernière version de la AWS CLI. Vérifiez que vous avez configuré vos informations d’identification pour utiliser Boto3 en suivant les étapes décrites dans Obtention des informations d’identification pour accorder un accès programmatique.

Pour générer une réponse à une invite de texte dans Nova 2 Lite à l'aide de la AWS CLI, exécutez la commande suivante dans un 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"}}'