Amazon Q in ConnectのAIエージェントのバージョン数は25件が上限です

2025.06.12
 はじめにAmazon Q in ConnectのAIエージェントには、バージョン数25件という上限が存在します。
この制限はAWSドキュメントのサービスクオータには記載されていませんが、私が複数環境で実際に遭遇した制限です。25件を超えるバージョンは作成できず、上限緩和も対応不可となっています。
また、マネジメントコンソールとAWS CLIでは挙動が異なるため、それぞれの違いについて解説します。
 マネジメントコンソール25件のバージョンが存在するAIエージェントで、[エージェントビルダーで編集]をクリックします。
[保存]と[公開]を実行します。
結果として、バージョン数は25件のまま変わらず、新しいバージョンは作成されませんでした。ただし、エラーメッセージは表示されません。
 CLIAWS 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
https://awscli.amazonaws.com/v2/documentation/api/latest/reference/qconnect/create-ai-agent-version.html
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
https://awscli.amazonaws.com/v2/documentation/api/latest/reference/qconnect/delete-ai-agent-version.html
複数バージョンを一括削除する場合は、以下のようなスクリプトを使用できます。
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ドキュメントに記載されていない制限です。
今後、以下の点について注視しましょう。
バージョン数制限の緩和や変更
マネジメントコンソールでのエラーメッセージ表示の改善
サービスクオータドキュメントへの記載