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.

Erstellen der Automated-Reasoning-Richtlinie

Wenn Sie eine Richtlinie für automatisiertes Denken erstellen, wird Ihr Quelldokument in eine Reihe formaler Logikregeln und ein Schema von Variablen und Typen übersetzt. Auf dieser Seite erfahren Sie, wie Sie Ihr Dokument vorbereiten, die Richtlinie erstellen und die Ergebnisse überprüfen.

Amazon Bedrock verschlüsselt Ihre Automated-Reasoning-Richtlinie mittels AWS Key Management Service (KMS). Standardmäßig verwendet Amazon Bedrock einen diensteigenen Schlüssel. Sie können optional einen vom Kunden verwalteten KMS-Schlüssel angeben, um die Verschlüsselung Ihrer Richtliniendaten weiter kontrollieren zu können.

Stellen Sie sicher, dass Sie über die entsprechenden Berechtigungen verfügen, um Ihre Richtlinie für automatisiertes Denken zu testen und zu verwenden.

Bereiten Sie Ihr Quelldokument vor

Bevor Sie die Konsole öffnen oder die API aufrufen, bereiten Sie das Dokument vor, das Automated Reasoning zum Extrahieren von Regeln und Variablen verwenden wird. Die Qualität Ihrer Richtlinie hängt direkt von der Qualität dieser Informationen ab.

Struktur und Klarheit der Dokumente

Automatisierte Prüfungen zur Argumentation funktionieren am besten bei Dokumenten, die klare, unmissverständliche Regeln enthalten. Jede Regel sollte eine Bedingung und ein Ergebnis angeben. Vermeiden Sie vage Formulierungen, subjektive Kriterien oder Regeln, die von einem externen Kontext abhängen, der im Dokument nicht enthalten ist.

Beispiel: Klare oder vage Regeln

Größenbeschränkungen und Aufteilung großer Dokumente

Quelldokumente sind auf eine Größe von 5 MB und 50.000 Zeichen begrenzt. Bilder und Tabellen in Dokumenten werden ebenfalls auf die Zeichenbeschränkung angerechnet.

Wenn Ihr Dokument diese Grenzwerte überschreitet oder wenn es mehrere Bereiche abdeckt, die nichts miteinander zu tun haben, teilen Sie es in spezielle Abschnitte auf. Teilen Sie beispielsweise ein Mitarbeiterhandbuch in separate Dokumente auf, in denen die Urlaubsregelungen, die Inanspruchnahme von Leistungen und die Kostenerstattung behandelt werden. Erstellen Sie Ihre Richtlinie mit dem ersten Abschnitt und führen Sie dann die iterative Richtlinienerstellung (später auf dieser Seite beschrieben) durch, um weitere Abschnitte zu derselben Richtlinie zusammenzuführen.

Verarbeiten Sie komplexe Dokumente vorab

Dokumente, die viele Textbausteine, Haftungsausschlüsse oder Inhalte enthalten, die nichts mit den Regeln zu tun haben, die Sie durchsetzen möchten, führen zu überflüssigen Richtlinien mit unnötigen Variablen und Regeln. Beachten Sie vor dem Hochladen Folgendes:

Schreiben Sie effektive Anweisungen

Bei der Erstellung einer Richtlinie können Sie optionale Anweisungen angeben, die angeben, wie Automated Reasoning Ihr Quelldokument verarbeitet. Gute Anweisungen sind zwar optional, verbessern aber die Qualität der extrahierten Regeln und Variablen erheblich.

Effektive Anweisungen sollten drei Dinge umfassen:

Beispiel für eine Anweisung:

This policy will validate HR questions about leave eligibility. The document
has sections on different leave types (parental, medical, bereavement, personal).
Users will ask questions like "Am I eligible for parental leave if I've worked
here for 9 months?" or "Can part-time employees take bereavement leave?"
Focus on the eligibility criteria for each leave type. Capture variables that
help determine whether an employee is eligible for a specific type of leave.

Erstellen Sie eine Richtlinie in der Konsole

Erstellen Sie mithilfe der API eine Richtlinie

Eine Richtlinie für automatisiertes Denken ist eine Ressource in Ihrem AWS-Konto, die durch einen Amazon-Ressourcennamen (ARN) identifiziert wird. Das Erstellen einer Richtlinie über die API erfolgt in zwei Schritten: Erstellen Sie zuerst die Richtlinienressource und starten Sie dann einen Build-Workflow, um Regeln aus Ihrem Dokument zu extrahieren.

Schritt 1: Erstellen Sie die Richtlinienressource

Verwenden Sie die CreateAutomatedReasoningPolicy API, um die Richtlinienressource zu erstellen.

Beispiel:

aws bedrock create-automated-reasoning-policy \
  --name "MyHRPolicy" \
  --description "Validates HR chatbot responses about leave eligibility" \
  --kms-key-id arn:aws:kms:us-east-1:111122223333:key/12345678-1234-1234-1234-123456789012

Beispielantwort:

