Amazon Q in ConnectのAIエージェントのバージョン数は25件が上限です
2025.06.12はじめに
Amazon Q in ConnectのAIエージェントには、バージョン数25件という上限が存在します。
この制限はAWSドキュメントのサービスクオータには記載されていませんが、私が複数環境で実際に遭遇した制限です。25件を超えるバージョンは作成できず、上限緩和も対応不可となっています。
また、マネジメントコンソールとAWS CLIでは挙動が異なるため、それぞれの違いについて解説します。
マネジメントコンソール
25件のバージョンが存在するAIエージェントで、[エージェントビルダーで編集]をクリックします。
[保存]と[公開]を実行します。
結果として、バージョン数は25件のまま変わらず、新しいバージョンは作成されませんでした。ただし、エラーメッセージは表示されません。
CLI
AWS CloudShellからAIエージェントのバージョンを作成しようとすると、エラーメッセージが表示されました。AIエージェントバージョンのクォータを超過したという内容です。
$ aws qconnect create-ai-agent-version \
--assistant-id アシスタントID \
--ai-agent-id AIエージェントID
An error occurred (ServiceQuotaExceededException) when calling the CreateAIAgentVersion operation: AIAgentVersion quota exceeded
25件が仕様上の上限と考えられますが、マネジメントコンソールではエラーメッセージが表示されない点は不具合の可能性があります。
対処法
25件のバージョンが存在する場合、新しいバージョンを作成するには、既存のバージョンを削除する必要があります。
マネジメントコンソールでの削除
ラジオボタンで削除対象のバージョンを1つ選択し、削除を実行します。
削除時は確認ダイアログが表示されず、即座に削除されます。
CLIでの削除
CLIの場合は、以下のコマンドを1つずつ実行することで削除できます。
# 例：バージョン1と2を削除する場合
aws qconnect delete-ai-agent-version --assistant-id <id> --ai-agent-id <id> --version-number 1
aws qconnect delete-ai-agent-version --assistant-id <id> --ai-agent-id <id> --version-number 2
複数バージョンを一括削除する場合は、以下のようなスクリプトを使用できます。
ASSISTANT_ID="your-assistant-id"
AI_AGENT_ID="your-ai-agent-id"
VERSIONS=(3 4 5 6 7 8 9 10 11 12 13) # 削除したいバージョン番号
for version in "${VERSIONS[@]}"; do
echo "Deleting version $version..."
aws qconnect delete-ai-agent-version \
--assistant-id "$ASSISTANT_ID" \
--ai-agent-id "$AI_AGENT_ID" \
--version-number "$version"
if [ $? -eq 0 ]; then
echo "✓ Version $version deleted successfully"
else
echo "✗ Failed to delete version $version"
fi
done
実行結果
Deleting version 3...
✓ Version 3 deleted successfully
Deleting version 4...
✓ Version 4 deleted successfully
Deleting version 5...
✓ Version 5 deleted successfully
Deleting version 6...
✓ Version 6 deleted successfully
Deleting version 7...
✓ Version 7 deleted successfully
Deleting version 8...
✓ Version 8 deleted successfully
Deleting version 9...
✓ Version 9 deleted successfully
Deleting version 10...
✓ Version 10 deleted successfully
Deleting version 11...
✓ Version 11 deleted successfully
Deleting version 12...
✓ Version 12 deleted successfully
Deleting version 13...
✓ Version 13 deleted successfully
最後に
Amazon Q in ConnectのAIエージェントバージョン数の25件制限は、現在AWSドキュメントに記載されていない制限です。
今後、以下の点について注視しましょう。
- バージョン数制限の緩和や変更
- マネジメントコンソールでのエラーメッセージ表示の改善
- サービスクオータドキュメントへの記載
