Create a dataset - Amazon IoT SiteWise
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Create a dataset

Note

The SiteWise Monitor feature will no longer be open to new customers starting November 7, 2025 . If you would like to use SiteWise Monitor, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see SiteWise Monitor availability change.

Note

The Amazon IoT SiteWise Assistant must use a dataset with an Amazon Kendra index for enterprise level knowledge and guidance. If you do not have a Amazon Kendra index, see Creating an index to create one. Adding a dataset improves the quality of the Assistant's response, and minimizes hallucinations.

Console
Create a dataset in the Amazon IoT SiteWise console

  1. Datasets are displayed in the Datasets section of the Amazon IoT SiteWise Assistant page.

  2. If no datasets exist, choose Create dataset.

  3. In the Dataset details page, choose a Kendra index from the drop down menu to associate with the dataset.

  4. The dataset name is populated by the Kendra index selected in Step 3. Edit the name if needed.

  5. (Optional) The dataset description is populated by the Kendra index selected in Step 3. Edit the description if needed.

  6. In the Permissions section, choose from below:

    1. Choose Create and use a new service role. By default, Amazon IoT SiteWise automatically creates a service role. This role allows the Amazon IoT SiteWise Assistant to access your Kendra indexes.

    2. Choose Use an existing service role, and then choose the target role.

  7. Choose Create.

Creating a dataset final picture in the Assistant page of the console

The service role created by Amazon IoT SiteWise for the user, if the user chose to Create and use a new service role.

Creating a dataset final picture in the Assistant page of the console
Amazon CLI
Create a dataset in Amazon CLI

  1. Create an IAM role used to create a dataset. Use the following permissions policy:

    JSON
    JSON
    
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "kendra:Retrieve"
            ],
            "Resource": "arn:aws-cn:kendra:*:*:index/*"
        }
    ]
}

    Use the following trust relationship:

    JSON
    JSON
    
{
    "Version":"2012-10-17",		 	 	 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "iotsitewise.amazonaws.com"
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

  2. Create a file create-dataset.json with the template provided in the example. Populate datasetId, kendra knowledgeBaseArn and roleArn to connect with this dataset. 

    
{
    "datasetId": "<UUID>",
    "datasetName": "DatasetForAssistant",
    "datasetSource": {
       "sourceType": "KENDRA",
       "sourceFormat": "KNOWLEDGE_BASE",
       "sourceDetail": {
          "kendra": {
            "knowledgeBaseArn": "arn:aws:kendra::%s:index/index",
            "roleArn": "arn:aws:iam::%s:role/role"
          }
       }
    }
}

  3. Create the dataset with the following command: 

    aws iotsitewise create-dataset --cli-input-json file://create-dataset.json —-region us-east-1