{
  "createdAt": "2025-07-21T14:43:52.692Z",
  "definitionHash": "f16ba1ceca36e1d21adce559481add6a...",
  "name": "MyHRPolicy",
  "policyArn": "arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk",
  "updatedAt": "2025-07-21T14:43:52.692Z",
  "version": "DRAFT"
}

Schritt 2: Starten Sie einen Build-Workflow zum Extrahieren von Regeln

Verwenden Sie die StartAutomatedReasoningPolicyBuildWorkflow API mit dem Richtlinien-ARN aus Schritt 1, um Regeln und Variablen aus Ihrem Quelldokument zu extrahieren.

Beispiel:

# Encode your PDF to base64
PDF_BASE64=$(base64 -i your-policy.pdf | tr -d '\n')

# Start the build workflow
aws bedrock start-automated-reasoning-policy-build-workflow \
  --policy-arn arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk \
  --build-workflow-type INGEST_CONTENT \
  --source-content "{
    \"policyDefinition\": {
      \"version\": \"1.0\",
      \"types\": [],
      \"rules\": [],
      \"variables\": []
    },
    \"workflowContent\": {
      \"documents\": [
        {
          \"document\": \"$PDF_BASE64\",
          \"documentContentType\": \"pdf\",
          \"documentName\": \"HR Leave Policy\",
          \"documentDescription\": \"Validates HR chatbot responses about leave eligibility. Users ask questions like 'Am I eligible for parental leave?'\"
        }
      ]
    }
  }"

Beispielantwort:

{
  "policyArn": "arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk",
  "buildWorkflowId": "d40fa7fc-351e-47d8-a338-53e4b3b1c690"
}

Überprüfen Sie den Build-Status mitListAutomatedReasoningPolicyBuildWorkflows:

aws bedrock list-automated-reasoning-policy-build-workflows \
  --policy-arn arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk

Überprüfen Sie die extrahierte Richtlinie

Überprüfen Sie nach Abschluss eines Builds die extrahierte Richtliniendefinition, bevor Sie mit dem Testen beginnen. Das Erkennen von Problemen in dieser Phase spart Zeit im Vergleich zu deren Entdeckung durch fehlgeschlagene Tests zu einem späteren Zeitpunkt.

Öffnen Sie in der Konsole Ihre Richtlinie und rufen Sie die Definitionsseite auf. Verwenden Sie GetAutomatedReasoningPolicyBuildWorkflowResultAssets with über die API, --asset-type POLICY_DEFINITION um die extrahierte Definition und --asset-type QUALITY_REPORT den Qualitätsbericht abzurufen. Mithilfe des --asset-type ASSET_MANIFEST Parameters können Sie sich eine vollständige Liste der während des Workflows erstellten Assets anzeigen lassen, z. B. den Genauigkeitsbericht.

Überprüfen Sie, ob folgende Probleme auftreten:

Lesen Sie den Fidelity-Bericht

Wenn Sie eine Richtlinie aus einem Quelldokument erstellen, wird zusammen mit der extrahierten Richtlinie automatisch ein Zuverlässigkeitsbericht generiert. Der Zuverlässigkeitsbericht misst, wie genau die Richtlinie Ihren Quellinhalt wiedergibt, und bietet eine detaillierte Begründung, die jede Regel und Variable mit bestimmten Aussagen im Dokument verknüpft. Weitere Informationen zu den Konzepten von Fidelity-Berichten finden Sie unterFidelity-Bericht.

Sehen Sie sich den Fidelity-Bericht in der Konsole an

Öffnen Sie in der Konsole Ihre Richtlinie und wählen Sie den Tab Quelldokument (neben Definitionen). In der Ansicht „Quellinhalt“ wird jede aus Ihrem Dokument extrahierte atomare Aussage als nummerierte Zeile in einer Tabelle angezeigt. Jede Zeile zeigt:

Verwenden Sie die Dropdownfilter Regeln und Variablen oben in der Tabelle, um sich auf Aussagen zu konzentrieren, die einer bestimmten Regel oder Variablen zugrunde liegen. Verwenden Sie die Suchleiste, um bestimmte Inhalte in den extrahierten Anweisungen zu finden.

Wenn Sie die Richtlinie nach der ersten Extraktion bearbeiten, z. B. indem Sie Regeln ändern oder Variablen hinzufügen, wählen Sie die Schaltfläche „Erneut erstellen“, um den Zuverlässigkeitsbericht so zu aktualisieren, dass er Ihre aktuelle Richtliniendefinition widerspiegelt.

Überprüfen Sie den Treuebericht mithilfe der API

Verwenden Sie GetAutomatedReasoningPolicyBuildWorkflowResultAssets with--asset-type FIDELITY_REPORT, um den Treuebericht abzurufen. Um den Bericht nach Richtlinienänderungen erneut zu generieren, verwenden Sie ihn StartAutomatedReasoningPolicyBuildWorkflow zusammen mit dem Workflowtyp Build GENERATE_FIDELITY_REPORT und geben Sie die Quelldokumente in das generateFidelityReportContent Feld ein. Der Workflow analysiert die Dokumente erneut anhand der aktuellen Richtliniendefinition und erstellt einen neuen Zuverlässigkeitsbericht. Sie können auch die ursprünglichen Quelldokumente aus einem früheren Build-Workflow abrufen, indem Sie den --asset-id Parameter verwenden --asset-type SOURCE_DOCUMENT (die Asset-ID aus dem Asset-Manifest abrufen).

