[BUG] Bedrock file constraints swap the image and document size limits

问题场景

在 CrewAI 中使用 Bedrock 作为文件处理目标，通过 FileProcessor("bedrock") 或 format_multimodal_content(files, "bedrock") 处理并发送图片、PDF。Issue 复现脚本对约 4 MB 的 PNG 走 AUTO 模式、对约 4 MB 的 PDF 走 STRICT 模式，分别触发“图片超限被发送”和“PDF 被误拒”两种相反的表现。

报错原文

image bytes before/after: 4043732 4043732
crewai_files.processing.exceptions.FileTooLargeError: PDF 'report.pdf' size (3.8MB) exceeds maximum (3.7MB)

main 实测：
Bedrock ValidationException: The model returned the following errors: messages.0.content.0.image.source.bytes: image exceeds 5 MB maximum: 5391616 bytes > 5242880 bytes
crewAI FileTooLargeError: PDF 'report.pdf' size (4.0MB) exceeds maximum (3.7MB)

原因分析

最可能的原因是 crewai_files/processing/constraints.py 中的 BEDROCK_CONSTRAINTS 把两项上限写反：图片为 4,608,000 字节（4.5 MB），PDF 为 3,840,000 字节（3.75 MB），而 Bedrock Converse API 文档给出的是图片不超过 3.75 MB、文档不超过 4.5 MB。由此产生两个后果：AUTO 模式下 3.75 MB 至 4.5 MB 的图片通过 CrewAI 校验、不被优化，原样送达 Bedrock 后超限；STRICT 模式下同区间的 PDF 被 CrewAI 误判为超限而提前拒绝。文档中的提供方表格存在同样的颠倒。

环境排查

• 确认 crewAI / crewai-files 版本是否为含该缺陷的版本（Issue 中为 main b0c16c1、crewai-files 1.15.28）。
• 确认文件处理目标为 Bedrock，并确认实际调用的 Bedrock 模型（Claude 与 Nova 的限制不同）。
• 确认待发送图片与 PDF 的原始字节数，尤其是是否落在 3.75 MB 至 4.5 MB 之间。
• 确认文件处理模式为 AUTO 还是 STRICT，两者失败表现不同。
• 确认 Python 版本与 crewai-files 的对应关系（Issue 为 Python 3.13），以及是否使用第三方修改过的 constraints 文件。

解决步骤

1. 检查 crewai_files/processing/constraints.py，确认 BEDROCK_CONSTRAINTS 中图片上限当前为 4,608,000、PDF 上限为 3,840,000。
2. 可优先尝试：将图片上限改为 3_840_000、PDF 上限改为 4_608_000；该改动在维护者的 live Converse API 校验中表现为：4,043,710 字节 PNG 被优化到约 962,570 字节并返回 end_turn，4,200,000 字节 PDF 原样发送并返回 end_turn。
3. 同步修正 docs/edge/*/concepts/files.mdx 中对应提供方的表格行，避免文档与代码继续不一致。
4. 若已在本地改动，跟踪并切换到合并后的修复版本（PR #8159），不要在升级后保留手改文件。

验证方法

用 Issue 的复现思路重新执行：构造约 4 MB 的 PNG，走 AUTO 模式后对比处理前后字节数，应看到体积明显下降且请求返回 end_turn，而非 ValidationException；构造约 4.2 MB 的 PDF，STRICT 模式下应被原样发送并返回 end_turn，不再抛出 FileTooLargeError。也可直接检查 BEDROCK_CONSTRAINTS 的取值是否已为图片 3,840,000、PDF 4,608,000。

参考来源

crewAIInc/crewAI #8158

AI 工具推荐

想把多个 AI 模型放在一个入口？

GamsGo AI 集成 ChatGPT、DeepSeek、Gemini、Claude、Midjourney、Veo 等常用模型，适合写作、绘图、视频和日常 AI 工作流。

了解 GamsGo AI

推广链接：通过此链接购买，我可能获得佣金，不影响你的价格。