本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 飞轮迭代
使用飞轮迭代帮助您创建和管理新的模型版本。
**Topics**
+ [迭代工作流程](#flywheels-iterate-flow)
+ [管理迭代（控制台）](#flywheels-iterate-console)
+ [管理迭代 (API)](#flywheels-iterate-api)
## 迭代工作流程
飞轮从经过训练的模型版本开始，或者使用初始数据集来训练模型版本。
随着时间的推移，当您获得新的标记数据时，您可以训练新的模型版本以提高飞轮模型的性能。当您运行飞轮时，它会创建一个新的迭代，用于训练和评估新的模型版本。如果新模型版本的性能优于现有的活动模型版本，则可以对其进行升级。
飞轮迭代工作流程包括以下步骤：
1. 您可以为新标记的数据创建数据集。
1. 您可以运行飞轮来创建新的迭代。迭代遵循以下步骤来训练和评估新的模型版本：
1. 使用新数据评估活动模型版本。
1. 使用新数据训练新的模型版本。
1. 将评估和训练结果存储在数据湖中。
1. 返回两个模型的 F1 分数。
1. 迭代完成后，您可以比较现有活动模型和新模型的 F1 分数。
1. 如果新模型版本具有卓越的性能，则将其提升为活动模型版本。您可以使用[控制台](#flywheels-iterate-console-promote)或 [API](#flywheels-iterate-console-promote) 来提升新的模型版本。
## 管理迭代（控制台）
您可以使用控制台开始新的迭代并查询正在进行的迭代的状态。您还可以查看已完成迭代的结果。
### 开始飞轮迭代（控制台）
在开始新的迭代之前，请创建一个或多个新的训练或测试数据集。请参阅 [配置数据集](datasets-config.md)。
**开始飞轮迭代（控制台）**
1. 登录 AWS 管理控制台 并打开[亚马逊 Comprehend 控制台](https://console.aws.amazon.com/comprehend/)。
1. 从左侧菜单中，选择**飞轮**。
1. 从**飞轮**列表中，选择一个飞轮。
1. 选择**运行飞轮**。
### 分析迭代结果（控制台）
运行飞轮迭代后，控制台将结果显示在**飞轮迭代**列表中。
### 提升新模型版本（控制台）
在控制台的模型详细信息页面上，您可以将新的模型版本升级为活动模型版本。
**将飞轮模型版本升级为活动模型版本（控制台）**
1. 登录 AWS 管理控制台 并打开[亚马逊 Comprehend 控制台](https://console.aws.amazon.com/comprehend/)。
1. 从左侧菜单中，选择**飞轮**。
1. 从**飞轮**列表中，选择一个飞轮。
1. 从**飞轮详细信息页面**列表中，从**飞轮迭代**列表中选择要升级的版本。
1. 选择**激活模型**。
## 管理迭代 (API)
您可以使用 Amazon Comprehend API 开始新的迭代并查询正在进行的迭代的状态。您还可以查看已完成迭代的结果。
### 开始飞轮迭代 (API)
使用 Amazon Compreh [StartFlywheelIteration](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_StartFlywheelIteration.html)end 操作开始飞轮迭代。
```
aws comprehend start-flywheel-iteration \
--flywheel-arn "flywheelArn"
```
响应包含以下内容。
```
{
"FlywheelIterationArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/name"
}
```
### 提升新模型版本 (API)
使用[UpdateFlywheel](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_UpdateFlywheel.html)操作将模型版本提升为活动模型版本。
发送 `UpdateFlywheel` 请求时，将 `ActiveModelArn` 参数设置为新活动模型版本的 ARN。
```
aws comprehend update-flywheel \
--active-model-arn "modelArn" \
```
响应包含以下内容。
```
{
"FlywheelArn": "arn:aws::comprehend:aws-region:111122223333:flywheel/name",
"ActiveModelArn": "modelArn"
}
```
### 描述飞轮迭代结果 (API)
在迭代运行到完成之后，[DescribeFlywheelIteration](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_DescribeFlywheelIteration.html)Amazon Comprehend 操作会返回有关迭代的信息。
```
aws comprehend describe-flywheel-iteration \
--flywheel-arn "flywheelArn" \
--flywheel-iteration-id "flywheelIterationId" \
--region aws-region
```
响应包含以下内容。
```
{
"FlywheelIterationProperties": {
"FlywheelArn": "flywheelArn",
"FlywheelIterationId": "iterationId",
"CreationTime": ,
"EndTime": ,
"Status": ,
"Message": ,
"EvaluatedModelArn": "modelArn",
"EvaluatedModelMetrics": {
"AverageF1Score": ,
"AveragePrecision": ,
"AverageRecall": ,
"AverageAccuracy":
},
"TrainedModelArn": "modelArn",
"TrainedModelMetrics": {
"AverageF1Score": ,
"AveragePrecision": ,
"AverageRecall": ,
"AverageAccuracy":
}
}
}
```
### 获取迭代历史记录 (API)
使用[ListFlywheelIterationHistory](https://docs.aws.amazon.com/comprehend/latest/APIReference/API_ListFlywheelIterationHistory.html)操作获取有关迭代历史的信息。
```
aws comprehend list-flywheel-iteration-history \
--flywheel-arn "flywheelArn"
```
响应包含以下内容。
```
{
"FlywheelIterationPropertiesList": [
{
"FlywheelArn": "",
"FlywheelIterationId": "20220907T214613Z",
"CreationTime": 1662587173.224,
"EndTime": 1662592043.02,
"Status": "",
"Message": "",
"EvaluatedModelArn": "modelArn",
"EvaluatedModelMetrics": {
"AverageF1Score": 0.8333333333333333,
"AveragePrecision": 0.75,
"AverageRecall": 0.9375,
"AverageAccuracy": 0.8125
},
"TrainedModelArn": "modelArn",
"TrainedModelMetrics": {
"AverageF1Score": 0.865497076023392,
"AveragePrecision": 0.7636363636363637,
"AverageRecall": 1.0,
"AverageAccuracy": 0.84375
}
}
]
}
```