如何将产品暴露给 AI 代理？

目录准备好且可语义检索后，下一步是分发：以符合代理型生态运作方式，让 AI 代理能访问您的产品。实践中有两种互补策略：发布可供代理型平台抓取的 Feed；以及提供可供代理实时查询的 API。ventic.ai 同时支持这两种方式。

发布符合 ACP 的公开 Feed（用于发现与代理型商务）

针对代理型商务协议 (ACP) 风格的发现，ventic.ai 可通过公开端点以符合 ACP 的格式发布您的产品 Feed，例如：https://api.ventic.ai/v1/projects/{projectId}/commerce/feed.json。关键点在于公开 Feed 无需 API 密钥，这与代理型商务对产品 Feed 的预期一致：Feed 有意公开、供外部系统轮询与缓存，并支持通过 ETag 与 Cache-Control 的 HTTP 缓存。

会暴露什么、不会暴露什么：Feed 仅包含符合发布条件的商品：仅 enable_search: true 的条目会显示，仅状态为 ACP_READY 的产品会被包含，不会暴露 API 密钥或财务等敏感商户数据。在平台上，公开 Feed 的启用与控制位于 项目设置 → API 密钥，有公开 Feed 可用性开关与可复制的 URL。

何时发布该 Feed：当您希望实现类似 ChatGPT 的发现、与 Stripe ACP 流程及“即时结账”体验兼容、或希望任何支持 ACP 抓取的代理都能读取您的目录时，适合使用此方式。简言之，公开 Feed 是您进入“抓取+索引”型生态的分发渠道。

通过 API 暴露产品供代理实时查询

并非所有场景都适合 Feed。很多代理型用例需要实时回答，如“显示 200 美元以内有货的商品”“送咖啡爱好者的最佳选项是什么”“哪些型号有 16GB 内存”。这时 API 方式更合适。ventic.ai 提供支持商务管理、语义产品搜索、知识搜索与 Agent 对话访问的公共 API 网关。在此模式下，代理无需下载完整 Feed，可基于语义搜索按需查询产品，可通过 RAG 访问知识库（政策、手册、FAQ）。认证方式：在 项目设置 → API 密钥 中生成 API 密钥，并在每次请求的 x-api-key 头中传递。

在自有数据上构建代理体验

ventic.ai 的一大优势是不仅是发布工具，也是代理后端。平台暴露：带相似度评分与过滤的 Search API（产品与知识）；以及可选择提供方（Ventic、ChatGPT、Claude、Gemini、Perplexity）并管理会话的 Agent 模块。因此您可以构建：站内或应用内的购物助手、基于您政策与手册的支持助手、与客户看到同一目录的内部销售助手。

如何选择暴露方式

当您希望通过“抓取目录”的平台获得广泛发现时，使用 ACP 公开 Feed；当您需要受控、实时、基于查询的交互且不想分发完整目录时，使用 基于 API 的访问；当您希望覆盖最广且实时体验最佳时，两者兼用。