Create your Automated Reasoning policy

When you create an Automated Reasoning policy, your input source document is translated into a set of formal logic rules and a schema of variables and types.

Example: If your source document contains an HR policy stating "Full-time employees who have worked for at least 1 year are eligible for parental leave," Automated Reasoning would extract variables like is_full_time (boolean), years_of_service (integer), and eligible_for_parental_leave (boolean), along with a rule that connects them.

Note

Tutorial video: For a step-by-step walkthrough of creating an Automated Reasoning policy, watch the following tutorial:

Tutorial Demo 1 - Policy creation in Automated Reasoning checks

Create your Automated Reasoning policy in the console

1. In the left navigation, choose Automated Reasoning, and then choose Create policy.

2. Enter a Name for the policy.

3. (Optional) Enter a Description for the policy.

4. For Source, you need to provide a document that describes the rules and policies of your knowledge domain. This document should contain the business rules, policies, or guidelines that you want Automated Reasoning to validate against. For example, you might upload an HR policy document that defines employee benefits eligibility, a compliance manual that outlines regulatory requirements, or a technical specification that describes system constraints. The document should be comprehensive and clearly written, as Automated Reasoning will extract formal logic rules from this content.

   Note

   Best practice: For complex policies, it's better to split the content into digestible chunks and progressively import new content into a policy to make it more complex. Start with a focused subset of your rules, create and test the policy thoroughly, then gradually add more content in subsequent iterations. This approach helps you identify and resolve issues early, ensures each addition works correctly with existing rules, and makes troubleshooting easier when problems arise.

   Do the following:

   1. For Ingest method, do one of the following:

      1. Select Upload document, then select Choose file. Upload a PDF document of the source content that will serve as the basis for your policy.

      2. Select Enter text. Paste or enter your source content that will serve as the basis for your policy.

   2. (Recommended) For Instructions, specify additional information on how to process your source document. While optional, providing information on how the policy will be used and what parts of the document to focus on or ignore help the logic extraction process.

      Note

      Instructions should explain what type of questions the policy will be validating, describe the structure of the input document, and give an example of the type of questions users will ask. For example: "This policy will validate HR questions about leave eligibility. The document has sections on different leave types. Users will ask questions like 'Am I eligible for parental leave if I've worked here for 9 months?'"

5. (Optional) For Tags, choose Add new tag to tag your policy. Tags can help you manage, filter, and search for your AWS resources.

6. Choose Create policy.

Create your Automated Reasoning policy using the API

You can use the CreateAutomatedReasoningPolicy API operation to create an Automated Reasoning policy programmatically.

Request parameters

The following parameters are required or optional when creating an Automated Reasoning policy:

name (required)

The name of the Automated Reasoning policy. The name must be unique within your AWS account and Region.

description (optional)

A description of the Automated Reasoning policy. Use this to provide context about the policy's purpose and the types of validations it performs.

clientRequestToken (optional)

A unique, case-sensitive identifier to ensure that the operation completes no more than once. If this token matches a previous request, Amazon Bedrock ignores the request but doesn't return an error.

policyDefinition (optional)

The policy definition that contains the formal logic rules, variables, and custom variable types used to validate foundation model responses in your application.

tags (optional)

A list of tags to associate with the Automated Reasoning policy. Tags help you organize and manage your policies.

Response elements

The API returns the following information:

policyArn

The Amazon Resource Name (ARN) of the Automated Reasoning policy that you created.

version

The version of the Automated Reasoning policy. The initial version is DRAFT.

name

The name of the Automated Reasoning policy.

Example

The following example shows how to create an Automated Reasoning policy using the AWS CLI:

aws bedrock create-automated-reasoning-policy \
  --name "DeleteMe" \
  --description "A Test AR Policy" \
  --source-document file://policy-document.pdf

Example response:

{
  "createdAt": "2025-07-21T14:43:52.692Z",
  "definitionHash": "f16ba1ceca36e1d21adce559481add6a4998b79ae203d933fd0206a28d5c2896513dd62f57b293cba282441269a72063b1d9da02fcf2b421e9bf8495ff8c87af",
  "description": "A Test AR Policy",
  "name": "DeleteMe",
  "policyArn": "arn:aws:bedrock:us-east-1:286352875722:automated-reasoning-policy/lnq5hhz70wgk",
  "updatedAt": "2025-07-21T14:43:52.692Z",
  "version": "DRAFT"
}

View Automated Reasoning policy details

After you create your policy, you can view its the translated logic and variables on the policy's Definitions page.