View a markdown version of this page

Erste Schritte mit der -API - Amazon Nova
Einholen von Anmeldeinformationen, um programmgesteuerten Zugriff zu gewährenAnfügen von Amazon-Bedrock-Berechtigungen an einen Benutzer oder eine RolleEine Antwort auf einen Text-Prompt mithilfe eines Amazon-Nova-Modells generieren

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Erste Schritte mit der -API

Bevor Sie mit APIs beginnen, gehen Sie wie folgt vor, falls Sie die AWS CLI AWS oder ein AWS SDK noch nicht kennen oder installieren müssen. Wenn keines davon auf Sie zutrifft, wechseln Sie zuEinholen von Anmeldeinformationen, um programmgesteuerten Zugriff zu gewähren.

Wenn Sie noch kein AWS Konto haben, erstellen Sie eines, bevor Sie fortfahren. Alternativ können Sie mit Amazon Nova unter nova.amazon kostenlos mit dem Bauen beginnen. com/dev.

Melde dich an für AWS-Konto

Um damit zu beginnen AWS, benötigen Sie eine AWS-Konto. Informationen zum Erstellen einer AWS-Konto finden Sie AWS-Konto im AWS -Kontenverwaltung Referenzhandbuch unter Erste Schritte mit einer.

Um die AWS CLI zu installieren, folgen Sie den Schritten unter Installieren oder Aktualisieren der CLI auf die neueste Version der AWS CLI.

Um ein AWS SDK zu installieren, wählen Sie unter Tools to Build on die Registerkarte aus, die der Programmiersprache entspricht, die Sie verwenden möchten AWS.

AWS Software Development Kits (SDKs) sind für viele gängige Programmiersprachen verfügbar. Jedes SDK bietet eine API, Codebeispiele und Dokumentation, die es Entwicklern erleichtern, Anwendungen in ihrer bevorzugten Sprache zu erstellen. SDKs erledigen automatisch nützliche Aufgaben für Sie, zum Beispiel:

  • Kryptographisches Signieren Ihrer Serviceanforderungen

  • Wiederholungsanforderungen

  • Umgang mit Fehlerantworten

Einholen von Anmeldeinformationen, um programmgesteuerten Zugriff zu gewähren

Benutzer benötigen programmgesteuerten Zugriff, wenn sie AWS außerhalb der AWS Management Console mit ihnen interagieren möchten. Die Art und Weise, wie programmgesteuerter Zugriff gewährt wird, hängt vom Benutzertyp ab, der zugreift. AWS

Um Benutzern programmgesteuerten Zugriff zu gewähren, wählen Sie eine der folgenden Optionen.

Welcher Prinzipal benötigt programmgesteuerten Zugriff? Bis Von
IAM-Benutzer Beschränken Sie die Dauer langfristiger Anmeldeinformationen, um programmatische Anfragen an die AWS CLI, AWS SDKs oder APIs zu signieren. AWS Befolgen Sie die Anweisungen für die Schnittstelle, die Sie verwenden möchten.
IAM-Rollen Verwenden Sie temporäre Anmeldeinformationen, um programmatische Anfragen an die AWS CLI, AWS SDKs oder APIs zu signieren. AWS Folgen Sie den Anweisungen unter Verwenden temporärer Anmeldeinformationen mit AWS Ressourcen im IAM-Benutzerhandbuch.
Im IAM Identity Center verwaltete Benutzer Verwenden Sie temporäre Anmeldeinformationen, um programmatische Anfragen an die AWS CLI, AWS SDKs oder APIs zu signieren. AWS Befolgen Sie die Anweisungen für die Schnittstelle, die Sie verwenden möchten.

Anfügen von Amazon-Bedrock-Berechtigungen an einen Benutzer oder eine Rolle

Nachdem Sie die Anmeldeinformationen für den programmatischen Zugriff eingerichtet haben, müssen Sie die Berechtigungen für einen Benutzer oder eine IAM-Rolle konfigurieren, um Zugriff auf Amazon-Aktionen zu erhalten. Bedrock-related Gehen Sie folgendermaßen vor, um diese Berechtigungen einzurichten:

  1. Wählen Sie auf der Startseite der AWS Management Console den IAM-Service aus oder navigieren Sie zur IAM-Konsole unter. https://console.aws.amazon.com/iam/

  2. Wählen Sie Benutzer oder Rollen und dann Ihren Benutzer oder Ihre Rolle aus.

  3. Wählen Sie auf der Registerkarte „Berechtigungen“ die Option „Berechtigungen hinzufügen“ und dann „ AWS Verwaltete Richtlinie hinzufügen“ aus. Wählen Sie die verwaltete AmazonBedrockFullAccess AWS -Richtlinie.

  4. Um dem Benutzer oder der Rolle das Abonnieren von Modellen zu ermöglichen, wählen Sie Inline-Richtlinie erstellen und geben Sie dann die folgenden Berechtigungen im JSON-Editor an:

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

Eine Antwort auf einen Text-Prompt mithilfe eines Amazon-Nova-Modells generieren

Nachdem Sie alle Voraussetzungen erfüllt haben, können Sie mit einer https://docs.aws.amazon.com/bedrock/latest/APIReference/API_runtime_Converse.html Converse-Anfrage testen, wie Sie Modellaufrufanfragen an Amazon Nova-Modelle stellen.

Um die AWS CLI zu installieren, folgen Sie den Schritten unter Installieren oder Aktualisieren der CLI auf die neueste Version der AWS CLI. Überprüfen Sie, ob Sie Ihre Anmeldeinformationen für die Verwendung von Boto3 gemäß den Schritten unter Einholen von Anmeldeinformationen, um programmgesteuerten Zugriff zu gewähren konfiguriert haben.

Um mithilfe der AWS CLI eine Antwort für eine Textaufforderung in Nova 2 Lite zu generieren, führen Sie den folgenden Befehl in einem Terminal aus:

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"}}'