面向 AI Agent 的 SEC 文件需要明确的检索契约
Agent 可以在没有 EDGAR API key 的情况下获取公开文件，但“公开”不代表可以无限请求。SEC 要求自动化客户端通过 User-Agent 声明身份，目前聚合请求速率不得超过每秒 10 次。系统还应缓存响应、大批量任务使用 bulk 文件，并保留来源 URL。
按任务选择正确的 EDGAR 数据入口
可靠的架构不会把 EDGAR 当成单一接口，而会根据 Agent 需要发现文件、读取原文、提取结构化事实还是进行大规模采集来选择数据源。
还要分开记录三种时间：文件描述的财务期间、索引中的 filing date，以及 EDGAR 的 accepted timestamp。正常情况下文件可能在时间戳后数分钟出现，但这并不是有保证的实时数据流。历史分析还应保存本系统首次获取记录的时间，避免后续回测或 Agent 评估错误假设证据更早可用。
Submissions API
用 CIK 发现近期表单、accession number、申报日期和主文档；排序前先保存返回的元数据。
EDGAR Archives
读取已申报 HTML、附件与文件目录。叙述性披露、附注和风险语言都在这里，不能只靠数值事实替代。
Companyfacts / Frames
利用 XBRL facts 获取规范化数值、单位、期间、表单与 filed 时间；比较前验证 taxonomy、context 和修订。
Bulk ZIP files
大规模采集应使用 SEC 每晚更新的 submissions 与 companyfacts 压缩包，而不是反复抓取单公司接口。
构建七阶段 SEC 文件 RAG 管道
解析发行人
把名称或 ticker 映射到 CIK，并核验法定名称和交易所。ticker 会变化，CIK 才是稳定的 EDGAR 身份。
定义文件范围
明确表单类型、申报日期区间、报告期、修订与附件，不要默认混合年度、季度和事件披露。
合规获取
声明组织 User-Agent，全局限速，退避重试，缓存不可变文件并记录请求状态。
保留原始证据
解析前保存 accession number、来源 URL、主 HTML、相关附件、获取时间和内容哈希。
按章节解析
按 10-K/10-Q Item、表格、附注与附件分块，并让每个 chunk 保留标题、锚点和页面上下文。
带元数据检索
语义排序前先按 CIK、表单、filed 时间、期间和修订状态过滤，并取回相邻 chunk 补充上下文。
回答并验证
强制章节级引用，区分原文事实与推断，暴露冲突，并将高影响结论交由人工复核。
让 Agent 理解每类文件能证明什么、不能证明什么
让每个回答都能追溯到具体文件章节
最小证据记录
issuer_cik · legal_name · form · accession_number
filed_at · accepted_at · report_period · amendment
document_url · section · anchor · excerpt_hash
区分事实、计算与推断
文件可以披露收入；利润率是计算结果；“定价权增强”则是推断。应标记每一层、展示公式，并引用使用的准确原文或 XBRL fact。
综合前先解决冲突
优先选择正确发行人、期间与适用的最新修订，同时保留冲突证据。后续文件可以更新早期披露，但不能抹去早期时点已知内容。
将文件正文和附件视为不可信输入
SEC 托管内容作为申报记录具有权威性，但它仍然是申报方提供的外部内容。AI Agent 不能因为文字出现在 EDGAR 中，就执行文档内嵌指令、泄露密钥、改变工具权限或自动访问链接。
沙箱解析
禁用活动内容、脚本与任意文件执行；规范化 HTML 同时保留证据锚点。
限制工具权限
检索工具应只读、限制域名，并且无法访问无关凭证或系统。
验证输出
发布前逐一核验引用、数字、单位、期间和发行人是否与已存证据一致。
高影响升级
法律、合规与投资结论需要合格人员复核；表达流畅不代表信息完整。
使用 QVeris 治理 SEC 与金融数据工具
授权发现
QVeris 可帮助 Agent 选择已批准的 SEC、FMP 与研究工具，避免编造接口或静默混用数据提供商。
受控执行
策略可以约束域名、方法、日期、配额和凭证，并记录每个产物由哪个工具生成。
来源交接
工作流可把文件元数据与证据链接交给模型和审核者。QVeris 不保证完整性，也不提供法律或投资建议。
继续阅读 QVeris 指南：金融 RAG、财务报表分析以及13F 文件包含哪些信息。
面向 AI Agent 的 SEC 文件常见问题
AI Agent 可以访问 SEC 文件吗？
可以。Agent 可使用公开 EDGAR API 与档案，但需要遵守 SEC 公平访问规范、声明 User-Agent、限速并合理缓存。
EDGAR API 免费吗，需要 API key 吗？
公开 data.sec.gov API 不需要认证或 API key，但仍须遵守速率、身份声明与使用规则。
AI Agent 应使用哪些 SEC 文件？
按问题选择：10-K 看年度全貌，10-Q 看中期变化，8-K 看重大事件，13F 看有限范围的机构持仓，并纳入适用的修订与附件。
Agent 应如何引用 SEC 文件？
引用应包含发行人、表单、申报日期、accession number、文档 URL 与准确章节或锚点，并保存支持性摘录、区分推断与申报事实。
如何减少幻觉与提示注入风险？
检索有限证据、强制引用、核验数字与元数据，把文档指令当作数据，限制工具权限，并将高影响输出交给人工审核。
QVeris 能保证 SEC 研究完整吗？
不能。QVeris 可治理授权工具与来源，但完整性、解释、法律合规和投资判断仍由研究流程与审核人员负责。