站点类型和垂直预设

互客鱼智能体适应它们所在的站点类型。 当您设置智能体时，系统可以自动检测您是否正在运行电子商务商店、文档站点、SaaS 产品、帮助中心、营销站点或内部知识库 — 并加载针对该上下文调整的垂直预设。

预设改变什么

每个预设捆绑四种默认值：

• System prompt fragment — 系统提示词片段，附加到每次轮次的 LLM 系统提示词。位于检索数据之后和之前您编写的任何自定义系统提示词，因此您的自定义指令始终获胜。
• Starter prompts — 起始提示词，访客首次打开时看到的芯片。为新智能体填充；如果您已经策划了自己的列表，则保持不变。
• Launcher label — 启动器标签，小部件关闭 orb 上的行动号召（例如“浏览我们的商店”、“搜索文档”）。
• Capabilities — 功能，小部件在 init 时读取的丰富 UI 功能列表。Phase 3 渲染器今天为产品卡片、定价卡片、案例研究卡片和升级按钮发货（参见 resources/widget/src/ui/blocks.tsx）；更多渲染器（代码块、FAQ 手风琴等）随着能力列表的增长而跟进。

七个垂直领域

Slug	适用于...	功能（此版本锁定）
ecommerce	销售产品。定价、库存、退货、运输。	product_card, price_inline, shipping_estimate, cart_handoff, order_status
documentation	发布技术文档、API 参考、SDK 指南。	code_block, api_reference_card, version_picker, troubleshoot_steps
saas	销售具有定价、功能和注册的软件。	pricing_card, signup_handoff, feature_compare, account_status
help_center	运行具有文章和工单流程的公共支持/常见问题表面。	ticket_escalation, kb_article_card, sentiment_routing
marketing	捕获潜在客户、运行案例研究、进行漏斗顶部内容。	lead_capture_inline, demo_booking, case_study_card
internal_kb	服务员工 wiki、运行手册或合规文档。	policy_lookup, team_handoff, auth_aware
generic	以上都不是，或者您将自行配置所有内容。	无

自动检测

在入职期间（粘贴您的网站 URL 后），互客鱼会获取主页，对一堆结构化信号进行评分，并选择得分最高的垂直领域。 它权衡的信号：

• og:type meta 标签（例如 product, website, article）
• JSON-LD @type 值（Schema.org 实体如 Product, SoftwareApplication, FAQPage, TechArticle）
• generator meta（Shopify、WooCommerce、Docusaurus、Mintlify、Zendesk、WordPress…）
• URL 路径模式（/products, /docs, /help, /api）
• 主机名信号（SaaS 的 app. / dashboard. 子域；KB 的 .local / .internal）
• <article> 标签和 <pre><code> 块的存在

每个信号都有一个权重；总和最高的垂直领域获胜。 如果没有垂直领域清除 0.25 的置信度下限，检测器将回退到 generic 并要求您手动选择。

自动检测是尽力而为的。 发送空 SSR HTML 的重 JS SPA，或 auth-walled 主机，回退到 generic — 您始终可以从单选卡片中手动选择垂直领域。

稍后更改垂直领域

从智能体的导航磁贴打开 /app/agents/{id}/vertical。您可以：

• 重新检测如果您的站点已更改（例如，您向以前仅内容的站点添加了 Shopify 店面）。
• 选择不同的垂直领域通过单选网格。如果您的自定义将被覆盖，确认对话框会准确解释什么会被替换。

系统提示词片段是运行时应用的 — 它不烘焙到智能体记录中，因此更改垂直领域会立即更改提示词而没有陈旧文本。 功能也是运行时的：小部件在每次 /init 调用时接收实时列表。 启动器提示词和标签在应用时合并到智能体记录中，因此您可以在 Customize 中编辑它们而不会在下次重新应用相同的垂直领域时丢失您的工作。

覆盖功能

每个智能体都有一个可选的 vertical_overrides JSON 列。 设置 vertical_overrides.capabilities = [...] 以用您自己的替换预设的功能列表。 小部件读取覆盖；LLM 仍然看到预设的系统片段，因此您的覆盖不会意外削弱提示词合同。

多租户和安全

两个端点（POST /app/agents/{agent}/vertical/detect 和 POST /app/agents/{agent}/vertical/apply）都由 AgentPolicy::update 限制 — 只有智能体工作区的成员才能调用它们。 跨工作区访问返回 403。 vertical_signals 缓存智能体行上的最新检测，因此管理员 UI 可以显示“自动检测于 …”而无需重新获取。

下一步

Phase 1 发布数据模型、检测、预设、管理员 UX，并向小部件公开 capabilities。 Phase 2（工具/函数调用）部分发布 — app/Services/Tools/ToolRegistry.php 中的 ToolRegistry 已连接， 第一个工具（EscalateToHumanTool）发布并限制到 ticket_escalation 功能。 特定垂直领域的工具（电子商务的 product_lookup 等）随着集成的落地而跟进。 Phase 3（小部件中的丰富消息渲染器）部分发布 — resources/widget/src/ui/blocks.tsx 渲染 LLM 通过内联 XML 标记发出的产品、定价、案例研究和升级块； 随着我们扩展功能列表，额外的渲染器将跟进。