Worauf zu achten ist

Achten Sie bei der Überprüfung des APIs Kundenbindungsberichts von auf Folgendes:

Iterative Politikgestaltung

Bei komplexen Domänen sollten Sie Ihre Richtlinie schrittweise erstellen, anstatt zu versuchen, alles in einem einzigen Dokument-Upload zu erfassen. Beginnen Sie mit einer bestimmten Teilmenge Ihrer Regeln, erstellen und testen Sie die Richtlinie und fügen Sie dann in nachfolgenden Iterationen weitere Inhalte hinzu.

Fügen Sie Inhalte in der Konsole hinzu

Fügen Sie Inhalte mithilfe der API hinzu

Rufen Sie StartAutomatedReasoningPolicyBuildWorkflow mit an INGEST_CONTENT und übergeben Sie die vollständige aktuelle Richtliniendefinition zusammen mit dem neuen Dokument. Sie müssen die vollständige bestehende Definition — Regeln, Variablen und Typen — angeben, damit der neue Inhalt mit der vorhandenen Richtlinie zusammengeführt wird, anstatt sie zu ersetzen.

# First, retrieve the current policy definition
aws bedrock get-automated-reasoning-policy \
  --policy-arn arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk

# Encode the new document
PDF_BASE64=$(base64 -i additional-rules.pdf | tr -d '\n')

# Start a build workflow with the existing definition + new document
aws bedrock start-automated-reasoning-policy-build-workflow \
  --policy-arn arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/lnq5hhz70wgk \
  --build-workflow-type INGEST_CONTENT \
  --source-content "{
    \"policyDefinition\": EXISTING_POLICY_DEFINITION_JSON,
    \"workflowContent\": {
      \"documents\": [
        {
          \"document\": \"$PDF_BASE64\",
          \"documentContentType\": \"pdf\",
          \"documentName\": \"Additional Benefits Rules\",
          \"documentDescription\": \"Additional rules covering medical and bereavement leave eligibility.\"
        }
      ]
    }
  }"

KMS-Berechtigungen für Automated-Reasoning-Richtlinien

Wenn Sie einen vom Kunden verwalteten KMS-Schlüssel zur Verschlüsselung Ihrer Automated-Reasoning-Richtlinie angeben, müssen Sie Berechtigungen konfigurieren, mit denen Amazon Bedrock den Schlüssel in Ihrem Namen verwenden kann.

Berechtigungen für Schlüsselrichtlinien

Fügen Sie Ihrer KMS-Schlüsselrichtlinie die folgende Anweisung hinzu, sodass Amazon Bedrock den Schlüssel für Automated-Reasoning-Richtlinien verwenden kann:

{
  "Sid": "PermissionsForAutomatedReasoningPolicy",
  "Effect": "Allow",
  "Principal": {
    "AWS": "arn:aws:iam::111122223333:user/role"
  },
  "Action": [
    "kms:Decrypt",
    "kms:DescribeKey",
    "kms:GenerateDataKey"
  ],
  "Resource": "*",
  "Condition": {
    "StringEquals": {
      "kms:EncryptionContext:aws:bedrock:automated-reasoning-policy": [
        "arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/policy-id",
        "arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/policy-id:*"
      ],
      "kms:ViaService": "bedrock.us-east-1.amazonaws.com"
    }
  }
}

IAM-Berechtigungen

Ihr IAM-Prinzipal muss über die folgenden Berechtigungen verfügen, um einen vom Kunden verwalteten KMS-Schlüssel mit Automated-Reasoning-Richtlinien verwenden zu können:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "AllowKMSForAutomatedReasoningPolicy",
      "Effect": "Allow",
      "Action": [
        "kms:Decrypt",
        "kms:DescribeKey",
        "kms:GenerateDataKey"
      ],
      "Resource": "arn:aws:kms:us-east-1:111122223333:key/key-id",
      "Condition": {
        "StringEquals": {
          "kms:EncryptionContext:aws:bedrock:automated-reasoning-policy": [
            "arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/policy-id",
            "arn:aws:bedrock:us-east-1:111122223333:automated-reasoning-policy/policy-id:*"
          ],
          "kms:ViaService": "bedrock.us-east-1.amazonaws.com"
        }
      }
    }
  ]
}

Verschlüsselungskontext

Amazon Bedrock verwendet den Verschlüsselungskontext, um zusätzliche Sicherheit für Ihre Automated-Reasoning-Richtlinien zu bieten. Der Verschlüsselungskontext besteht aus einer Reihe von Schlüssel-Wert-Paaren, die als zusätzliche authentifizierte Daten beim Verschlüsseln und Entschlüsseln Ihrer Richtlinie verwendet werden.

Für Automated-Reasoning-Richtlinien verwendet Amazon Bedrock den folgenden Verschlüsselungskontext: