Skip to content

Commit 49d1ae1

Browse files
committed
Adding documentation on risks of Private workforce and private work team
1 parent 9cbaed4 commit 49d1ae1

File tree

1 file changed

+12
-0
lines changed

1 file changed

+12
-0
lines changed

docs/human-review.md

Lines changed: 12 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -154,7 +154,19 @@ Monitor HITL performance through:
154154

155155
- **Template Updates**: Updating SageMaker A2I Template and workflow performs deletion on A2I flow definition and custom template, then recreates resources via Lambda function. Direct updates to A2I resources through Python SDK are not supported.
156156

157+
- **Private Workforce Cognito Limitation**: AWS SageMaker Ground Truth allows only **one private workforce per Cognito User Pool** per AWS account. This creates a critical dependency when deploying multiple GenAI-IDP stacks with HITL enabled:
158+
- Each private workforce must be mapped to a unique Cognito client
159+
- Multiple stacks cannot create separate private workforces if they use the same Cognito User Pool
160+
- **Risk**: If the first stack (that created the private workforce) is deleted, it will break the private workteam for all other stacks using the same workforce
161+
- **Recommendation**: Always reuse existing private workteam ARNs when deploying additional patterns or stacks with HITL enabled
162+
- Use the `ExistingPrivateWorkforceArn` parameter to reference the workforce created by your first HITL-enabled deployment
163+
157164
### Workarounds
158165

159166
- **Task Management**: Reviewers should process tasks in chronological order or use task identifiers to track specific documents
160167
- **Configuration Changes**: Plan A2I template updates during maintenance windows to minimize disruption
168+
- **Multi-Stack HITL Deployment**:
169+
1. Deploy your first HITL-enabled stack and note the `PrivateWorkteamArn` from CloudFormation outputs
170+
2. For subsequent stacks, provide this ARN in the `ExistingPrivateWorkforceArn` parameter
171+
3. Never delete the original stack that created the private workforce without first migrating the workforce to another stack
172+
4. Consider creating a dedicated "HITL infrastructure" stack to manage the private workforce independently

0 commit comments

Comments
 (0)